setRemoteAudioPlaybackVolume method

Future<int?> setRemoteAudioPlaybackVolume({
  1. required string streamId,
  2. required int volume,
})

@detail api @author huanghao @brief 调节本端播放收到的远端流时的音量。你必须在进房后进行设置。流的发布状态改变不影响设置生效。 @param streamId 流 ID,用于指定要调节音量的远端流。 @param volume 音量值和原始音量的比值,范围是 0, 400,单位为 %,自带溢出保护。
为保证更好的通话质量,建议将 volume 值设为 0,100。 @return 方法调用结果:
- 0:成功; - <0:失败。具体失败原因参看 ReturnStatus{@link #ReturnStatus}。 @note 假设某远端用户 A 始终在被调节的目标用户范围内:
- 当该方法与 setRemoteRoomAudioPlaybackVolume{@link #RTCRoom#setRemoteRoomAudioPlaybackVolume} 共同使用时,本地收听用户 A 的音量为后调用的方法设置的音量; - 当该方法与 setPlaybackVolume{@link #RTCEngine#setPlaybackVolume} 方法共同使用时,本地收听用户 A 的音量将为两次设置的音量效果的叠加。 - 当你调用该方法设置远端流音量后,如果远端退房,接口设置失效。

Implementation

Future<int?> setRemoteAudioPlaybackVolume(
    {required string streamId, required int volume}) async {
  $a() => ($instance as $p_a.RTCEngine)
      .setRemoteAudioPlaybackVolume(streamId, volume);
  $i() => ($instance as $p_i.ByteRTCEngine)
      .setRemoteAudioPlaybackVolume(streamId, volume);

  if (Platform.isAndroid) {
    return $a();
  } else if (Platform.isIOS) {
    return $i();
  } else {
    throw UnsupportedError(
        'Not Support Platform ${Platform.operatingSystem}');
  }
}