当前位置：首页 > news >正文

（十五）深入了解 AVFoundation - 编辑：音视频裁剪与拼接

news 来源：原创 2025/6/17 10:08:36

引言

在 iOS 开发中，视频编辑一直是一个门槛不低但极具潜力的能力场景。无论是用户上传短视频前的裁剪处理，还是内容拼接生成精彩合集，都离不开对 AVFoundation 框架的深入理解。

本篇我们将聚焦 AVFoundation 的两个核心功能实现：

如何裁剪视频中的某一段时间范围；
如何拼接多个视频（或音频）片段为一段完整内容。

而这一切，我们都会通过一个可运行的实战 Demo 来完成：你可以选择本地素材，设置裁剪时间，预览播放效果，并导出成成品视频。

一、裁剪指定时间段视频（实战功能 1）

裁剪视频是编辑场景中最常见的需求，比如保留精彩片段、生成短视频或裁掉片头片尾。在 AVFoundation 中，这项工作可以通过 AVAssetExportSession 来轻松实现。

1.1 实现原理

整体流程如下：

使用 AVAsset 加载原始视频；
设置导出时间范围（timeRange）；
创建导出任务，生成目标视频。

只需几行代码即可完成基本裁剪操作。

1.2 示例代码

let asset = AVAsset(url: inputURL)guard let exportSession = AVAssetExportSession(asset: asset, presetName: .presetHighestQuality) else {print("❌ 无法创建导出会话")return
}let startTime = CMTime(seconds: 3, preferredTimescale: 600)
let duration = CMTime(seconds: 5, preferredTimescale: 600)
exportSession.timeRange = CMTimeRange(start: startTime, duration: duration)exportSession.outputURL = outputURL
exportSession.outputFileType = .mp4
exportSession.exportAsynchronously {switch exportSession.status {case .completed:print("✅ 导出成功")case .failed:print("❌ 导出失败: \(exportSession.error?.localizedDescription ?? "未知错误")")default:break}
}

这段代码会将原始视频中的第 3 秒开始，截取 5 秒长度（即第 3~8 秒）作为输出结果。

1.3 常见问题与注意事项

起始时间越界：startTime + duration 不能超过视频总时长，否则导出失败
导出前几帧黑屏：起始位置若非关键帧，可能出现黑屏，建议使用更高的导出质量或手动设置关键帧
presetName：建议使用 .presetHighestQuality 保证画质，可根据需要替换为 .presetMediumQuality 等
输出类型：常用为 .mp4（即 .mov 对应 .mov 容器），需确保目标路径无文件冲突

二、拼接多个视频（实战功能 2）

除了裁剪，另一个常见场景是将多个片段拼接成一段完整视频，比如：

用户选择多个素材后顺序合成；
为视频添加片头片尾；
制作合集、片段合成。

这类需求的核心就是「轨道拼接」，AVFoundation 提供了 AVMutableComposition 来完成这项任务。

2.1 实现原理

拼接的思路是：

创建一个空的 AVMutableComposition；
添加一个视频轨道（AVMutableCompositionTrack）；
将每个片段依次插入轨道，设置其插入时间点；
最终通过 AVAssetExportSession 导出成品。

注意：如果同时拼接音频，也需添加对应的音频轨并分别插入。

2.2 示例代码

let composition = AVMutableComposition()
guard let videoTrack = composition.addMutableTrack(withMediaType: .video,preferredTrackID: kCMPersistentTrackID_Invalid) else {print("❌ 无法创建视频轨道")return
}var currentTime = CMTime.zerofor asset in assetList {guard let sourceTrack = asset.tracks(withMediaType: .video).first else { continue }let range = CMTimeRange(start: .zero, duration: asset.duration)try? videoTrack.insertTimeRange(range, of: sourceTrack, at: currentTime)currentTime = currentTime + asset.duration
}

导出方式与裁剪完全一致：

let exportSession = AVAssetExportSession(asset: composition, presetName: .presetHighestQuality)!
exportSession.outputURL = outputURL
exportSession.outputFileType = .mp4
exportSession.exportAsynchronously {print("✅ 拼接导出完成")
}