订阅名单

更新时间: 2023/03/07 06:30:42

在新版云端录制接口中,默认情况下云端录制会订阅房间内所有发布的音视频流。您也可以通过服务端接口灵活控制 UID 订阅策略。云端录制支持设置音频和视频的订阅白名单或黑名单,也可以在录制过程中随时更新订阅名单。

调用创建云端录制任务接口开始录制时,通过 streamSubscribe 中的 audioUidListvideoUidList 指定音频和视频流的订阅黑白名单。在录制过程中,通过更新订阅名单接口的 streamSubscribe 更新订阅名单。

注意事项

  • 如果 streamSubscribe 中的 streamType 设置为 0,表示仅订阅音频流,此时不可设置 videoUidList 指定视频订阅名单,否则会报错 414;如果 streamSubscribe 中的 streamType 为 1,表示仅订阅视频流,此时不可设置 audioUidList 指定音频订阅名单,否则同样会报错 414。
  • 当订阅的 UID 超过 9 人时,云端录制会按 UID 加入房间的时间顺序,订阅前 9 个 UID 的视频。当某个订阅的 UID 离开房间,云端录制会自动订阅第 10 个加入房间的 UID,以此类推。
  • 如果设置订阅音频流,但未设置音频订阅名单,此时默认订阅全部 UID 的音频流,反之亦然。例如 streamSubscribe 中的 streamType 维持默认值 2,表示同时订阅音频和视频流,此时设置了音频的订阅名单,但没有设置视频的订阅名单,则订阅所有 UID 的视频流。
  • 设置订阅名单时,同一媒体流类型的黑名单与白名单不可同时设置,例如不可同时设置音频的黑名单和白名单。

设置音频订阅名单

通过 streamSubscribe.audioUidList 设置音频订阅名单。不可同时设置黑名单和白名单。

  • audioUidList.unSubscribeUids:设置音频订阅黑名单,即不订阅哪些用户的音频流。
  • audioUidList.subscribeUids:设置音频订阅白名单,即订阅哪些用户的音频流。

设置视频订阅名单

通过 streamSubscribe.videoUidList 设置音频订阅名单。不可同时设置黑名单和白名单。

  • videoUidList.unSubscribeUids:设置音频订阅黑名单,即不订阅哪些用户的音频流。
  • videoUidList.subscribeUids:设置音频订阅白名单,即订阅哪些用户的音频流。

示例代码

音视频流部分订阅

{
    "cid":1144350751977184,
    "recordConfig":{
        "recordtype":0
    },
    "detect":{
        "enableSpamDetect":true,
        "scFrequency":1,
        "detectType":1
    },
    "layoutConfig":{
        "hostUid":66602,
        "layoutType":3
    },
     "streamSubscribe":{
        "streamType":2,
        "audioUidList":{
            "subscribeUids":[
                4455,
                66602
            ]
        },
        "videoUidList":{
            "unSubscribeUids":[
                4455
            ]
        }
    }
}

音视频流全订阅

{
    "cid":xxxx,
    "recordConfig":{
        "recordtype":0
    }
}

音频流全订阅

{
    "cid":xxxx,
    "recordConfig":{
        "recordtype":0
    },
    "streamSubscribe":{
        "streamType":0,
        "audioUidList":{
            "unSubscribeUids":[
            ]
        }
}

视频流全订阅

{
    "cid":xxxx,
    "recordConfig":{
        "recordtype":0
    },
    "streamSubscribe":{
        "streamType":1,
        "videoUidList":{
            "unSubscribeUids":[
            ]
        }
}
此文档是否对你有帮助?
有帮助
去反馈
  • 注意事项
  • 设置音频订阅名单
  • 设置视频订阅名单
  • 示例代码
  • 音视频流部分订阅
  • 音视频流全订阅
  • 音频流全订阅
  • 视频流全订阅