订阅名单
更新时间: 2024/11/18 11:08:13
在新版云端录制接口中,默认情况下云端录制会订阅房间内所有发布的音视频流。您也可以通过服务端接口灵活控制 UID 订阅策略。云端录制支持设置音频和视频的订阅白名单或黑名单,也可以在录制过程中随时更新订阅名单。
调用创建云端录制任务接口开始录制时,通过 streamSubscribe
中的 audioUidList
和 videoUidList
指定音频和视频流的订阅黑白名单。在录制过程中,通过更新订阅名单接口的 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":[
]
}
}
此文档是否对你有帮助?