功能概览
录制支持分段录制:一次会话内可以反复「开始 → 停止」,每段生成一个
TAVRecordSegment,最终通过 composeVideo:completion: 合成完整视频;每段可以独立设置录制速度,也支持删除最后一段重录。分段数据由 SDK 维护,业务方通过 getSegments 读取。相关接口类
接口类名 | 描述 |
TAVRecorder | 录制入口,提供开始/停止/分段管理。 |
TAVRecordSegment | 单个录制片段的数据模型。 |
TAVRecordListener | 录制开始、进行中、结束回调。 |
分段录制
基本流程
// 1. 开始一段录制// speed:录制速度,1.0 为正常速度,>1.0 快速,<1.0 慢动作// enableMic:是否录制麦克风音频[recorder startRecordWithSpeed:1.0 enableMic:YES];// 2. 停止当前段[recorder stopRecord];// 3. 继续录下一段(可重复)[recorder startRecordWithSpeed:1.0 enableMic:YES];[recorder stopRecord];// 4. 读取全部片段NSArray<TAVRecordSegment *> *segments = [recorder getSegments];// 5. 合成为单一视频文件[recorder composeVideo:@"/path/to/output.mp4" completion:^(NSError *error) {// error 为 nil 表示合成成功(回调在主线程)}];
片段模型
TAVRecordSegment:字段 | 类型 | 说明 |
path | NSString * | 录制视频路径。 |
duration | CMTime | 录制视频时长。 |
bgmPath | NSString * | 背景音乐路径。 |
bgmStartPosition | CMTime | 背景音乐起始时间。 |
duetMediaStartPosition | NSTimeInterval | 本段录制开始时合拍素材所在的 source 位置(秒)。删除本段后据此把合拍素材回退到本段起点。 |
分段管理
方法 | 说明 |
getSegments | 按录制顺序返回全部片段。 |
deleteLastSegment | 删除最后一段(同时删除对应文件),用于“重录上一段”。 |
clearAllSegments | 清空全部片段及对应文件,重新开始。 |
composeVideo:completion: | 将所有片段合成为一个视频文件。 |
说明:
删除与清空只影响已停止的片段;录制过程中如需重来,先
stopRecord 再 deleteLastSegment。录制结果
stopRecord 的结果通过 TAVRecordListener 回调:#pragma mark - TAVRecordListener- (void)onRecordStart {// 录制开始}- (void)onRecording:(CMTime)recordingTime {// 录制中,recordingTime 为当前已录制时长(已按 recordSpeed 缩放)}- (void)onStopRecord:(NSError *)stopResult {// 录制停止:成功时 stopResult 为 nil,失败时为具体错误信息}- (void)onCameraError:(NSError *)error {// 相机初始化/配置失败}
说明:
SDK 未提供独立的录制结果模型:成功/失败通过
onStopRecord: 的 NSError * 是否为 nil 判定,片段文件路径从 getSegments 返回的 TAVRecordSegment.path 读取,相机侧错误统一走 onCameraError:。变速录制
速度通过
startRecordWithSpeed:enableMic: 的 speed 参数指定,不同片段可以使用不同速度:[recorder startRecordWithSpeed:0.5 enableMic:YES]; // 慢动作[recorder stopRecord];[recorder startRecordWithSpeed:2.0 enableMic:YES]; // 快动作[recorder stopRecord];
说明:
典型场景
重录上一段
[recorder stopRecord];[recorder deleteLastSegment];[recorder startRecordWithSpeed:1.0 enableMic:YES];
分段后统一处理
getSegments 返回列表后,先调用 composeVideo:completion: 合成为单一文件,再交给编辑模块(TAVEditor)继续处理。也可以把每一段的 path 逐个 addVideoClip: 加入编辑器,由编辑模块完成拼接。