AVPlayerLayer未居中排查：设置.resizeAspect时视频层偏移右侧

我遇到一个问题：视频无法在holderView中居中播放。我将holderView设为红色背景，能明显看到AVPlayerLayer偏移到了右侧。

关键现象：

• 只有设置 playerLayer.videoGravity = .resize 时，视频能正常填充视图，不会偏移
• 使用 .resizeAspect 时，偏移问题出现

我的实现代码如下：

func addPlayerLayer(){
    guard let videoPath = Bundle.main.path(forResource: "scan_animation", ofType: "mp4")
    else {
        print ("ERROR path for video not found")
        return
    }
    let videoView = UIView(frame: CGRect(x:0, y:0, width: holderView.frame.width, height: holderView.frame.height))
    let videoURL = NSURL(fileURLWithPath: videoPath)
    player = AVPlayer(url: videoURL as URL)
    let playerLayer = AVPlayerLayer(player: player)
    playerLayer.frame = videoView.frame
    playerLayer.videoGravity = .resizeAspect
    videoView.layer.addSublayer(playerLayer)
    holderView.addSubview(videoView)
    print("player layer frame \(playerLayer.frame)")
    print("player bounds \(playerLayer.bounds)")
    print("videoView frame \(videoView.frame)")
    print("videoView bounds \(videoView.bounds)")
    print("holderView frame \(holderView.frame)")
    print("holderView bounds \(holderView.bounds)")
}

打印输出显示所有尺寸参数看起来都正常，holderView的leading和trailing都内缩了20像素：

player layer frame (0.0, 0.0, 374.0, 449.0)
player bounds (0.0, 0.0, 374.0, 449.0)
videoView frame (0.0, 0.0, 374.0, 449.0)
videoView bounds (0.0, 0.0, 374.0, 449.0)
holderView frame (20.0, 48.0, 374.0, 449.0)
holderView bounds (0.0, 0.0, 374.0, 449.0)

我已经尝试过添加多种约束，但问题仍然存在。

解决方案 #

1. 检查视频本身的分辨率与宽高比 #

.resizeAspect 会严格保持视频原始宽高比，当视频的像素宽高比和holderView的显示宽高比（374:449≈0.83:1）不匹配时，可能出现视觉偏移（比如视频自带黑边、像素比例与视图比例差异导致的对齐偏差）。先确认视频文件的实际分辨率和宽高比是否与视图匹配。

2. 改用AutoLayout替代Frame布局 #

手动设置Frame在视图生命周期变化（如旋转、布局更新）时易出现异常，建议用AutoLayout约束，并监听视图 bounds 变化同步更新playerLayer：

func addPlayerLayer(){
    guard let videoPath = Bundle.main.path(forResource: "scan_animation", ofType: "mp4")
    else {
        print ("ERROR path for video not found")
        return
    }
    let videoView = UIView()
    videoView.translatesAutoresizingMaskIntoConstraints = false
    holderView.addSubview(videoView)
    
    // 绑定videoView与holderView的约束
    NSLayoutConstraint.activate([
        videoView.leadingAnchor.constraint(equalTo: holderView.leadingAnchor),
        videoView.trailingAnchor.constraint(equalTo: holderView.trailingAnchor),
        videoView.topAnchor.constraint(equalTo: holderView.topAnchor),
        videoView.bottomAnchor.constraint(equalTo: holderView.bottomAnchor)
    ])
    
    let videoURL = URL(fileURLWithPath: videoPath)
    player = AVPlayer(url: videoURL)
    let playerLayer = AVPlayerLayer(player: player)
    playerLayer.videoGravity = .resizeAspect
    videoView.layer.addSublayer(playerLayer)
    
    // 监听videoView边界变化，同步更新playerLayer的frame
    videoView.layer.addObserver(self, forKeyPath: "bounds", options: [.new], context: nil)
}

// 移除观察者
deinit {
    holderView.subviews.first?.layer.removeObserver(self, forKeyPath: "bounds")
}

// 观察者回调，更新playerLayer
override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    if keyPath == "bounds", let layer = object as? CALayer {
        playerLayer?.frame = layer.bounds
    }
}

3. 显式设置contentsGravity对齐 #

如果上述方法无效，可尝试设置CALayer的contentsGravity属性强制居中对齐：

playerLayer.contentsGravity = .center

注：contentsGravity是CALayer基础属性，控制内容对齐；videoGravity是AVPlayerLayer专属属性，控制视频缩放逻辑，两者可配合使用。

4. 用Debug View Hierarchy排查布局 #

打开Xcode的Debug View Hierarchy功能，直观查看holderView、videoView、playerLayer的层级布局，确认是否存在隐藏的约束冲突或布局偏移。

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