setRemoteAudioPlaybackVolume method
@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}');
}
}