跳到主要内容

绑定音视频房间

当聊天室与音视频（RTC）房间绑定成功后，当聊天室达到预设的自动销毁条件时，服务端会先检测已绑定的音视频房间（RTCRoomId）是否仍存在：

  • 如果已绑定的音视频房间仍存在，则阻止聊天室自动销毁。
  • 如果已绑定的音视频房间已销毁，则正常销毁聊天室。

该接口仅创建从聊天室到音视频房间的单向绑定关系。因此，音视频房间的主动或自动销毁，并不会触发聊天室的销毁。关于音视频房间的销毁机制，详见音视频房间销毁机制。

适用场景​

聊天室具有自动销毁机制。如果您的 App 在使用 RTC 业务时，也使用了聊天室来实现直播聊天、弹幕、属性记录等功能，建议您调用此接口将聊天室与音视频房间绑定，以确保聊天室不会在直播或语聊结束前意外销毁。

如果您仅单独使用聊天室业务，则无需调用该接口。

聊天室的自动销毁机制

默认情况下，所有聊天室会在不活跃（连续时间段内无成员进出且无新消息）达到 1 小时后自动销毁。您可以修改默认的销毁机制，例如延长不活跃销毁时间，或配置为定时销毁。详见聊天室销毁机制。

请求方法​

调用该接口必须传入聊天室 ID，因此必须在聊天室房间已创建成功之后调用。客户端调用加入聊天室接口时会自动完成创建与加入动作。

该接口不具备用户权限控制功能。建议由您业务中具有"房主"或"主播"角色的用户在成功加入聊天室后调用此接口，其他成员无需重复调用。

POST： https://数据中心域名/chatroom/correlation/rtc.json

频率限制： 每秒钟限 100 次

签名规则： 所有服务端 API 请求均需要进行规则校验，详见 API 请求签名。

正文参数​

HTTP 请求正文数据格式为 application/x-www-form-urlencoded，支持以下 HTTP 表单参数：

参数类型必传说明
chatroomIdString是聊天室 ID。
rtcroomIdString是音视频房间 ID。

请求示例​

HTTP
POST /chatroom/correlation/rtc.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

rtcroomId=jlk456j5&chatroomId=jlk456j6

返回结果​

HTTP 响应正文包含具有以下结构的 JSON 对象：

返回值返回类型说明
codeNumber返回码。200 表示处理成功。

返回结果示例​

HTTP
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200}
最后于 更新