用途：在 Apple Vision Pro（visionOS 27）上实现沉浸式与空间视频体验，帮助开发者先确定播放架构，再按媒体形态落地。
主要能力：区分系统 AVKit 体验与自定义 RealityKit 播放表面；识别媒体形态（surface video、portal、progressive immersive、full immersive、spatial video、Apple Immersive Video）；处理播放模式切换与场景编排；通过 VideoPlayerEvents 驱动 UI、场景过渡、渲染就绪与舒适度缓解；涉及 APMP、空间视频与 Apple Immersive Video 的打包与创作参考。
使用方式：先决定用系统 AVKit 体验还是自定义 RealityKit 播放表面；明确媒体形态；只加载匹配的参考文件。参考文件包括 playback-decision-tree.md（窗口/portal/progressive/full 决策树）、avkit-visionos-playback.md、avexperiencecontroller.md、videoplayercomponent-basics.md、video-player-events.md、apmp-and-spatial-video.md、immersive-viewing-modes.md、comfort-mitigation.md、apple-immersive-video-authoring.md。工作流为：选择播放架构、加载对应参考、实现播放与观看模式过渡、加入事件处理与舒适度缓解、总结播放路径与过渡模型及待验证项。
适用场景：需要窗口、portal、渐进式或全沉浸播放的 visionOS 应用；使用 AVPlayerViewController 与 AVExperienceController 的系统播放；需要 VideoPlayerComponent + AVPlayer 的自定义场景图；空间视频、APMP 与 Apple Immersive Video 内容。
限制与护栏：系统播放体验合适时优先用 AVKit AVExperienceController；视频需进入自定义场景图时用 RealityKit VideoPlayerComponent；沉浸模式切换若伴随场景变化，不能当作简单属性翻转；必须保证用户有明确的退出沉浸播放路径。具体 API 细节、版本要求与验证步骤以对应参考文件为准，资料未提供完整代码示例与收费信息。