功能概览
录制支持分段录制:一次会话内可以反复“开始 → 停止”,每段生成一个
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() {@Overridepublic void onRecordStart() {}@Overridepublic void onRecording(long timeStamp) {}@Overridepublic 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(),删掉的会是上一段而不是刚录的这段。正确做法是在已有的录制监听里处理重录:
@Overridepublic void onStopRecord(TAVRecorderResult ret) {if (ret.stage == TAVRecordResultStage.COMPLETED && needRetake) {needRetake = false;recorder.deleteLastSegment(); // 刚录完的这段此时已在列表中recorder.startRecord(enableMic, speed);}}
说明:
不要在
onStopRecord 里重新调用 setRecordListener,也不要无条件重录,否则会形成循环录制。分段后统一处理
getSegments() 返回的是分段的独立文件列表(每段含独立的 speed 与 BGM 信息)。录制 SDK 不提供合并能力:如需单个成片,需按顺序拼接,或把多段交给编辑模块作为素材合成。