Swift应用中Swift-YouTube-Player视频底部截断问题修复求助

这个问题核心是没给播放器设置好保持宽高比+适配父视图边界的Auto Layout约束，导致视频在横竖屏时超出视图范围被截断。下面是具体的解决方法：

方法一：通过Storyboard可视化设置约束 #

1. 选中你的YouTubePlayerView，先添加4个安全区域边缘约束（优先级设为「Required」）：
   • Leading Space to Safe Area
   • Trailing Space to Safe Area
   • Top Space to Safe Area
   • Bottom Space to Safe Area
2. 添加宽高比约束：右键拖动播放器到自身，选择「Aspect Ratio」，在属性面板把比例改成16:9（YouTube视频的标准比例，可按需调整），将这个约束优先级设为「Default High」。

这样设置后，Auto Layout会自动适配：当屏幕比例和16:9匹配时，播放器完全占满安全区域；比例不匹配时，播放器会严格保持宽高比，同时尽量填充可用空间，不会超出边界导致截断。

方法二：通过代码动态设置约束 #

如果你的播放器是纯代码创建，或者需要动态调整约束，可以在viewDidLoad中添加以下代码：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 禁用自动约束转换，确保自定义约束生效
    youtubePlayer.translatesAutoresizingMaskIntoConstraints = false
    
    // 绑定到安全区域边缘，避免被系统元素遮挡
    NSLayoutConstraint.activate([
        youtubePlayer.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor),
        youtubePlayer.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor),
        youtubePlayer.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
        youtubePlayer.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)
    ])
    
    // 添加16:9宽高比约束，优先级设为高，保证比例优先
    let aspectRatioConstraint = youtubePlayer.widthAnchor.constraint(equalTo: youtubePlayer.heightAnchor, multiplier: 16.0/9.0)
    aspectRatioConstraint.priority = .defaultHigh
    aspectRatioConstraint.isActive = true
    
    // 设置内容模式，强制视频保持比例显示
    youtubePlayer.contentMode = .scaleAspectFit
}

额外注意事项 #

• 横竖屏支持：确保控制器允许横竖屏切换，可重写以下属性：

  override var supportedInterfaceOrientations: UIInterfaceOrientationMask {
      return .all // 可按需限制为.portrait或.landscape等
  }
  

• 约束冲突排查：如果问题仍存在，打开Xcode的「Debug View Hierarchy」工具，检查播放器的frame是否超出父视图边界，或是否有约束冲突。

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