subscribeRemoteAudio abstract method
订阅或取消订阅指定远端用户的音频主流。
加入房间时,默认订阅所有远端用户的音频主流,您也可以通过此方法取消或恢复订阅指定远端用户的音频主流。
调用时机
该方法仅在加入房间后收到远端用户开启音频主流的回调 NERtcChannelEventCallback.onUserAudioStart 后可调用。
业务场景
适用于需要手动订阅指定用户音频流的场景。
说明
- 该方法设置内部引擎为启用状态,在 leaveChannel 后设置失效,将恢复至默认。
- 在开启音频自动订阅且未打开服务端 ASL 自动选路的情况下,调用该接口无效。
参数说明
uid
指定用户的 ID
subscribe
是否订阅指定用户的音频主流:
- true: 订阅指定音频流(默认)
- false: 取消订阅指定音频流
返回值
- 0(OK):方法调用成功。
- 其他:方法调用失败。
- 30005(invalidState):状态错误,比如引擎尚未初始化。
- 30004(notSupported):不支持该操作,由于开启了音频自动订阅且未打开服务端 ASL 自动选路。
- 30105(userNotFound):未找到指定用户。
- 30106(invalidUserId):非法指定用户,比如订阅了本端。
- 30107(mediaNotStarted):媒体会话未建立,比如对端未开启音频主流。
- 30108(sourceNotFound):媒体源未找到,比如对端未开启音频主流。
- 30101(roomNotJoined): 尚未加入房间。
Implementation
Future<int> subscribeRemoteAudio(int uid, bool subscribe);