SuperAPI AI 工具集

arkit-rendering-context-providers

智能体与模型

查看项目

更新于 10-16 06:08

技能介绍

用途

该技能用于在 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 实体或渲染状态时。

使用方式

工作流如下:

  1. 检查提供者支持情况与所需授权。
  2. 决定渲染管线如何消费提供者输出。
  3. 只运行当前渲染信号所需的提供者。
  4. 观察更新序列,并将最新的渲染上下文存入渲染代码可消费的模型对象中。

约束(Guardrails):

  • 除非这是预期的用户体验,否则不要呈现 visual-fidelity coaching。
  • 将自定义立体渲染决策与 SwiftUI 布局代码隔离。
  • 把环境光照视为渲染的输入,而不是替代手写材质或 Shader Graph 工作。

输出期望:

  • 所选的渲染上下文提供者
  • 使用了哪些提供者参考
  • 支持、授权和 beta API 的注意事项
  • 应用如何消费提供者输出

另外:这些提供者应作为渲染输入保留,除非任务同时使用空间提供者,否则不要将它们与 anchor 所有权混用。RealityKit 组件或材质的实现细节应路由到 $realitykit-visionos-developer 或 $shadergraph-editor。

适用场景

适用于 visionOS 27 上的 ARKit 渲染上下文相关开发与调试,尤其是需要环境光照估计、自定义立体渲染输入或设备适配与注视点视场数据的场景。

限制

关于该技能的收费、价格、运行平台、实际渲染效果等事实,资料中暂未提供。