使用指南
资产 / 骨骼 / Skeleton节点
资产 / 骨骼 / Skeleton 节点手册，包含 13 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
读取和验证 Cocos 资产对象，把图片、音频、材质、Prefab 等资源接入工作流逻辑。
覆盖范围
- 节点数量：13
- 分类路径：资产 / 骨骼 / Skeleton
典型使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
通用注意事项
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 按索引获取绑定姿势 | skeletonGetBindposeByIndex | 2 / 1 | 立即继续 |
| 按索引获取反向绑定姿势 | skeletonGetInverseBindposeByIndex | 2 / 1 | 立即继续 |
| 按索引获取关节路径 | skeletonGetJointPathByIndex | 2 / 1 | 立即继续 |
| 骨骼是否有效？ | skeletonValidate | 1 / 1 | 立即继续 |
| 获取绑定姿势列表 | skeletonGetBindposes | 1 / 1 | 立即继续 |
| 获取绑定姿势数量 | skeletonGetBindposeCount | 1 / 1 | 立即继续 |
| 获取反向绑定姿势列表 | skeletonGetInverseBindposes | 1 / 1 | 立即继续 |
| 获取反向绑定姿势数量 | skeletonGetInverseBindposeCount | 1 / 1 | 立即继续 |
| 获取骨骼哈希 | skeletonGetHash | 1 / 1 | 立即继续 |
| 获取关节路径列表 | skeletonGetJoints | 1 / 1 | 立即继续 |
| 获取关节数量 | skeletonGetJointCount | 1 / 1 | 立即继续 |
| 获取所有属性 | skeletonGetProperties | 1 / 8 | 立即继续 |
| 新建骨骼资产 | skeletonCreate | 1 / 2 | 立即继续 |
按索引获取绑定姿势
根据给定的索引，从骨骼资产的 bindposes 数组中读取对应的绑定姿势矩阵（Mat4）。 若索引越界，返回 null。索引从 0 开始。可配合 获取绑定姿势数量 节点先拿到数组长度再决定索引范围。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetBindposeByIndex |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
index | 索引 | 数据 | number | 索引 要查询的元素在 bindposes 数组中的索引（从 0 开始）。越界时返回空值。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bindpose | 绑定姿势矩阵 | 数据 | cc.Asset / Mat4 | 绑定姿势矩阵 指定索引处的绑定姿势矩阵；越界时为 null。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
按索引获取反向绑定姿势
根据给定的索引，从骨骼资产的 inverseBindposes 数组中读取对应的反向绑定姿势矩阵（Mat4）。 若索引越界，返回 null。首次访问会触发引擎的懒计算（对对应 bindpose 求逆）。索引从 0 开始。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetInverseBindposeByIndex |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
index | 索引 | 数据 | number | 索引 要查询的元素在 inverseBindposes 数组中的索引（从 0 开始）。越界时返回空值。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
inverseBindpose | 反向绑定姿势矩阵 | 数据 | cc.Asset / Mat4 | 反向绑定姿势矩阵 指定索引处的反向绑定姿势矩阵（引擎懒计算得出）；越界时为 null。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
按索引获取关节路径
根据给定的索引，从骨骼资产的 joints 数组中读取对应的关节路径字符串。 若索引越界，返回空字符串。索引从 0 开始。可配合 获取关节数量 节点先拿到数组长度再决定索引范围。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetJointPathByIndex |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
index | 索引 | 数据 | number | 索引 要查询的元素在 joints 数组中的索引（从 0 开始）。越界时返回空值。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
jointPath | 关节路径 | 数据 | string | 关节路径 指定索引处的关节路径字符串（相对于 skinningRoot）；越界时为空字符串。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
骨骼是否有效？
检查骨骼资产是否有效。 当关节（joints）和绑定姿势（bindposes）均非空时返回 true，否则返回 false。通过 新建骨骼资产 构造的空实例会返回 false。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonValidate |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isValid | 是否有效 | 数据 | boolean | 是否有效 true：joints 与 bindposes 均非空；false：骨骼数据不完整（空实例或数据未加载）。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取绑定姿势列表
读取骨骼资产中全部关节的绑定姿势矩阵数组（bindposes: Mat4[]）。 绑定姿势矩阵描述了关节在初始绑定状态下的局部变换，数组长度与 joints 始终相同，按索引一一对应。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetBindposes |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bindposes | 绑定姿势列表 | 数据 | cc.Asset / array / Mat4 | 绑定姿势矩阵列表 骨骼资产中全部关节的绑定姿势矩阵，顺序与 joints 一一对应。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取绑定姿势数量
读取骨骼资产中的绑定姿势数量，即 bindposes.length。 与 joints.length 始终保持相同。可先读取数量再确定按索引查询的范围。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetBindposeCount |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bindposeCount | 绑定姿势数量 | 数据 | number | 绑定姿势数量 骨骼资产中绑定姿势矩阵的总数（bindposes.length），始终与 joints.length 相同。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取反向绑定姿势列表
读取骨骼资产中全部关节的反向绑定姿势矩阵数组（inverseBindposes: Mat4[]）。 注意：这些矩阵是引擎基于 bindposes 懒计算得到的反向绑定姿势矩阵（对 bindposes 逐项求逆），首次访问时按需计算，返回的是当前资产实例上的实时派生值，游戏运行时不做深拷贝。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetInverseBindposes |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
inverseBindposes | 反向绑定姿势列表 | 数据 | cc.Asset / array / Mat4 | 反向绑定姿势矩阵列表 引擎基于 bindposes 懒计算得到，为当前资产实例上的实时派生值，不做深拷贝。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取反向绑定姿势数量
读取骨骼资产中的反向绑定姿势数量，即 inverseBindposes.length。 与 joints.length 始终保持相同。访问此属性会触发引擎的懒计算。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetInverseBindposeCount |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
inverseBindposeCount | 反向绑定姿势数量 | 数据 | number | 反向绑定姿势数量 inverseBindposes.length，与 joints.length 相同。访问会触发引擎懒计算。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取骨骼哈希
读取骨骼资产的哈希值（hash: number）。 该值由引擎基于 bindposes 数据离线计算并缓存；首次访问若未缓存则实时计算。可用于快速比对两份骨骼资产是否结构相同。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetHash |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
hash | 哈希值 | 数据 | number | 骨骼哈希值 由引擎基于 bindposes 计算得出的整数哈希，可用于快速比对骨骼结构是否相同。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取关节路径列表
读取骨骼资产中全部关节的路径字符串数组（joints: string[]）。 每个字符串是关节相对于 SkinnedMeshRenderer.skinningRoot 的节点路径，通常用于定位骨骼层级而不是作为显示名称。数组长度与 bindposes 始终相同。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetJoints |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
joints | 关节路径列表 | 数据 | string / array | 关节路径列表 骨骼资产中全部关节相对于 skinningRoot 的节点路径字符串，顺序与 bindposes 一一对应。通常用于定位骨骼层级，不是显示名称。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取关节数量
读取骨骼资产中的关节数量，即 joints.length。 与 bindposes.length 和 inverseBindposes.length 始终保持相同。可先读取数量再确定按索引查询的范围。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetJointCount |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
jointCount | 关节数量 | 数据 | number | 关节数量 骨骼资产中关节的总数（joints.length），始终与 bindposes.length 相同。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取所有属性
一次性读出骨骼资产的全部已节点化属性：
- joints：关节路径字符串数组
- jointCount：关节数量
- bindposes：绑定姿势矩阵数组
- bindposeCount：绑定姿势数量
- inverseBindposes：反向绑定姿势矩阵数组（懒计算）
- inverseBindposeCount：反向绑定姿势数量
- hash：骨骼哈希值
- isValid：是否有效 适合需要同时取用多项信息的场景，等同于分别连接多个单字段读取节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonGetProperties |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 骨骼资产 这里需要连接一个已经加载好的 Skeleton 实例。 该端口没有”选择骨骼资产”按钮，请先使用以下方式获取 Skeleton 实例： - 加载资产：把”类型”选为 SKELETON，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 Skeleton。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
joints | 关节路径列表 | 数据 | string / array | 关节路径列表 骨骼资产中全部关节的路径字符串。 | - | 可选 |
jointCount | 关节数量 | 数据 | number | 关节数量 joints.length，与 bindposes.length 相同。 | - | 可选 |
bindposes | 绑定姿势列表 | 数据 | cc.Asset / array / Mat4 | 绑定姿势矩阵列表 骨骼资产中全部关节的绑定姿势矩阵。 | - | 可选 |
bindposeCount | 绑定姿势数量 | 数据 | number | 绑定姿势数量 bindposes.length，与 joints.length 相同。 | - | 可选 |
inverseBindposes | 反向绑定姿势列表 | 数据 | cc.Asset / array / Mat4 | 反向绑定姿势矩阵列表 首次访问时由引擎懒计算得出，为实时派生值。 | - | 可选 |
inverseBindposeCount | 反向绑定姿势数量 | 数据 | number | 反向绑定姿势数量 inverseBindposes.length，访问会触发引擎懒计算。 | - | 可选 |
hash | 哈希值 | 数据 | number | 骨骼哈希值 由引擎基于 bindposes 计算得出的整数哈希。 | - | 可选 |
isValid | 是否有效 | 数据 | boolean | 是否有效 true：joints 与 bindposes 均非空；false：骨骼数据不完整。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
新建骨骼资产
在游戏运行时创建一个全新的空骨骼资产实例，不包含关节路径与绑定姿势数据。 通常用于程序化占位或测试。若只是加载已有骨骼资产，请改用 加载资产（类型选 SKELETON）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | skeletonCreate |
| 分类 | 资产 |
| 二级分类 | 骨骼 |
| 分组 | Skeleton |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
skeleton | 骨骼资产 | 数据 | cc.Asset / Skeleton | Skeleton 实例 新建的空骨骼资产实例。连接到后续节点使用。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。