( 最近更新时间:2020-04-28 19:00:00 )

    最新版本API为 Version 1.1

    # RTC 房间状态同步

    本功能用于在音视频通话过程中,向 App 服务端同步房间的各种状态信息。

    包括:音视频通话过程中的房间创建、销毁、用户加入房间、用户退出房间、发布音视频资源。

    # 开通方式

    在开发者后台 音视频服务开通处 ,配置 APP Server 接收 回调的URL 地址 ,默认配置的是 接收 Version 1.1 数据结构的通知 。

    融云会将房间内所有信息都同步给这个地址,开通 30 分钟后生效。

    接收状态地址示例:http(s): //example.com/state_receive.php

    请求方法: POST

    Content-Type: application/json

    Request:

    # 表单参数
    名称 类型 说明
    appKey string 应用 AppKey,在开发者后台创建应用后获取
    roomId string 房间 Id
    event number 事件类型:
    1: 房间信息同步(定期);
    2: 房间创建;
    3: 房间销毁;
    11: 成员加入;
    12: 成员退出;
    20: 资源发生变动(发布资源或者取消发布资源)
    userId string 当前事件的用户 Id
    timestamp number 当前事件发生的 Unix 时间戳
    durationTime number 当 event 为成员退出时,此时间为该用户单次房间进出累计时长,当 event 为房间销毁时,此时间为房间总时长,单位为毫秒
    members list 用户资源信息
    只有在房间信息同步时,members 里的用户资源信息列表才是全量的;
    其他事件都只包含对应事件中增量的用户资源信息,如 user1 资源发布,那 members 里的信息只有 user1 的资源信息。
    members.{id}.userId string 用户 ID
    members.{id}.data dict 用户发布的资源信息
    members.{id}.data.uris string 用户资源信息集合,详情见下面说明。
    # uris 说明

    uris 为当前用户发布的资源信息集合,反序列化后的字段说明如下:

    参数名称 类型 说明
    tag String 用户发布资源时指定的标签信息,用于表示每一组流
    msid string 发布的资源唯一 ID
    mediaType number 资源的类型
    0: 音频;
    1: 视频
    state number 资源的状态
    0: 关闭;
    1: 开启
    uri string 资源全网唯一的资源 URI
    # 示例
    {
        "appKey": "appKey",
        "roomId": "roomId",
        "userId": "123",
        "event": 20,
        "timestamp": 1586244141831,
        "members": [
            {
                "userId": "123",
                "joinTime": 1586244140932,
                "data": {
    
                    "uris":[
                          {
                              "mediaType":0,
                              "msid":"13811223344_h0fc_web_RongCloudRTC",
                              "uri":"{\"clusterId\":\"rtc-data-dev-rtc40-15-bdcbj.rongcloud.net\",\"serverId\":\"172.24.151.15:9005\",\"resourceId\":\"13811223344_h0fc_web_RongCloudRTC_0\",\"connectionId\":\"AAY2NjM0NjMAFDEzODExMjIzMzQ0X2gwZmNfd2ViAAM0NDQA\",\"ssrc\":2750434140,\"serviceProvider\":\"awsnx\",\"userTimestamp\":1585043802893}",
                              "tag":"RongCloudRTC",
                              "state":1
                          },
                          {
                              "mediaType":1,
                              "msid":"13811223344_h0fc_web_RongCloudRTC",
                              "uri":"{\"clusterId\":\"rtc-data-dev-rtc40-15-bdcbj.rongcloud.net\",\"serverId\":\"172.24.151.15:9005\",\"resourceId\":\"13811223344_h0fc_web_RongCloudRTC_1\",\"connectionId\":\"AAY2NjM0NjMAFDEzODExMjIzMzQ0X2gwZmNfd2ViAAM0NDQA\",\"ssrc\":1782111418,\"serviceProvider\":\"awsnx\",\"userTimestamp\":1585043802893}",
                              "tag":"RongCloudRTC",
                              "state":1
                          }
                        ]
                }
            }
        ]
    }
    
    已复制
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32

    文档是否解决您的问题 ?

    如果遇到产品相关问题,您可 提交工单 寻求帮助