subscribeRemoteAudio abstract method

Future<int> subscribeRemoteAudio(
  1. int uid,
  2. bool subscribe
)

订阅或取消订阅指定远端用户的音频主流。

加入房间时,默认订阅所有远端用户的音频主流,您也可以通过此方法取消或恢复订阅指定远端用户的音频主流。

调用时机

该方法仅在加入房间后收到远端用户开启音频主流的回调 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);