@aura3d /反应
@aura3d/react 拥有用于安装Aura3D场景的React组件和助手
与键入资产，相机，灯光，效果和产品查看器场景构建器。
公共API
AuraCanvas：挂载的React画布组件createAuraApp,向前 诊断/选项，并在卸载时处理应用程序。Scene：背景、相机、时间轴等的说明性场景包装 诊断选项。Model类型模型节点声明AuraAssetRef<"model">.Camera：轨道，多利，跟随，或透视相机声明。Lights：工作室，环境，方向和点光声明。Effect：雾、花、雨的效果声明。buildSceneFromChildren：将支持的React子节点转换为AuraSceneBuilder.productViewerScene：用于类型资产产品查看器的方便构建器 现场。useAuraApp/AuraAppContext：安装AuraApp(未定义,直到 山)。来检测“canvas外”useAuraApp() !== undefined.useAuraFrame(callback, priority?)：游戏循环优先顺序 扇形分布在一个共享上app.onFrame订阅，在卸载时已清理。AuraCanvas事件道具(onPointerDown/Move/Up，onHover): canvas-level 具有卸载清理功能的DOM侦听器。搭配eventInteractionNodes(target)因此，F4拾取堆栈被占用- DOM处理程序单独不拾取。createAuraAssetResource/useAuraAsset/resourceForDescriptors： 悬架兼容的资产边界preloadAll语义 （每个记录ok/失败的证据；失败抛出到错误边界）。<Model suspendOnLoad fallback>在类型资产预加载时挂起。- Drei-pattern配方（测试片段，而不是深度，也不是奇偶校验）：
cameraControlsRecipe，environmentPresetRecipe，transformGizmoRecipe. R3F_TO_AURA_MIGRATION_TABLE： R3F→auracanva映射的进口商。
状态:实验
在beat-three.js PRD （WP-K.6）中审计。测试内容：场景构建来源
子节点、框架调度程序、资产资源、食谱和迁移表
（tests/unit/react-adapter/的渲染树 AuraCanvas (一个帆布;
子节点在应用提供商内部渲染；声明性节点不添加DOM)。固定
在那次审计中，孩子们经常被解读为场景，但从来没有渲染过，所以
useAuraFrame， useAuraApp 和 <Model suspendOnLoad> 在一个
AuraCanvas 从来没有跑;应用程序会被销毁并重新创建
父类用内联子类、处理程序或内联 onReady.
AuraCanvas 现在只有当建成的场景， diagnostics，
pixelRatio， autoStart 或者 resize 改变。
还没被证实，所以包裹还在 experimental：挂载、处理和监听
在一个真实的浏览器中清理（需要一个远程的剧作家收据），React StrictMode
双挂载和服务器渲染挂载场景。
R3F迁移说明
R3F_TO_AURA_MIGRATION_TABLE 将习惯的R3F映射到覆盖的aurcanvas
表面(画布，网格/模型，灯光，相机，效果， useFrame， useThree，
useLoader/悬念，网格事件，drei轨道控制/环境/
TransformControls)。这是一个映射，而不是一个r3f奇偶声明
（R3F_MIGRATION_NOT_PARITY）. 三公司迁移实验室检测
@react-three/fiber / @react-three/drei 源和点在这里，和
文档CSS2D/CSS3D手动映射(CSS2D_CSS3D_MANUAL_MAP）。
包边
这个包包装了根 @aura3d/engine React应用的公共API。它
不能替换类型化的资产管道：模型道具应该使用生成的
assets.name 引用，而不是原始的GLB url或猜测的资产id。