iOS画中画（AVSampleBufferDisplayLayer）向前快进失效问题排查

针对你遇到的画中画快进按钮禁用、后退/播放暂停功能正常的问题，从以下几个方向排查：

• 必须实现当前播放时间的代理方法
  画中画系统需要明确当前播放进度，才能判断是否还有剩余时长支持快进。如果未实现AVPictureInPictureSampleBufferPlaybackDelegate的pictureInPictureController(_:currentTimeForPlayback:)方法，系统会无法识别播放状态，直接禁用快进按钮。
  示例实现：

  func pictureInPictureController(_ pictureInPictureController: AVPictureInPictureController, currentTimeForPlayback: CMTime) -> CMTime {
      let currentSeconds = player.state.currentTime
      return CMTimeMakeWithSeconds(currentSeconds, preferredTimescale: 10_000)
  }
  

  注意返回的CMTime的timescale要和你在pictureInPictureControllerTimeRangeForPlayback中使用的保持一致（此处为10000）。

• 验证播放时间范围的有效性
  检查player.state.duration的实际值：

  • 打印duration确认是否等于音频的真实总时长，若为0或异常值，系统会判定播放已结束，快进按钮自然禁用。
  • 确保构造的CMTimeRange合法：start为kCMTimeZero，duration为正数且匹配真实时长，避免因时间单位不匹配导致的范围计算错误。

• 同步SampleBuffer层与音频的播放时间
  你使用AVSampleBufferDisplayLayer承载图片，需确保该层的时间与音频播放进度完全同步：

  • 播放过程中要正确更新displayLayer的currentTime，或通过传入的CMSampleBuffer时间戳驱动层的时间进度，防止系统因层时间与音频时间不一致，误判播放状态。

• 检查快进相关的代理权限
  如果你实现了pictureInPictureController(_:shouldSkipForwardToTime:)方法，必须在可快进的场景返回true：

  func pictureInPictureController(_ pictureInPictureController: AVPictureInPictureController, shouldSkipForwardToTime skipToTime: CMTime) -> Bool {
      let currentSeconds = player.state.currentTime
      return currentSeconds < player.state.duration
  }
  

  若未实现该方法，系统默认允许快进，但一旦实现就必须正确返回权限状态。

• 测试播放中途的快进状态
  当音频播放接近结尾时，快进按钮禁用是系统默认行为。测试播放到总时长中间位置时，快进按钮是否可用：

  • 若此时可用，说明是播放位置上报的问题；若仍禁用，回到前面的步骤排查时间范围、代理方法的实现。

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