除集成在客户端的音频/视频 SDK,声网还提供用于管理实时音视频频道的服务端 API,包括:
- 频道管理 RESTful API:通过你的业务服务器向声网服务器发送 HTTPS 请求,管理频道内的用户和查询频道信息。
- 频道事件回调(Webhook):开通声网消息通知服务后,当订阅的事件发生时,声网服务器会以 HTTPS 请求的形式向你的服务器发送通知,用于实时监控频道状态。
功能描述
声网频道管理支持以下功能:
主要功能 |
功能描述 |
管理用户权限 |
通过调用 RESTful API 管理用户的权限,包括:将指定用户移出频道。禁止指定用户发送音频流。禁止指定用户发送视频流。 |
查询在线频道信息 |
通过调用 RESTful API 查询在线频道列表、频道内的用户列表、指定用户的状态。 |
频道事件回调 |
通过声网消息通知服务实时接收频道状态消息及频道内用户状态消息。 |
适用场景
声网频道管理适用于以下场景:
主要功能 |
特性 |
典型适用场景 |
管理用户权限 |
集成简单安全可靠有 QPS 限制 |
需要在业务服务端管理用户权限的场景,例如:直播中出现未经认证的用户。直播中出现炸房捣乱的用户。向客户端下发的信令消息被劫持。用户异常掉线,导致用户列表无法及时更新。 |
查询在线频道信息 |
集成简单安全可靠有 QPS 限制 |
在频道并发量不大的场景下,直接查询项目下的频道列表以同步频道状态。在同步实时性要求不高的场景下,查询并同步频道内的用户列表和状态。 |
频道事件回调 |
低延时高并发稳定可靠 |
在频道高并发的场景下,通过频道事件回调,在业务层维护一个实时同步的频道状态机:实时监听频道创建/销毁事件,建立当前业务的频道列表。实时监听远端用户加入或离开频道事件,建立频道内的用户列表。实时监听直播场景下用户角色切换事件,建立具有发流权限的用户(主播)列表。 |
你可以根据业务需求,将频道管理 RESTful API 和频道事件回调结合使用,实现稳定可靠、实时有效的频道管理和状态同步。
相关文档