设置订阅名单

最近更新时间：2022-09-20 05:17:40

功能描述
实现方法
设置音频订阅名单
设置视频订阅名单
示例
注意事项

功能描述

默认情况下，云端录制会订阅频道内所有发布的音视频流。你可以使用 API 进行灵活的 UID 订阅。也设置音频和视频的订阅白名单或黑名单，还可以在录制过程中更新订阅名单。

实现方法

  • 在开始录制时，你可以通过 start 方法中的相关参数设置订阅的黑白名单。

  • 在录制过程中，你可以通过 update 方法中的 streamSubscribe 参数更新订阅名单。

如果设置了音频的订阅名单，但没有设置视频的订阅名单，云端录制服务不会订阅任何视频流。反之亦然。

设置音频订阅名单

选择以下参数之一设置音频订阅名单。两者不可同时设置。

  • subscribeAudioUids：指定要订阅的音频流，即音频订阅白名单。
  • unSubscribeAudioUids：指定不订阅的音频流，即音频订阅黑名单。

设置视频订阅名单

选择以下参数之一设置视频订阅名单。两者不可同时设置。

  • subscribeVideoUids：指定要订阅的视频流，即视频订阅白名单。

  • unSubscribeVideoUids：指定不订阅的视频流，即视频订阅黑名单。

示例

假设录制开始时，频道内共有 666、777、888、999 四个用户，中途又进入两个 UID 未知的用户。下表列出了几种常见的订阅方式以及推荐的参数设置。

订阅方式推荐参数设置
订阅全部音频流和视频流无需设置订阅相关参数。
订阅全部音频流，只订阅 666 和 777 的视频流subscribeAudioUids : ["#allstream#"] subscribeVideoUids: ["666","777"]
订阅全部音频流，不订阅 888 和 999 的视频流subscribeAudioUids : ["#allstream#"] unSubscribeVideoUids: ["888","999"]
订阅全部音频流，不订阅视频流subscribeAudioUids : ["#allstream#"] 将streamType 设置为 0，也可达到同样的效果。
不订阅 888 的音频流，只订阅 999 的视频流unSubscribeAudioUids: ["888"] subscribeVideoUids: ["999"] 云端录制会订阅 666、777、999 和两个 UID 未知用户的音频流，以及 999 的视频流。

注意事项

  • 你可以使用通配符 ["#allstream#"] 指定频道内所有 UID。

  • 如果 recordingConfig 中的 streamTypes 为 0（只订阅音频），则不可设置视频订阅名单； 如果 recordingConfig 中的 streamTypes 为 1（只订阅视频），则不可设置音频订阅名单。

  • 当订阅的 UID 超过 50 人时，云端录制会按 UID 加入频道的时间顺序，订阅前 50 个 UID 的视频。当某个订阅的 UID 离开频道，云端录制会自动订阅第 51 个加入频道的 UID，以此类推。