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

iOS

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

功能概览

录制支持分段录制:一次会话内可以反复「开始 → 停止」,每段生成一个 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];
说明:
变速录制时 BGM 播放速率会自动同步为 1.0/speed,使 BGM 节奏与录制内容对齐。详见 背景音乐 文档。

典型场景

重录上一段

[recorder stopRecord];
[recorder deleteLastSegment];
[recorder startRecordWithSpeed:1.0 enableMic:YES];

分段后统一处理

getSegments 返回列表后,先调用 composeVideo:completion: 合成为单一文件,再交给编辑模块(TAVEditor)继续处理。也可以把每一段的 path 逐个 addVideoClip: 加入编辑器,由编辑模块完成拼接。