关于 visionos-immersive-media-developer
面向 visionOS 开发者的沉浸式媒体播放技能，帮助按媒体类型选择 AVKit 或 RealityKit 播放方案，并处理场景切换、播放事件和舒适度问题。
主要功能
- 01选择播放架构
- 02按媒体类型选择观看模式
- 03处理场景与模式切换
- 04利用播放事件驱动界面和渲染
- 05规划舒适度缓解措施
适用场景
- 01选择窗口、门户或沉浸式播放
- 02构建自定义 RealityKit 视频界面
- 03管理观看模式之间的切换
- 04响应播放就绪状态与舒适度问题
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/visionos-immersive-media-developer确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/apmp-and-spatial-video.mdapple-immersive-video-authoring.mdavexperiencecontroller.mdavkit-visionos-playback.mdcomfort-mitigation.mdimmersive-viewing-modes.mdplayback-decision-tree.mdvideo-player-events.mdvideoplayercomponent-basics.md详细介绍
visionOS 沉浸式媒体开发者
快速入门
首先确定应用应使用系统 AVKit 体验，还是自定义 RealityKit 播放界面。
- 明确媒体类型：表面视频、入口、渐进式沉浸、完全沉浸、空间视频或 Apple Immersive Video。
- 仅加载匹配的参考文件。
- 将播放模式变更同时视为媒体和场景编排工作。
何时加载参考资料
| 参考资料 | 使用时机 |
|---|---|
playback-decision-tree.md | 用于确定播放方式的决策树：窗口、入口、渐进式播放还是完全沉浸式播放。 |
avkit-visionos-playback.md | 使用 AVKit AVPlayerViewController 和 AVExperienceController 作为系统播放界面时。 |
avexperiencecontroller.md | 当 AVKit AVExperienceController 是适合产品的播放界面时。 |
videoplayercomponent-basics.md | 需要正确设置 VideoPlayerComponent + AVPlayer 时。 |
video-player-events.md | RealityKit 视频播放需要通过 VideoPlayerEvents 驱动 UI、场景转换、渲染就绪状态或舒适度缓解措施时。 |
apmp-and-spatial-video.md | 内容为空间视频、APMP 或 Apple Immersive Video 时。 |
immersive-viewing-modes.md | 实现入口、渐进式或完全沉浸模式及相关场景转换时。 |
comfort-mitigation.md | 处理舒适度违规情况和缓解策略时。 |
apple-immersive-video-authoring.md | 需要 Apple Immersive Video 制作或打包参考资料时。 |
工作流
- 选择播放架构。
- 加载适用于该播放界面和媒体类型的参考资料。
- 实现播放和观看模式转换。
- 在适用情况下添加事件处理和舒适度缓解措施。
- 总结播放路径、转换模型以及剩余的验证工作。
注意事项
- 如果系统播放器体验符合产品需求，请从 AVKit
AVExperienceController入手。 - 如果视频必须位于自定义场景图中，请使用 RealityKit
VideoPlayerComponent。 - 如果应用还需要进行场景变更，请勿将沉浸模式转换视为简单的属性切换。
- 确保用户有清晰的退出沉浸式播放的方式。
输出要求
请提供：
- 所选的播放架构
- 媒体类型和观看模式
- 使用了哪些参考资料
- 涉及的转换或事件模型
- 下一步验证工作
评论
支持 Markdown