用途
该技能用于在 visionOS 27 上构建和调试 ARKit 的渲染上下文提供者(rendering-context providers)。涉及三个提供者:
- EnvironmentLightEstimationProvider(环境光照估计)
- StereoPropertiesProvider(立体属性)
- VisualFidelityProvider(视觉保真度)
其核心目的是帮助开发者判断当前的渲染问题究竟需要光照数据、立体现点属性,还是视觉保真度/设备适配数据,并据此选择正确的提供者。
主要能力
- 区分渲染问题类型,定位对应的提供者。
- 加载共享的 ARKit 会话指引,然后只加载匹配的提供者参考。
- 提供按需加载的参考文档清单:
- session-basics.md:用于设置 ARKitSession、授权、事件或拆除时。
- environment-light-estimation-provider.md:用于 EnvironmentLightEstimationProvider 和环境探针时。
- stereo-properties-provider.md:用于 StereoPropertiesProvider 提供自定义立体渲染输入时。
- visual-fidelity-provider.md:用于 VisualFidelityProvider 获取设备适配状态或注视点视场时。
- realitykit-bridge.md:当提供者输出需要驱动 RealityKit 实体或渲染状态时。
使用方式
工作流如下:
- 检查提供者支持情况与所需授权。
- 决定渲染管线如何消费提供者输出。
- 只运行当前渲染信号所需的提供者。
- 观察更新序列,并将最新的渲染上下文存入渲染代码可消费的模型对象中。
约束(Guardrails):
- 除非这是预期的用户体验,否则不要呈现 visual-fidelity coaching。
- 将自定义立体渲染决策与 SwiftUI 布局代码隔离。
- 把环境光照视为渲染的输入,而不是替代手写材质或 Shader Graph 工作。
输出期望:
- 所选的渲染上下文提供者
- 使用了哪些提供者参考
- 支持、授权和 beta API 的注意事项
- 应用如何消费提供者输出
另外:这些提供者应作为渲染输入保留,除非任务同时使用空间提供者,否则不要将它们与 anchor 所有权混用。RealityKit 组件或材质的实现细节应路由到 $realitykit-visionos-developer 或 $shadergraph-editor。
适用场景
适用于 visionOS 27 上的 ARKit 渲染上下文相关开发与调试,尤其是需要环境光照估计、自定义立体渲染输入或设备适配与注视点视场数据的场景。
限制
关于该技能的收费、价格、运行平台、实际渲染效果等事实,资料中暂未提供。