API

PlayCanvas React 提供声明式组件 API，分为核心组件、引擎组件和 hooks。

核心

• <Application/>：初始化引擎和渲染上下文的根组件。
• <Entity/>：具有位置、旋转和缩放的场景图基础节点。
• <Gltf/>：加载并实例化 GLB／GLTF 场景。
• <Modify.*>：声明式修改导入 GLB 中的实体和组件。

组件

将组件嵌套在 Entity 内，可添加相应引擎行为。

• <Anim/>：状态动画。
• <Align/>：对齐辅助。
• <Camera/>：摄像机和视口。
• <Collision/>：物理碰撞形状。
• <Element/>：文本、图像或组界面。
• <Environment/>：环境和天空盒。
• <GSplat/>：高斯泼溅渲染。
• <Light/>：平行光、点光和聚光灯。
• <Render/>：图元或资源网格渲染。
• <Rigidbody/>：物理刚体。
• <Screen/>：屏幕或世界空间界面。
• <Script/>：自定义脚本。

Hooks

Hooks 将 React 与引擎生命周期集成，用法与建议详见概览。

• useApp：访问 Application。
• useParent：从上下文取得父实体。
• useAsset：加载资源。
• useAppEvent：订阅应用事件。
• useMaterial：创建和管理材质。
• usePhysics：访问物理上下文和状态。