用途:实现与调试 RealityKit 渲染、材质、光照、相机、视觉效果、后处理、渲染开销控制、高斯泼溅、贴花等视觉相关问题。
使用方式:先确认问题属于视觉范畴(网格显示、材质指派、相机投影、光照、阴影、后处理、泼溅、贴花、LOD、遮挡、探针),再加载与功能最匹配的窄范围渲染参考文档。ShaderGraph 或 USDA 材质图编辑转交 shadergraph-editor;本地 USD 舞台渲染走 realitykit-visionos-developer,USD 编写走 usd-editor。
参考文件按需加载:modelcomponent.md(渲染网格并指派材质)、modeldebugoptionscomponent.md(检查调试模型渲染输出)、meshinstancescomponent.md(高效复用网格实例)、modelsortgroupcomponent.md(控制透明或分层内容的排序)、opacitycomponent.md(透明度)、adaptiveresolutioncomponent.md(自适应分辨率)、levelofdetailcomponent.md(按距离或细节层级选择内容)、occlusioncullingcomponent.md(减少隐藏内容的渲染开销)、gaussiansplatcomponent.md(高斯泼溅捕捉渲染)、physicallybaseddecalcomponent.md(基于物理的贴花投影)、clippingcomponent.md(按边界裁剪几何体)、tonemappingcomponent.md 与 bloomcomponent.md(色调映射与泛光后处理)、pointlightcomponent.md / directionallightcomponent.md / spotlightcomponent.md(直接光源)、imagebasedlightcomponent.md 与 imagebasedlightreceivercomponent.md(基于图像的照明与接收器)、groundingshadowcomponent.md / dynamiclightshadowcomponent.md / render-layers-and-shadows.md(接地阴影、动态阴影、渲染层与逐光源遮罩)、environmentlightingconfigurationcomponent.md / virtualenvironmentprobecomponent.md / lightmaps-and-probes.md(环境照明、虚拟探针、烘焙光照贴图与漫射探针)、perspectivecameracomponent.md / orthographiccameracomponent.md / projectivetransformcameracomponent.md(相机与投影)。
跨模块路由:实体加载、输入、附件、锚定、传送门、同步及本地 USDStageComponent 交由 realitykit-visionos-developer;视觉问题由动画、混合形状、粒子、布料、碰撞或物理状态引起时交由 realitykit-animation-physics;渲染状态由自定义组件或逐帧系统驱动时交由 realitykit-ecs-systems。
限制与守则:visionOS 27 渲染新增内容按 beta API 处理,发布前需对照已安装 SDK 复核符号;昂贵的材质、网格与纹理加载应保持异步;尽量用截图或模拟器/设备检查验证视觉改动;优先使用有文档的 RealityKit 组件而非自定义绘制或更新逻辑。
输出期望:给出渲染类别、所用的渲染参考文件、选定的组件或资源路径、视觉/性能约束,以及下一步截图、模拟器或设备验证步骤。资料来源未说明具体安装命令、收费方式与平台支持细节。