组件

组件封装可以添加到实体或从实体移除的功能。例如，可以让实体播放声音、渲染三维模型或运行脚本。

可以通过 PlayCanvas 编辑器或引擎 API 为实体添加组件。选中实体后，组件公开的属性会显示在检查器中。

组件检查器

每个组件都显示为检查器中的一个面板，头部包含以下通用控件：

控件	说明
折叠／展开（Collapse/Expand）	单击箭头折叠或展开组件面板。
组件图标（Component Icon）	标识组件类型。
启用开关（Enable Toggle）	启用或禁用组件。禁用的组件不会运行或渲染。
帮助（Help）	打开此组件类型的文档。
操作菜单（Actions Menu）	单击省略号（⋯），访问 Copy、Paste 和 Delete。

组件类型

PlayCanvas 引擎定义了多种组件：

组件	说明
动画状态机（Anim）	指定可在实体层级上运行的状态图与动画。
音频监听器（Audio Listener）	指定三维音频播放的监听位置。
按钮（Button）	创建用户界面按钮。
摄像机（Camera）	从实体所在位置渲染场景。
碰撞（Collision）	为实体指定碰撞体积。
元素（Element）	定义界面文本或图像元素。
高斯泼溅（GSplat）	在实体位置渲染三维高斯泼溅。
关节（Joint）	约束两个刚体，或将刚体约束到世界空间中的一个点。
布局子项（Layout Child）	为单个元素覆盖布局组默认属性。
布局组（Layout Group）	自动设置子界面元素的位置和缩放。
灯光（Light）	为实体附加动态光源。
粒子系统（Particle System）	为实体附加粒子系统。
刚体（Rigid Body）	将实体加入场景物理模拟。
渲染（Render）	渲染基本图形或渲染资源。
屏幕（Screen）	定义用户界面的区域和渲染方式。
脚本（Script）	让实体运行 JavaScript 代码以实现自定义行为。
滚动条（Scrollbar）	为 Scroll View 组件定义滚动控件。
滚动视图（Scroll View）	定义用户界面中的可滚动区域。
声音（Sound）	播放音频资源。
精灵（Sprite）	在实体位置渲染二维图形。

已弃用的组件

PlayCanvas 仍保留一些已弃用组件，不建议在新项目中使用。

组件	说明
Animation（旧版动画）	指定可在实体 Model 组件所引用模型上播放的动画。
Model（旧版模型）	在实体位置渲染三维模型。