推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 2D 碰撞组件 添加碰撞组件 目前引擎支持三种不同的碰撞组件： 盒碰撞组件（BoxCollider2D）、圆形碰撞组件（CircleCollider2D） 和 多边形碰撞组件（PolygonCollider2D）。在 属性检查器 上点击 添加组件 按钮，输入碰撞组件的名称即可添加。 属性 不同的碰撞组件都拥有以下的共同属性： 属性说明Editing是否对碰撞组件进行编辑。勾选后可以在场景内编辑碰撞组件的位置、样式和大小。详情请参考下方 编辑碰撞组件Tag标签。当发生碰撞后，可根据 Tag 区分不同碰撞组件Group碰撞组件分组。通过 碰撞矩阵 可设置不同分组间碰撞的可能性Sensor指明碰撞组件是否为传感器类型，传感器类型的碰撞组件会产生碰撞回调，但是不会发生物理碰撞效果Density碰撞组件的密度，用于刚体的质量计算Friction碰撞组件摩擦力系数，碰撞组件接触时的运动会受到摩擦力影响Restitution碰撞组件的弹性系数，指明碰撞组件碰撞时是否会受到弹力影响Offset碰撞组件相

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 2D 刚体 刚体是组成物理世界的基本对象，可以将刚体想象成一个你不能看到（绘制）也不能摸到（碰撞）的且不能变形的物体。 由于 Builtin 2D 物理系统只带有碰撞检测的功能，所以刚体对于 Builtin 2D 物理系统是不生效的，本篇设置只对 Box 2D 物理系统产生作用。 添加刚体 点击 属性检查器 的 添加组件 按钮，输入 Rigidbody2D 即可以添加 2D 刚体组件。 属性说明 属性说明Group刚体的分组。通过 碰撞矩阵 可设置不同分组间碰撞的可能性EnabledContactListener开启监听碰撞回调Bullet这个刚体是否是一个快速移动的刚体，并且需要禁止穿过其他快速移动的刚体 请参考 Rigidbody2D API 获取更多信息Type刚体类型，详情请参考下方 刚体类型AlllowSleep是否允许刚体休眠 物理配置 中可调整休眠的临界值GravityScale重力缩放比例 仅对

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 AudioSource 组件参考 AudioSource 组件用于控制音乐和音效的播放。 在 层级管理器 中选中节点，然后点击 属性检查器 下方的 添加组件 按钮，选择 Audio -> AudioSource 即可添加 AudioSource 组件到节点上。 AudioSource 属性 属性说明Clip添加的用于播放的 音频资源，默认为空，点击后面的箭头按钮即可选择Loop是否循环播放PlayOnAwake是否在游戏运行（组件激活）时自动播放音频Volume音量大小，范围在 0~1 之间 音频播放 Cocos Creator 3.x 使用 AudioSource 控制音频的播放。AudioSource 是组件，可以添加到场景中，由 编辑器 设置，也可以在

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 动画图变体 如果两个动画图他们的动画逻辑相同但对应的动画剪辑不同，重新制作一个动画图会带来额外的维护负担。通过使用动画图变体，可以更好的解决此问题。 动画图变体是一种资源，在 资源管理器 内右键创建一个新的动画图变体资源： 创建后的变体如下图所示： 属性 属性说明Animation Graph需要变体的动画图，通过下拉或者从 资源管理器 内选择 Clip Overrides需要覆盖的动画剪辑 通过右侧 Overrides 列，从 资源管理器 内选择需要替换的动画剪辑 使用变体 在 Animation Controller 组件上下拉其 Animation Graph 属性即可选择不同的变体。 由3D建模学习工作室 翻译整理，转载请注明出处！ 上一篇：Cocos Creator：动画遮罩资源 (mvrlink.com) 下一篇：Cocos Creator：udioSource 组件参考

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 动画遮罩资源 动画遮罩是一种资源（Asset），用在动画图层级中，用于屏蔽指定骨骼上的动画效果。 常见的应用场景如上下半身分开播放动画，假如要制作一个在射击时行走的动画，可以通过动画遮罩对射击动画的上半身和行走动画的下半身进行混合来实现。 创建 在 资源管理器 点击左上方的 + 按钮，然后选择 动画遮罩（Animation Mask）： 即可创建一个默认名为 Animation Mask 的动画遮罩资源： 编辑遮罩 在 资源管理器 中选中动画遮罩资源后，可在 属性检查器 中对动画遮罩资源进行编辑。 骨骼导入 在一切开始前，需要确定选择骨骼遮罩影响的所有骨骼。 在 属性检查器 上，点击 按钮，在弹出的预制体选择对话框中，我们选择骨骼层次所在的预制体。一般情况下，我们选择目标模型所在模型文件（FBX、glTF）中导入的预制体，且通常只有一个。 选定后，预制体中所包含的所有骨骼将列入到骨骼遮罩资源中：

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 状态过渡 过渡 代表着两个状态之间的转换，根据过渡发生源头的不同，我们可以将其分为： 普通过渡：过渡发生的源头为伪状态 入口 或者 子状态机。 动画过渡：过渡发生的源头为 状态 或者伪状态 任意。与普通过渡相比，动画过渡还可以控制过渡周期使得动画进行平滑切换。 创建过渡 在网格布局区域中右键选中作为过渡源头的状态，然后选择 添加过渡，当鼠标离开当前状态，会产生一条箭头，此时选中作为过渡目标的状态，即可在两者之间产生过渡： 两个状态之间允许存在多个同向/反向过渡，有几个同向/反向过渡便会在箭头上标相应的数字，配置项也都会展示在 属性查看器 中。 当状态上存在多条同时满足的过渡时，将优先使用排在过渡列表上方的过渡。但 Creator 并不建议依赖这种优先级排序，最好尽可能地使用下文中介绍的 过滤条件 来过滤过渡。 状态也允许过渡到自身： 设置过渡 在网格布局区域选中过渡后，属性检查器 可设置过渡的相关触发条件，包括

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 动画状态机 我们把对象所处的播放某种特定动画的动作，例如待机、移动、奔跑、攻击等，称为 状态。 一般情况下，一个对象拥有多个状态，并按照一定的逻辑顺序在状态之间切换，以执行不同的动作，这种切换在动画图中称为 过渡。发生过渡时需要满足的条件称为 过渡条件。 而动画状态机则是用于管理和控制对象上各个状态及状态之间的过渡，类似于流程图，我们可以直接在 动画图面板 中对其进行可视化编辑。目前一个动画图包含一个状态机，当状态机位于动画图中的某个状态时，便会播放该状态对应的动画。那么按照事先搭建好的动画流程图，通过状态机便可自动控制骨骼动画的播放和切换等。 状态基础 状态机中的状态除了用于控制动画播放的状态，还包括了 入口、出口、任意、子状态机 这几个特殊的状态，因为其本身并不承载动画，只是为了标志状态机开始、结束等特殊用途，因此为了与状态区分我们暂且称之为“伪状态”。 子状态机 是嵌套在状态机中的，用于降解复杂的动画逻辑，具体可查看下文 子状态机 部分的内容。一般我们将动画图最上层的状态机称为

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 动画图层级 动画图可以有多个层级，层级之间同时运行，其上播放的动画效果可以根据层级的配置进行混合。 创建层级 在动画图中点击 层级（Layers） 按钮，点击 按钮，在弹出的输入框内输入层级的名字即可创建层级。 删除层级 鼠标悬停在层级上后，可以点击层级右侧的 × 进行删除，此操作仅在有多个层级时生效。 重命名层级 在层级名字处双击鼠标左键可对层级进行重命名： 层级属性 在动画图层级中选中任意层级后，在 属性查看器 内可以查看层级属性。 属性说明Mask动画遮罩，用于指定对应的 动画遮罩资源Weight层级权重，用于指定当前层级在和 先前层级 混合时的权重，取值范围为 [0, 1] 动画遮罩 从 资源管理器 拖拽动画遮罩到动画图窗口的 遮罩（Mask） 属性或者在层级中选中 遮罩（Mask） 属性都可以将遮罩赋予该层级。 操作步骤可参考下图，按照 1，

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 动画图面板 动画图面板用于查看和编辑动画图资源。当准备好对象所需的骨骼动画后，便可在 动画图面板 中将其组装结合成完整的动画流程。 打开面板 在 资源管理器 中选中动画图资源，然后在 属性检查器 中点击 编辑： 即可打开动画图面板，可以看到动画图面板主要由网格布局区域，以及右侧的 层级、变量 分页构成： 层级（Layers） 该分页主要用于创建、查看和编辑动画图的层级，每个层级分别由一个状态机控制，点击 Layers 按钮可以进入层级编辑状态。 更多关于层级的信息请参考 动画图层级。 网格布局区域 该区域主要展示了 层级 分页中所选的层级对应的状态机，用户可以可视化地创建、编辑、排列状态机中各个状态，以及设置状态之间的过渡。在区域内点击右键即可根据需要创建各类状态： 当编辑完成后可根据需要在右上角点击 保存 或者 重置（重置到上一次保存时）。更多操作请参考 动画状态机。

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 动画控制器（Animation Controller）组件参考 动画控制器组件用于将 动画图资源 应用到对象上。 在 层级管理器 中选中需要应用动画图的节点，然后在 属性检查器 中点击下方的 添加组件 -> Animation -> Animation Controller，即可添加一个动画控制器组件到节点上。 注意：因为 Marionette 动画系统与旧式动画系统不可同时使用，因此 动画控制器组件也不能和动画组件或者骨骼动画组件挂载在同一个节点上。 属性 属性说明Graph添加的 动画图资源，默认为空 程序化控制动画图 动画控制器组件提供了一些方法用于在运行时控制动画图的 动画状态机： 方法说明getVariables获取所有的变量及变量名/类型/值等相关信息。setValue设置变量的值。getValue获取变量的值。getCurrentStateStatus获取当前状态的信息。getCurrentClipStatuses获取当前的动画剪辑的状态。getCurrentTran

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 动画图资源 动画图资源用于存储对象的整个动画流程数据，通过状态机描述动画的流程，目前一个动画图只支持一个状态机。 创建 在 资源管理器 点击左上方的 + 按钮，然后选择 动画图（Animation Graph）： 即可创建一个默认名为 Animation Graph 的动画图资源： 编辑 动画图创建完成后即可在动画图面板中进行编辑，详情请参考 动画图面板。 应用 动画图资源需要依赖于 动画控制器（Animation Controller）组件 才能应用到对象上。 参考 动画控制器组件 文档，在节点上添加动画控制器组件，然后点击动画控制器组件的 Graph 属性框后面的箭头图标按钮选择动画图资源： 或者直接将 资源管理器 中的动画图资源拖拽到动画控制器组件的 Graph 属性框中即可： 由3D建模学习工作室 翻译整理，转载请注明出处！ 上一篇：Cocos Creator：

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 嵌入播放器（实验性功能） 嵌入播放器的作用是允许在动画剪辑的制作时，可以同时绑定粒子特效或其他动画等，用于满足在播放动画同时播放动效的功能。可以用于实现挥动武器会出现刀光，或者脚踩在地面上会出现烟尘等功能。 在动画窗口展开 播放器轨道列表 即可观察整个嵌套系统： 注意：在 v3.6 中，该功能为实验性功能，开发者需要在 偏好设置 -> 实验室中 启用。 有任何的使用体验问题或者建议，欢迎在 论坛 反馈给我们。 轨道操作 嵌入播放器支持 动画播放器 以及 粒子播放器。 在 动画轨道列表 的右侧点击 + 按钮即可添加不同的轨道： 在添加后的轨道上点击鼠标右键可以 移除播放器轨道 和 清除数据。 注意：清空数据操作会清空整个轨道上的内容。 在轨道数据上点击鼠标右键可以下选择 复制 和 删除 操作。 删除操作仅删除当前选中的数据。

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 变形动画（Morph） 1 变形动画是一种通过对模型顶点进行变形，从而实现动画效果的技术。通常在处理角色面部表情变化时，会使用变形动画。 资源导入 通常变形动画由外部工具（3DMax、Blender、Maya 等）制作，并导入引擎使用。导入方式请参考 模型资源 - 模型导入。 接口和说明 如要使用变形动画，请确保导入的资源拥有中变形动画数据。这些数据存储在网格数据中，可通过下列代码获取： const meshRenderer = this.node.getComponent(MeshRenderer)!; const morph = meshRenderer.mesh.struct.morph; 如果要改变变形动画的状态，可通过 setWeight 可以修改动画的权重。代码示例如下： const meshRenderer = this.node.getComponent(

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 骨骼贴图布局设置 要确保 骨骼动画 也能够完全正确地参与 动态 Instancing，需要用户手动指定每张骨骼贴图的数据分配方式。 比如一个场景中要绘制大量相同的人物角色，每个角色可能在走/跳/攻击。如果希望一个 Drawcall 就能够正确完成所有角色的绘制，一个重要的前提条件是 这三个动画（走、跳、攻击）的数据都储存在同一张骨骼贴图内。 目前在默认的 预烘焙骨骼动画模式 下，骨骼贴图已经做到全局自动复用，但每张贴图的大小和它们各储存哪些动画是不可预知的。如果不做任何处理直接开启蒙皮模型的 instancing 的话，最终的运行时效果可能会出现有的动画效果正确，有的动画效果完全错乱，并且完全无法预测。 为此打开 项目设置 找到 骨骼贴图布局设置 分页，用于手动指定每张骨骼贴图中要存储哪些骨骼的哪些动画信息。 注意：骨骼贴图布局设置面板提供的，本质上是运行时的 内存分配指导规则。对于指定的骨骼和动画资源，会保证按照指定规则分配。但如果运行时用到了并未指定规则的资源，还是会回到全局复用的自动分

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 添加动画事件 通过在动画时间轴的指定帧调用 动画事件 函数可以更好地充实动画剪辑。在动画时间轴某一帧上添加 事件帧 后，动画系统将会在动画执行到该帧时，根据事件帧中设置的触发函数名称去匹配动画根节点中对应的函数方法并执行。 若要通过脚本添加动画事件，详情请参考 帧事件。 添加事件帧 在 动画编辑器 中添加事件帧包括以下两种方式： 1. 将时间控制线拖动到需要添加事件帧的位置，然后点击 菜单工具栏 中的 按钮，即可在 动画时间轴 上方添加事件帧。 1. 在动画时间轴上方区域点击右键，然后选择 新建事件帧 即可。 事件帧添加完成后，将鼠标移动到事件帧，颜色会从白色变成黄色。右键点击事件帧即可执行 编辑、删除、复制粘贴 等操作。同时也支持批量操作事件帧，在按住 Ctrl 的同时点击多个事件帧即可。 * 编辑：用于打开事件编辑器，添加事件函数 * 删除：

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 编辑动画剪辑 在节点的动画组件上挂载了动画剪辑后，点击 进入动画编辑模式 或者使用快捷键 Ctrl/Cmd + E 进入动画编辑模式，便可以在动画剪辑中添加关键帧数据，以此实现节点的动画化。在编辑动画剪辑之前请先 熟悉动画编辑器。 一个动画剪辑内可能包含了多个节点（节点及其子节点），每个节点上可挂载多个动画属性。通过对节点进行移动、旋转、缩放等操作，便会在当前选中节点相对应的动画属性上添加关键帧，动画属性上添加的所有关键帧在对应的动画属性中显示为线性轨迹的清单模式，我们可以称之为动画曲线。 创建动画曲线 在添加关键帧之前需要先了解一下动画属性，动画属性包括了节点自有的 position、rotation、scale 等属性，也包含了组件 Component 中自定义的属性。组件包含的属性前会加上组件的名字，比如 cc.Sprite.spriteFrame。 点击 属性列表 区域右上角的 + 按钮即可根据需要添加动画属性，根据节点类型的不同，可添加的动画属性也有所不同。已添加的动画属性则为置

推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 熟悉动画编辑器 动画编辑器 面板用于编辑和预览当前所选节点的动画剪辑。编辑动画数据或者相关属性时，鼠标焦点离开后会立即生效。 Cocos Creator 的默认布局中已经包含了 动画编辑器，也可以通过点击编辑器上方主菜单的 面板 -> 动画 -> 动画编辑器 打开 动画编辑器。 面板介绍 动画编辑器 面板可以划分为以下几个主要部分： 1. 菜单工具栏：放置一些常用的功能按钮，例如播放/暂停/停止动画、添加事件帧、保存动画、退出编辑等。 2. 节点列表：用于显示/设置当前选中节点及其子节点。 3. 动画时间轴与关键帧预览：用于显示/设置当前节点（及其子节点）添加的事件帧以及所添加的动画属性上所有关键帧的预览。 4. 动画属性列表：用于显示/设置当前选中的节点在当前编辑的动画剪辑中包含的所有动画属性。 5. 动画属性关键帧预览：用于显示/