AppleTV本地捆绑视频真机无法播放，模拟器正常，Swift技术求助

嘿，我之前在tvOS开发中也踩过类似的坑，结合你的场景，给你几个实用的排查方向和解决方案：

1. 先确认视频资源真的绑定到Target了 #

这是最容易忽略的细节！把showroom.m4v拖进Xcode后，一定要检查Target Membership：选中视频文件，打开右侧的File Inspector面板，确保你的Apple TV App Target被勾选。模拟器会“宽容”读取未绑定的资源，但真机是严格校验的，没勾选的话肯定找不到文件。

2. 替换成更可靠的Bundle URL获取方式 #

你当前用Bundle.main.path()转URL的方式，不如直接用Bundle.main.url(forResource:withExtension:)稳妥，能避免路径转译时的潜在问题。修改代码试试：

guard let fileURL = Bundle.main.url(forResource: "showroom", withExtension: "m4v") else {
    debugPrint("video not found")
    return
}
playerAsset = AVAsset(url: fileURL)

这个方法直接返回符合Bundle结构的标准URL，比手动转路径靠谱得多。

3. 检查视频编码的兼容性 #

tvOS对视频编码的要求比模拟器严格，哪怕是m4v容器，里面的编码不符合标准也会在真机上播放失败。你需要确认视频是H.264 Baseline/Main/High Profile，Level不超过4.2（Apple TV 4代的支持上限）：

• 可以用QuickTime打开视频，通过「窗口-显示检查器」查看编码信息；
• 如果编码不兼容，用HandBrake转码，直接选择「Apple TV」预设，转出来的视频肯定符合要求。

4. 监听AVPlayerItem状态排查具体错误 #

如果前面的方法都没用，给playerItem加个状态监听，看看具体是什么错误导致播放失败：

playerItem = AVPlayerItem(asset: playerAsset)
// 添加状态监听
playerItem.addObserver(self, forKeyPath: "status", options: [.new], context: nil)

// 实现监听方法
override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    if keyPath == "status", let item = object as? AVPlayerItem {
        switch item.status {
        case .failed:
            debugPrint("播放失败：\(item.error?.localizedDescription ?? "未知错误")")
        case .readyToPlay:
            debugPrint("视频准备就绪")
        case .unknown:
            debugPrint("视频状态未知")
        @unknown default:
            break
        }
    }
}

通过错误信息就能精准定位是资源找不到、解码失败还是其他问题。

5. 检查App Sandbox设置 #

虽然tvOS的Sandbox限制不多，但如果你的App开启了特殊权限，可能影响本地资源访问。去Xcode的「Capabilities」面板，查看App Sandbox设置，确保没有勾选不必要的文件访问限制（本地捆绑资源默认不需要额外权限，但保险起见检查一下）。

先从第1、2点开始排查，这两个是最常见的原因，要是还解决不了，再依次检查编码和监听状态，应该能搞定！

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