realitykit-visionos-developer

RealityKit visionOS 开发者

快速开始

1. 将请求归类为核心场景设置、渲染／材质、动画／物理、音频、自定义 ECS、USD 创作、Spatial Preview、SwiftUI UI、ARKit 提供程序相关工作，或构建／调试基础工作。
2. 对于 RealityView 设置、实体加载、组件选择、输入、附件、锚定、门户、同步以及本地 USDStageComponent 桥接，请继续使用此技能。
3. 如果任务主要涉及视觉效果、动画、物理、音频或自定义 ECS 行为，请切换到相应的 RealityKit 专项技能。
4. 仅加载任务所需的少量参考文件。
5. 将所有场景变更限制在有文档说明的 RealityKit 入口中：RealityView 内容／更新闭包、事件处理程序或已注册的系统。

RealityKit 路由

任务	使用
通用 RealityKit 问题分类、组件选择、实体加载、输入、附件、锚定、门户、同步、本地 USDStage 桥接	此技能
网格显示、材质、摄像机、灯光、阴影、后期处理、Gaussian splats、贴花、LOD、遮挡、光照贴图、探针	realitykit-rendering-materials
动画片段、角色控制器、骨骼姿势、IK、身体追踪、重定向、导航、行为树、碰撞、物理、关节、力、粒子、布料	realitykit-animation-physics
空间音频、环境音频或声道音频、音频库、混音组、混响、声学模拟	realitykit-audio-spatial
自定义组件、系统、ECS 查询、注册、更新顺序、逐帧多实体行为	realitykit-ecs-systems
Mac 应用通过 Spatial Preview 向 Vision Pro 流式传输文档或实时 USD 场景	spatial-preview-developer
Swift USDKit 场景／图层／基元 API	usdkit-runtime-developer
已创作的 USD 编辑或命令行 USD 检查	usd-editor
在 USDA 中编辑 ShaderGraph 或 RealityKit 材质图	shadergraph-editor
ARKitSession 提供程序、权限及直接锚点流协调	arkit-visionos-developer
SwiftUI 布局、装饰元素、窗口、沉浸空间或定向手势的人体工学	spatial-swiftui-developer
构建、启动、模拟器／设备日志或运行时调试	build-run-debug

加载参考资料的时机

参考资料	使用时机
references/component-selection.md	在文档介绍的 RealityKit 组件、SwiftUI 定向手势、SpatialTrackingSession、ARKit、专门的 RealityKit 技能和自定义 ECS 工作之间进行选择。
references/component-index.md	查找组件类别，以及接下来要打开的所属技能或参考资料。
references/entity-loading-and-stored-entities.md	加载命名的已存储实体、明确指定的文件 URL、包内资源、USD/USDZ、.reality 或 Reality Composer Pro 输出。
references/inputtargetcomponent.md	让实体能够进行命中测试和接收输入。必要时结合 realitykit-animation-physics 中的碰撞详情。
references/manipulationcomponent.md	编写自定义变换栈之前，先使用内置的直接操控功能。
references/gesturecomponent.md	将 SwiftUI 手势直接附加到 RealityKit 实体。
references/hovereffectcomponent.md 和 references/accessibilitycomponent.md	为交互实体添加悬停提示或无障碍元数据。
references/viewattachmentcomponent.md	在实体图中嵌入由 SwiftUI 驱动的视图。
references/presentationcomponent.md、references/textcomponent.md、references/imagepresentationcomponent.md、references/videoplayercomponent.md	在 RealityKit 中呈现文本、图像、视频或演示风格的内容。
references/anchoringcomponent.md、references/arkitanchorcomponent.md、references/spatialtrackingsession.md	将内容锚定到空间目标，或判断 RealityKit 管理的追踪是否足够。
references/sceneunderstandingcomponent.md、references/dockingregioncomponent.md、references/referencecomponent.md、references/attachedtransformcomponent.md	处理空间参考、停靠、场景理解或变换附加。
references/portalcomponent.md、references/portalcrossingcomponent.md、references/worldcomponent.md、references/environmentblendingcomponent.md、references/portal-volumes-and-accessory-anchoring.md	组合门户、世界、环境混合，以及 visionOS 27 新增的门户／配件锚定行为。
references/synchronizationcomponent.md、references/transientcomponent.md	为多用户／会话行为同步或标记实体状态。
references/usdstagecomponent.md	在 RealityKit 中渲染实时 USDKit 舞台，或将实体层级导出为 USD。若要使用 Swift 编写 USDKit 舞台，请切换到 usdkit-runtime-developer；若要进行 Spatial Preview 流式传输，请切换到 spatial-preview-developer。

防护措施

• 使用 RealityView；visionOS 上不提供 ARView。
• 异步加载资源，避免阻塞主 actor。
• 保持 SwiftUI body 代码声明式；通过 RealityView、事件或系统修改 RealityKit 内容。
• 优先使用有文档说明的组件，再考虑自定义 ECS。
• 在应用启动期间、加载依赖这些组件或系统的场景 或资源之前，只注册一次自定义组件和系统。
• 如果内置直接操作满足需求，优先使用 ManipulationComponent.configureEntity(...)。
• 仅从 macOS 27 发送端应用使用 SpatialPreview；Vision Pro 使用 内置系统查看器，且没有 visionOS SpatialPreview 模块。

输出要求

请提供：

• RealityKit 任务类别
• 使用了哪些专门技能或参考资料
• 选择的组件、附着内容、实体加载或系统路径
• 主要限制或注意事项
• 如有需要，说明如何转回 SwiftUI、ARKit、USD、Spatial Preview 或构建调试