subscribeWTNAudioStream method
@author hanchenchen
@detail api
@valid since 3.60. 自 3.60 起,此接口替代了 startPlayPublicStream: 和 stopPlayPublicStream: 方法来订阅/取消订阅指定 WTN 音频流,如果你使用了这两个方法,请迁移至此接口。
@brief 订阅/取消订阅指定 WTN 音频流
无论用户是否在房间内,都可以调用本接口订阅/取消订阅指定的 WTN 音频流。
@param streamId WTN 流 ID,如果指定流暂未发布,则本地客户端将在其开始发布后接收到流数据。
@param subscribe 是否订阅 WTN 流
- true:订阅
- false:取消订阅
@return
- 0: 成功。同时将收到 onWTNVideoSubscribeStateChanged:state:reason:{@link #ByteRTCWTNStreamDelegate#onWTNVideoSubscribeStateChanged:state:reason} 回调。
- !0: 失败。当参数不合法或参数为空,调用失败。
@note
- 一个客户端最多同时播放 5 路 WTN 流,请及时调用 subscribeWTNVideoStream:subscribe:{@link #ByteRTCWTNStream#subscribeWTNVideoStream:subscribe}/subscribeWTNAudioStream:subscribe:{@link #ByteRTCWTNStream#subscribeWTNAudioStream:subscribe} 取消订阅 WTN 流,避免订阅的 WTN 流数量超限。
- 在调用本接口之前,建议先绑定渲染视图。
- 调用 setWTNRemoteVideoCanvas:withCanvas:{@link #ByteRTCWTNStream#setWTNRemoteVideoCanvas:withCanvas} 绑定内部渲染视图
- 调用 setWTNRemoteVideoSink:withSink:withConfig:{@link #ByteRTCWTNStream#setWTNRemoteVideoSink:withSink:withConfig} 绑定自定义渲染视图
- 调用本接口后,可以通过 onWTNFirstRemoteAudioFrame:{@link #ByteRTCWTNStreamDelegate#onWTNFirstRemoteAudioFrame} 回调 WTN 音频流首帧解码情况。
- 调用本接口后,可以通过 onWTNSEIMessageReceived:andChannelId:andMessage:{@link #ByteRTCWTNStreamDelegate#onWTNSEIMessageReceived:andChannelId:andMessage} 回调 WTN 流中包含的 SEI 信息。
@order 1
Implementation
FutureOr<int> subscribeWTNAudioStream(
NSString streamId, bool subscribe) async {
return await nativeCall(
'subscribeWTNAudioStream:subscribe:', [streamId, subscribe]);
}