Swift基于ScrollView缩放比例裁剪视频功能实现求助

问题背景 #

我正在实现基于ScrollView缩放比例裁剪视频的功能：通过ScrollView对视频预览进行拖动、缩放后，裁剪出对应区域的视频。目前已将ScrollView的缩放比例应用到视频裁剪逻辑中，但最终输出结果与预期不符。

关键信息 #

• 目标效果：裁剪区域完全匹配ScrollView中预览的可视区域
• 当前问题：裁剪后的视频区域与预览区域偏移或缩放比例不匹配
• 参考实现：基于AVFoundation的视频叠加与动画实现方案
• 测试素材：常规尺寸的视频文件

核心问题分析 #

直接套用ScrollView的缩放比例和偏移量到AVFoundation裁剪逻辑会出问题，核心原因是坐标系与锚点的差异：

1. ScrollView采用屏幕坐标系（原点左上角），而AVFoundation视频坐标系原点在左下角
2. ScrollView缩放时的锚点未同步到视频图层的变换中，导致裁剪区域计算偏差

修复方案 #

1. 坐标系转换适配 #

先将ScrollView的可视区域转换为视频坐标系下的相对区域：

// 获取ScrollView可视区域相对于视频预览视图的Frame
let visibleFrameInPreview = scrollView.convert(scrollView.bounds, to: videoPreviewView)
// 转换为视频坐标系（Y轴翻转，相对比例）
let videoRelativeRect = CGRect(
    x: visibleFrameInPreview.origin.x / videoPreviewView.bounds.width,
    y: 1 - (visibleFrameInPreview.origin.y + visibleFrameInPreview.height) / videoPreviewView.bounds.height,
    width: visibleFrameInPreview.width / videoPreviewView.bounds.width,
    height: visibleFrameInPreview.height / videoPreviewView.bounds.height
)

2. 同步缩放与锚点变换 #

在视频合成时，应用与ScrollView完全一致的缩放和偏移变换：

// 创建视频合成
let videoComposition = AVVideoComposition(asset: targetAsset) { request in
    let sourceLayer = request.sourceImage.layer
    let outputLayer = CALayer()
    outputLayer.frame = CGRect(origin: .zero, size: targetExportSize)
    
    // 复用ScrollView的缩放和偏移参数
    let zoomScale = scrollView.zoomScale
    let contentOffset = scrollView.contentOffset
    sourceLayer.transform = CATransform3DConcat(
        CATransform3DMakeScale(zoomScale, zoomScale, 1.0),
        CATransform3DMakeTranslation(-contentOffset.x, -contentOffset.y, 0)
    )
    
    outputLayer.addSublayer(sourceLayer)
    request.finish(with: outputLayer, context: nil)
}

3. 精确设置裁剪区域 #

通过AVMutableVideoCompositionLayerInstruction设置裁剪区域，避免拉伸：

let composition = AVMutableComposition()
guard let videoTrack = targetAsset.tracks(withMediaType: .video).first else { return }
let compositionTrack = composition.addMutableTrack(withMediaType: .video, preferredTrackID: kCMPersistentTrackID_Invalid)
try? compositionTrack?.insertTimeRange(CMTimeRangeMake(start: .zero, duration: targetAsset.duration), of: videoTrack, at: .zero)

// 创建裁剪指令
let instruction = AVMutableVideoCompositionInstruction()
instruction.timeRange = CMTimeRangeMake(start: .zero, duration: targetAsset.duration)

let layerInstruction = AVMutableVideoCompositionLayerInstruction(assetTrack: compositionTrack!)
// 将转换后的相对区域转为视频绝对尺寸
let absoluteCropRect = CGRect(
    x: videoRelativeRect.origin.x * videoTrack.naturalSize.width,
    y: videoRelativeRect.origin.y * videoTrack.naturalSize.height,
    width: videoRelativeRect.width * videoTrack.naturalSize.width,
    height: videoRelativeRect.height * videoTrack.naturalSize.height
)
layerInstruction.setCropRectangle(absoluteCropRect, at: .zero)

instruction.layerInstructions = [layerInstruction]

let videoComposition = AVMutableVideoComposition()
videoComposition.renderSize = targetExportSize
videoComposition.frameDuration = videoTrack.minFrameDuration
videoComposition.instructions = [instruction]

// 绑定到导出会话
exportSession?.videoComposition = videoComposition

验证步骤 #

1. 先固定缩放比例为1.0，测试裁剪区域是否与ScrollView可视区域完全匹配
2. 检查视频的preferredTransform，处理视频旋转导致的坐标偏差
3. 导出时确保renderSize与目标裁剪尺寸一致，避免自动拉伸

内容的提问来源于stack exchange，提问作者Nirav Ramani