帮你快速理解、总结文档立即下载

Android

最近更新时间:2026-11-09 14:52:03
我的收藏

功能概览

录制支持分段录制:一次会话内可以反复“开始 → 停止”,每段生成一个 TAVRecordSegment,最终按顺序拼接成完整视频;每段可以独立设置录制速度,也支持删除最后一段重录。分段数据由 SDK 维护,业务方通过 getSegments() 读取。

相关接口类

接口类名
描述
TAVRecorder
录制入口,提供开始/停止/分段管理。
TAVRecordSegment
单个录制片段的数据模型。
TAVRecordListener
录制开始、进行中、结束回调。
TAVRecorderResult
录制结束结果(结果码与阶段)。

分段录制

基本流程

// 1. 开始一段录制:是否录入麦克风、录制速度倍率
recorder.startRecord(true, 1.0f);

// 2. 停止当前段
recorder.stopRecord();

// 3. 继续录下一段(可重复)
recorder.startRecord(true, 1.0f);
recorder.stopRecord();

// 4. 读取全部片段
List<TAVRecordSegment> segments = recorder.getSegments();

片段模型

TAVRecordSegment(实现 Parcelable):
字段
类型
说明
path
String
片段文件路径。
duration
long
片段时长。
speed
float
该段的录制速度倍率,默认 1f。
bgmPath
String
该段使用的背景音乐路径。
bgmStartPosition
long
该段背景音乐的起始位置。

分段管理

方法
说明
List<TAVRecordSegment> getSegments()
按录制顺序返回全部片段(返回的是 SDK 内部列表引用,请只读使用)。
void deleteLastSegment()
删除最后一段,用于“重录上一段”。
void clearAll()
清空全部片段,重新开始。
boolean isRecording()
当前是否正在录制。
说明:
片段在 stopRecord() 之后异步写入列表,因此调用 stopRecord() 后不要立刻读取 getSegments(),建议在 onStopRecord 回调后再取。分段列表由 SDK 维护,与是否注册 TAVRecordListener 无关。删除与清空只影响已停止的片段。

录制结果

stage 的判定边界:录制会话启动之前的失败(编码器配置无法解析、编码器不支持该尺寸/帧率、输出文件创建失败等)为 START_REJECTED;会话已启动之后的失败为 RECORDING_FAILED;正常收尾为 COMPLETED。
stopRecord() 的结果通过回调返回,TAVRecorderResult 含三个关键字段:
字段
说明
outputPath
输出文件路径。
code
TAVRecordResultCode:SUCCESS / UNKNOWN / VIDEO_PATH_ERROR / ENCODE_PREPARE_ERROR / ENCODE_FRAME_FAILED 等。
stage
TAVRecordResultStage:COMPLETED 表示正常结束;START_REJECTED 表示启动被拒;RECORDING_FAILED 表示录制中失败。
recorder.setRecordListener(new TAVRecordListener() {
@Override
public void onRecordStart() {
}

@Override
public void onRecording(long timeStamp) {
}

@Override
public void onStopRecord(TAVRecorderResult ret) {
if (ret.stage == TAVRecordResultStage.COMPLETED) {
// 正常结束,ret.outputPath 为本段文件
} else if (ret.stage == TAVRecordResultStage.START_REJECTED) {
// 启动被拒,通常是分辨率/编码器不支持
}
}
});

变速录制

速度通过 startRecord(boolean enableMic, float speed) 的 speed 参数指定,写入该片段的 TAVRecordSegment.speed,不同片段可以使用不同速度。
recorder.startRecord(true, 0.5f); // 慢动作
recorder.stopRecord();

recorder.startRecord(true, 2.0f); // 快动作
recorder.stopRecord();

典型场景

重录上一段

stopRecord() 是异步的:片段在 onStopRecord 回调中才加入列表。若在 stopRecord() 之后立刻调用 deleteLastSegment(),删掉的会是上一段而不是刚录的这段。
正确做法是在已有的录制监听里处理重录:
@Override
public void onStopRecord(TAVRecorderResult ret) {
if (ret.stage == TAVRecordResultStage.COMPLETED && needRetake) {
needRetake = false;
recorder.deleteLastSegment(); // 刚录完的这段此时已在列表中
recorder.startRecord(enableMic, speed);
}
}
说明:
不要在 onStopRecord 里重新调用 setRecordListener,也不要无条件重录,否则会形成循环录制。

分段后统一处理

getSegments() 返回的是分段的独立文件列表(每段含独立的 speed 与 BGM 信息)。录制 SDK 不提供合并能力:如需单个成片,需按顺序拼接,或把多段交给编辑模块作为素材合成。