2023/12/27 14:25:19
设置订阅名单
默认情况下,云端录制会订阅频道内所有发布的音视频流。你也可以使用 API 进行灵活的 UID 订阅。此外,你还可以分别设置音频和视频的订阅白名单或黑名单,并在录制过程中更新订阅名单。
实现方法
在开始录制时,你可以通过 start
方法中的相关字段设置订阅的黑白名单。
在录制过程中,则可以通过 update
方法中的 streamSubscribe
字段更新订阅名单。
设置音频订阅名单
云端录制提供了如下字段用来设置音频订阅名单。你可以根据场景需要选择其中一个字段进行设置。
subscribeAudioUids
:通过 UID 指定要订阅的音频流,即音频订阅白名单。unSubscribeAudioUids
:指定不订阅的音频流,即音频订阅黑名单。
注意
subscribeAudioUids
和 unSubscribeAudioUids
不可以同时设置。
设置视频订阅名单
云端录制提供了如下字段用来设置音频订阅名单。你可以根据场景需要选择其中一个字段进行设置。
subscribeVideoUids
:通过 UID 指定要订阅的视频流,即视频订阅白名单。unSubscribeVideoUids
:指定不订阅的视频流,即视频订阅黑名单。
注意
subscribeVideoUids
和 unSubscribeVideoUids
不可以同时设置。
订阅示例
假设录制开始时,频道内共有 111
、222
、333
、444
四个用户,中途又进入两个 UID 未知的用户。下表列出了几种常见的订阅方式以及推荐的字段设置。
订阅方式 | 推荐字段设置 |
---|---|
订阅全部音频流和视频流 | 无需设置订阅相关字段。 |
订阅全部音频流,只订阅 111 和 222 的视频流 | subscribeAudioUids : ["#allstream#"] subscribeVideoUids: ["111","222"] |
订阅全部音频流,不订阅 111 和 222 的视频流 | subscribeAudioUids: ["#allstream#"] unSubscribeVideoUids: ["111","222"] 。云端录制会订阅全部音频流以及 333 、444 和两个 UID 未知用户的视频流。 |
订阅全部音频流,不订阅视频流 | subscribeAudioUids: ["#allstream#"] 。将 streamType 设置为 0 ,也可达到同样的效果。 |
不订阅 222 的音频流,只订阅 111 的视频流 | unSubscribeAudioUids: ["222"] subscribeVideoUids: ["111"] 。云端录制会订阅 111 、333 、444 和两个 UID 未知用户的音频流,以及 111 的视频流。 |
信息
上述示例中的 ["#allstream#"]
为通配符,指频道内所有 UID。
开发注意事项
在设置订阅名单时,你还需要关注如下注意事项:
- 音频和视频订阅需要的单独设置。如果你仅设置了音频的订阅名单,但没有设置视频的订阅名单,云端录制服务不会订阅任何视频流。反之亦然。
- 如果
recordingConfig
中的streamTypes
为0
(只订阅音频),则不可设置视频订阅名单; 如果recordingConfig
中的streamTypes
为1
(只订阅视频),则不可设置音频订阅名单。 - 当订阅的 UID 超过 17 人时,云端录制会按 UID 加入频道的时间顺序,订阅前 17 个 UID 的视频。当某个订阅的 UID 离开频道,云端录制会自动订阅第 18 个加入频道的 UID,以此类推。