SuperAPI AI 工具集

tvos-media-playback-workflow

编程与开发

查看项目

更新于 11-05 18:49

技能介绍

用途

该技能用于指导 tvOS 媒体播放控制契约:以 AVKit 系统播放器为起点,在自定义播放器升级时要求有证据支撑,并将遥控器命令路由、播放器状态与 Now Playing 信息统一归到一个明确的所有者之下管理。它不替代通用 AVFoundation 媒体管线、Core Media 时间处理、音频会话策略或 Xcode 执行流程。

主要能力与适用场景

  • AVPlayerViewController 与系统播放器采用。
  • AVKit 播放 UI、自定义信息标签页、叠加层、内容推荐、HLS 插播、画中画及播放相关的 tvOS 设计。
  • MPRemoteCommandCenter 遥控传输命令、自定义播放器控件、命令启用与 Apple TV 媒体状态归属。
  • 当产品认为需要自定义播放器时,先判断 AVKit 系统播放器是否已满足实际需求。
  • 遥控器/控制器命令验证、播放结束后的焦点恢复、仅设备可用的播放能力门槛。

浏览 UI、焦点布局、遥控优先导航、大字号、TVMLKit 迁移等应转交 tvos-app-experience-workflow;通用资源加载、采集、读写器、导出、转码与播放管线修复应转交 avfoundation-media-pipeline-workflow。

使用方式

流程为单路径工作流:

  1. 对播放请求分类:系统播放器采用、AVKit 扩展或辅助内容、自定义播放器论证、遥控命令或 Now Playing 状态、HLS/插播/连续性特性、运行时验证或修复。
  2. 执行 Apple 文档门槛:阅读当前 AVKit、AVFoundation、MediaPlayer 与发布说明证据;在建议控制路径前说明所依赖的文档化行为;对 Beta API 和设备特定行为做版本限定。
  3. 优先系统播放器:当 AVPlayerViewController 的控件与支持的扩展点满足需求时选用它;选择自定义 UI 前须指出具体不可用的产品行为;自定义路径须负责所有相关遥控命令与媒体状态转换。
  4. 建立唯一媒体控制所有者:播放器生命周期与当前条目、命令启用与 MPRemoteCommandCenter 处理器、MPNowPlayingInfoCenter 状态、中断/条目结束行为与焦点恢复。
  5. 返回一项建议:播放器选择及文档化理由、命令/状态归属、功能与设备门槛、遥控验证矩阵与交接。

可输入的可选参数包括 request(播放任务自由文本)、playback_goal(system-player、custom-player、remote-command、now-playing、hls、interstitial、overlay、proposal、continuity 或 validation)、player_context(当前播放器、UI 定制、媒体类型与命令需求)、target_context(Apple TV 型号、tvOS/Xcode 版本、控制器与物理设备可用性)。默认:始终文档优先、优先 AVPlayerViewController、由一个明确所有者管理播放器状态、命令与 Now Playing 状态。

输出与限制

输出包含 status(success/handoff/blocked)、path_type(primary/fallback)以及 output(解析出的播放器路径、依赖的 Apple 文档化行为、命令与状态归属、能力/Beta 门槛、验证矩阵与交接)。

限制与停止条件:当 AVPlayerViewController 满足产品需求时,不应从自定义播放控件起步;自定义播放器不是外观问题,必须支持适用遥控命令、媒体控制状态、中断/结束行为与焦点返回;不得将 MPRemoteCommandCenter 处理器、播放器状态或 MPNowPlayingInfoCenter 更新分散到无关视图;没有相关运行时证据时,不得声称 HLS、插播、画中画、连续性相机、控制器、遥控或系统媒体控制行为已验证;当请求行为依赖不可用的流、账户、硬件、签名授权或物理设备证据时,以 blocked 停止。

技能包含 references/system-player-and-remote-commands.md 与 references/playback-validation-and-handoffs.md 两份工作流参考。