Agora Java API Reference for Android
Public Member Functions | List of all members
io.agora.rtc2.IMediaRecorderCallback Interface Reference

Public Member Functions

void onRecorderStateChanged (String channelId, int uid, int state, int reason)
 Callback for changes in recording state. More...
 
void onRecorderInfoUpdated (String channelId, int uid, RecorderInfo info)
 Recording information update callback. More...
 

Detailed Description

The IMediaRecorderCallback interface.

Since
v4.0.0

Member Function Documentation

◆ onRecorderStateChanged()

void io.agora.rtc2.IMediaRecorderCallback.onRecorderStateChanged ( String  channelId,
int  uid,
int  state,
int  reason 
)

Callback for changes in recording state.

The SDK triggers this callback when the recording state of the audio and video stream changes. It reports the current state of the recording and the reason for the change.

Parameters
channelIdName of the channel.
uidUser ID.
stateCurrent recording state:
  • RECORDER_STATE_ERROR (-1): An error occurred during recording of the audio and video stream.
  • RECORDER_STATE_START (2): Recording of the audio and video stream starts.
  • RECORDER_STATE_STOP (3): Recording of the audio and video stream stops.
reasonReason for the recording state change:
  • RECORDER_REASON_NONE (0): Everything is working normally.
  • RECORDER_REASON_WRITE_FAILED (1): Failed to write the recording file.
  • RECORDER_REASON_NO_STREAM (2): No available audio and video stream to record or the stream was interrupted for more than 5 seconds.
  • RECORDER_REASON_OVER_MAX_DURATION (3): The recording duration exceeds the maximum limit.
  • RECORDER_REASON_CONFIG_CHANGED (4): The recording configuration has changed.

◆ onRecorderInfoUpdated()

void io.agora.rtc2.IMediaRecorderCallback.onRecorderInfoUpdated ( String  channelId,
int  uid,
RecorderInfo  info 
)

Recording information update callback.

After you successfully register this callback and start audio and video stream recording, the SDK periodically triggers this callback based on the value of recorderInfoUpdateInterval that you set in MediaRecorderConfiguration, reporting the current recording file's name, duration, and size.

Parameters
channelIdThe channel name.
uidThe user ID.
infoThe recording file information. See RecorderInfo for details.