SKVideoNode无法播放本地视频求助：无报错但视频不显示

我之前也碰到过类似的情况，明明代码看起来没问题，就是看不到画面，给你列几个最可能的排查点，一步步来：

• 确认视频文件是否真的被打包进App Bundle
  这是最容易踩的坑！有时候拖文件到项目里，没勾选对应的target，导致文件根本没进app。检查步骤：

  1. 在Xcode中选中你的项目文件
  2. 切换到「Targets」-> 你的App名称
  3. 进入「Build Phases」标签，找到「Copy Bundle Resources」
  4. 看看列表里有没有「Clouds.mov」，没有的话直接把文件拖进去就行。

• 检查视频尺寸与场景的适配
  你给videoNode设置了固定的1920×1080尺寸，如果你的SKScene本身尺寸远小于这个值（比如iPhone SE的320×568），视频可能完全超出屏幕范围，看起来就是“没显示”。可以先改成和场景匹配的尺寸试试：

  videoNode?.size = frame.size // 直接用场景的尺寸
  // 或者用scale方法缩放
  videoNode?.scale(to: frame.size)
  

• 验证AVPlayer的加载状态
  有时候视频加载失败（比如编码不支持、文件损坏），但不会直接报错，只是不显示画面。给AVPlayer加个状态观察者，看看具体情况：
  首先在创建player的时候添加观察者：

  let player = AVPlayer(playerItem: item)
  player.addObserver(self, forKeyPath: "status", options: [.new, .initial], context: nil)
  

  然后实现观察者方法：

  override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
      guard keyPath == "status", let player = object as? AVPlayer else {
          super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
          return
      }
      
      switch player.status {
      case .readyToPlay:
          print("视频准备就绪，可以播放")
          videoNode?.play() // 这里再调用play更稳妥
      case .failed:
          print("视频加载失败：\(player.error?.localizedDescription ?? "未知错误")")
      case .unknown:
          print("视频状态未知，正在加载中")
      @unknown default:
          break
      }
  }
  

  注意：记得在deinit里移除观察者，避免内存泄漏：

  deinit {
      videoNode?.avPlayer?.removeObserver(self, forKeyPath: "status")
  }
  

• 简化层级，排除父节点问题
  先把videoNode直接添加到当前Scene，而不是worldNode，看看能不能显示：

  // 替换原来的worldNode.addChild(videoNode!)
  addChild(videoNode!)
  

  如果这样能显示，说明问题出在worldNode上——比如它的position不对、z层级被覆盖、或者size为0，需要检查worldNode的配置。

• 优化URL获取方式
  用Bundle.main.url(forResource:withExtension:)代替path转URL的方式，更可靠，避免路径字符串编码问题：

  var videoNode: SKVideoNode? = {
      guard let url = Bundle.main.url(forResource: "Clouds", withExtension: "mov") else {
          print("找不到视频文件")
          return nil
      }
      let item = AVPlayerItem(url: url)
      let player = AVPlayer(playerItem: item)
      return SKVideoNode(avPlayer: player)
  }()
  

按上面的步骤一步步排查，应该能找到问题所在！

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