腾讯云多人音视频房间SDK用户进房回调_音视频解决方案_同尘科技
功能说明
您的 App 后台可以通过该回调实时查看用户进房的信息,包括: App 后台用户进房成功通知时,可以据此进行数据同步等操作。
注意事项
要启用回调,必须配置回调 URL,并打开本条命令字的开关,请参考 回调命令字的创建。回调的方向是即时通信 IM 后台向 App 后台发起 HTTP POST 请求。App 后台在收到回调请求之后,务必校验请求 URL 中的参数 SDKAppID 是否是自己的 SDKAppID。
可能触发该回调的场景
App 用户通过客户端用户进房成功。
回调的发生时机
用户进房成功之后。
接口说明
请求URL
以下示例中 App 配置的回调 URL 为 https://www.example.com
。
示例:
$http://www.example.com?sdkappid=$sdkappid&command=$command&contenttype=json&clientip=$clientip&optplatform=$optplatform
请求参数说明
参数 | 说明 |
http | 请求协议为 HTTPS 或 HTTP,请求方式为 POST |
www.example.com | 回调 URL |
sdkappid | 创建应用时在即时通信 IM 控制台分配的 SDKAppID |
command | 固定为 enterRoom |
contenttype | 固定值为 json |
clientip | 客户端 IP,格式如:127.0.0.1, 如果是 RestApi 调用地址为0.0.0.0 |
optplatform | 客户端平台,可能是 Android、iOS、Windows、MacOS、Unknown,若 RestApi 发送的请求,optplatform 为rest_api |
具体的回调内容在 HTTP 请求包体中,参见下文回调示例。
回调示例
回调请求示例:
POST /?sdkappid=8888888&command=enterRoom&contenttype=json&clientip=127.0.0.1&optplatform=iOS HTTP/1.1Host: www.example.comContent-Length: 337{ "RoomInfo": { "RoomName": "Alice's Room", "RoomType": 0, "SpeechMode": 0, "VideoDisable": false, "AudioDisable": false, "MessageDisable": false, "MaxSeatCount": 30 }, "MemberCount": 15, // 当前房间成员数量 "UserId": "Alice", "RoomId": "Alice's Room", "EventTime": 1682415761579 //毫秒级别,事件触发时间戳 }
请求包字段说明
字段 | 类型 | 说明 |
UserId | String | 操作的用户 ID |
RoomId | String | 操作的房间 ID |
RoomType | Integer | 请参见:房间类型 |
RoomName | String | 房间名 |
SpeechMode | Integer | 请参见:发言模式 |
VideoDisable | Bool | 视频开关 |
AudioDisable | Bool | 音频开关 |
MessageDisable | Bool | 文本信息开关 |
MaxSeatCount | Integer | 最大麦位数量 |
MemberCount | Integer | 当前房间成员数量 |
回调应答示例:
App 后台同步数据后,发送回调应答包。
{ "ErrorCode": 0, // 0 为成功,其余为失败 "ErrorMessage": "Success", // 失败原因}
对音视频的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?