房间状态同步
「房间状态同步」是实时音视频产品提供的一项服务端回调服务,具体提供以下能力:
- 将音视频房间状态变化按照指定的时间间隔通知您的应用服务器。
- 将呼叫双方、会议成员或直播房间中主播角色用户触发的事件通知您的应用服务器。具体事件可参见下文的 event 字段(房间事件类型)。
注意
直播模式房间中观众角色的操作事件不会触发事件回调。
开通服务
您可以前往音视频通话页面,配置房间状态同步回调地址。注意回调地址必须是公网可访问的 URL。具体步骤如下:
- 确认当前 App Key 已开通音视频服务 。如果您拥有多个应用,注意先选择应用名称。每个应用都提供用于隔离生产和开发环境的两套独立 App Key / Secret。应用时,请注意选择正确的环境(开发 / 生产)。
提示
如果您尚未向融云申请应用上线,仅可使用开发环境。
-
如果已处于音视频通话页面,直接填写房间状态同步回调地址。
-
回调地址示例:
http(s)://your.app.server/any-url-path
-
如果需要选择版本,请选择 1.1 (1.0 版本已不再维护)。
-
配置后 15 分钟后生效。
-
配置完成后,您的 App 内所有音视频房间的任何状态变更,均会通过 HTTP 请求,实时回调您的服务器,如:音视频房间的创建、销毁、用户(不含观众角色)的加入与退出、发布音频或视频资源。
回调方法
POST