startAudioMixing method

Future<int> startAudioMixing(
  1. NERtcAudioMixingOptions options
)

开始播放音乐文件

该方法指定本地或在线音频文件来和录音设备采集的音频流进行混音。

  • 支持的音乐文件类型包括 MP3、M4A、AAC、3GP、WMA 和 WAV 格式，支持本地文件或在线 URL。
  • 成功调用该方法后，如果播放状态改变，本地会触发 onAudioMixingStateChanged 回调。

请在加入房间后调用该方法。 从 V4.3.0 版本开始，若您在通话中途调用此接口播放音乐文件时，手动设置了伴音播放音量或发送音量，则当前通话中再次调用时默认沿用此设置。 从 V4.4.0 版本开始，开启或关闭本地音频采集的操作不再影响音乐文件播放，即 enableLocalAudio(false) 后仍旧可以播放音乐文件。

options 创建混音任务配置的选项，包括混音任务类型、混音文件全路径或 URL 等，详细信息请参考 NERtcAudioMixingOptions。 如果成功返回 0。

Implementation

Future<int> startAudioMixing(NERtcAudioMixingOptions options) async {
  IntValue reply = await _api.startAudioMixing(StartAudioMixingRequest()
    ..path = options.path
    ..loopCount = options.loopCount
    ..sendEnabled = options.sendEnabled
    ..sendVolume = options.sendVolume
    ..playbackEnabled = options.playbackEnabled
    ..playbackVolume = options.playbackVolume);
  return reply.value ?? -1;
}