类 | |
interface | IMediaRecorderCallback |
class | MediaRecorderConfiguration |
class | RecorderInfo |
Public 成员函数 | |
int | startRecording (MediaRecorderConfiguration config) |
int | stopRecording () |
void | release () |
静态 Public 成员函数 | |
static AgoraMediaRecorder | getMediaRecorder (RtcEngine engine, IMediaRecorderCallback callback) |
静态 Public 属性 | |
static final int | RECORDER_STATE_ERROR = -1 |
static final int | RECORDER_STATE_START = 2 |
static final int | RECORDER_STATE_STOP = 3 |
static final int | RECORDER_ERROR_NONE = 0 |
static final int | RECORDER_ERROR_WRITE_FAILED = 1 |
static final int | RECORDER_ERROR_NO_STREAM = 2 |
static final int | RECORDER_ERROR_OVER_MAX_DURATION = 3 |
static final int | RECORDER_ERROR_CONFIG_CHANGED = 4 |
static final int | RECORDER_ERROR_CUSTOM_STREAM_DETECTED = 5 |
static final int | STREAM_TYPE_AUDIO = 0x1 |
static final int | STREAM_TYPE_VIDEO = 0x2 |
static final int | STREAM_TYPE_BOTH = STREAM_TYPE_AUDIO | STREAM_TYPE_VIDEO |
static final int | CONTAINER_MP4 = 1 |
AgoraMediaRecorder
类,用于在客户端录制以下内容:
|
static |
获取 AgoraMediaRecorder
对象。
RtcEngine
对象后调用。engine | RtcEngine 对象。详见 RtcEngine。 |
callback | IMediaRecorderCallback 接口实例。详见 IMediaRecorderCallback。 |
AgoraMediaRecorder
对象。 int io.agora.rtc.AgoraMediaRecorder.startRecording | ( | MediaRecorderConfiguration | config | ) |
开启本地音视频流录制。
成功获取 AgoraMediaRecorder
对象后,你可以调用该方法开启本地音视频流录制。
该方法录制在客户端录制以下内容:
只有当检测到可录制的音视频流时,才能成功生成录制文件;当没有可录制的音视频或录制中的音视频流中断超过 5 秒后, SDK 会停止录制,并触发 onRecorderStateChanged(RECORDER_STATE_ERROR, RECORDER_ERROR_NO_STREAM) 回调。
config | 音视频流录制配置。详见 MediaRecorderConfiguration。 |
ERR_INVALID_ARGUMENT
):参数无效。请确保:ERR_NOT_SUPPORTED
):RtcEngine
当前状态不支持该操作。可能因为录制正在进行中或录制出错停止。ERR_NOT_INITIALIZED
):RtcEngine
尚未初始化就调用方法。请确认在调用 startRecording
前已调用 getMediaRecorder。 int io.agora.rtc.AgoraMediaRecorder.stopRecording | ( | ) |
停止本地音视频流录制。
stopRecording
;否则,生成的录制文件可能无法正常播放。ERR_NOT_INITIALIZED
):RtcEngine 尚未初始化就调用方法。请确认在调用 stopRecording
前已调用 getMediaRecorder。 void io.agora.rtc.AgoraMediaRecorder.release | ( | ) |
释放 AgoraMediaRecorder
对象。
该方法释放 AgoraMediaRecorder
对象使用的 RtcEngine
对象和其他所有资源。 调用该方法后,如果需要再次开启录制,需要重新调用 getMediaRecorder 获取 AgoraMediaRecorder
对象。
|
static |
-1:音视频流录制出错,错误原因详见 error 中的提示。
|
static |
2:音视频流录制开始。
|
static |
3:音视频流录制停止。
|
static |
0:一切正常。
|
static |
1:录制文件写入失败。
|
static |
2:没有可录制的音视频流或者录制的音视频流中断超过 5 秒。
|
static |
3:录制时长超出上限。
|
static |
4:录制配置改变。
|
static |
5:在通信场景下,捕捉到 3.0.0 之前版本的用户发送的音视频流。
|
static |
1:仅录制音频。
|
static |
2:仅录制视频。
|
static |
3:录制音视频
|
static |
1:MP4 格式。