MediaRecorder

Used for recording audio and video on the client.

MediaRecorder can record the following:
  • The audio captured by the local microphone and encoded in AAC format.
  • The video captured by the local camera and encoded by the SDK.

startRecording

Starts recording the local audio and video. 

Future<void> startRecording(MediaRecorderConfiguration config);

After successfully getting the object, you can all this method to enable the recoridng of the local audio and video.

This method can record the following content:
  • The audio captured by the local microphone and encoded in AAC format.
  • The video captured by the local camera and encoded by the SDK.

The SDK can generate a recording file only when it detects the recordable audio and video streams; when there are no audio and video streams to be recorded or the audio and video streams are interrupted for more than five seconds, the SDK stops recording and triggers the onRecorderStateChanged(Error, NoStream) callback.

Attention: Call this method after joining the channel.

Parameters

config
The recording configuration. See MediaRecorderConfiguration.

Returns

  • 0(ERR_OK): Success.
  • < 0: Failure.
    • -2(ERR_INVALID_ARGUMANT): The parameter is invalid. Ensure the following:
      • The specified path of the recording file exists and is writable.
      • The specified format of the recording file is supported.
      • The maximum recording duration is correctly set.
    • -4(ERR_NOT_SUPPORTED): RtcEngine does not support the request due to one of the following reasons:
      • The recording is ongoing.
      • The recording stops because an error occurs.
    • -7(ERR_NOT_INITIALIZED): This method is called before the initialization of RtcEngine.

stopRecording

Stops recording the local audio and video 

Future<void> stopRecording();
Attention: After calling startRecording, if you want to stop the recording, you must call this method; otherwise, the generated recording files may not be playable.

Returns

  • 0(ERR_OK): Success.
  • < 0: Failure:
    • -7(ERR_NOT_INITIALIZED): This method is called before the initialization of RtcEngine.