startAudioRecording abstract method

开始客户端录音。

调用该方法后，客户端会录制房间内所有用户混音后的音频流，并将其保存在本地一个录音文件中。录制开始或结束时，自动触发 onAudioRecording 回调。

调用时机

请在引擎初始化之后调用此接口，且该方法仅可在加入房间后调用。

说明

• 指定的录音音质不同，录音文件会保存为不同格式：
  • WAV：音质保真度高，文件大。
  • AAC：音质保真度低，文件小。
• 客户端只能同时运行一个录音任务，正在录音时，如果重复调用 startAudioRecording，会结束当前录制任务，并重新开始新的录音任务。
• 本端用户离开房间时，自动停止录音。您也可以在通话中随时调用 stopAudioRecording 手动停止录音。

参数说明

filePath 录音文件在本地保存的绝对路径，需要精确到文件名及格式。例如：sdcard/xxx/audio.aac。 请确保指定的路径存在并且可写, 目前仅支持 WAV 或 AAC 文件格式。

sampleRate 录音采样率（Hz），可以设为 16000、32000（默认）、44100 或 48000。

quality 录音音质，只在 AAC 格式下有效。详细说明请参考 NERtcAudioRecordingQuality。

相关回调

调用此接口成功后会触发 NERtcChannelEventCallback.onAudioRecording 回调，通知音频录制任务状态已更新。音频录制状态码请参考 NERtcAudioRecordingCode。

返回值

• 0（OK）：方法调用成功。
• 其他：方法调用失败。
  • 30003（invalidParam）：参数错误，比如设置的采样率无效。
  • 30005（invalidState)：状态错误，比如引擎尚未初始化。