使用指南
资产 / 视频 / VideoClip节点
资产 / 视频 / VideoClip 节点手册，包含 4 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
读取和验证 Cocos 资产对象，把图片、音频、材质、Prefab 等资源接入工作流逻辑。
覆盖范围
- 节点数量：4
- 分类路径：资产 / 视频 / VideoClip
典型使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
通用注意事项
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取视频时长 | videoClipGetDuration | 1 / 1 | 立即继续 |
| 获取所有属性 | videoClipGetProperties | 1 / 2 | 立即继续 |
| 新建视频剪辑 | videoClipCreate | 1 / 2 | 立即继续 |
| 有底层视频源 | videoClipHasNativeSource | 1 / 1 | 立即继续 |
获取视频时长
读取视频资产的总时长，单位为秒。 可用于判断视频长短或与 数值分支 节点配合实现分段逻辑。视频数据尚未就绪时，回退为 0。 注意：此属性读取自引擎内部数据（_nativeAsset，自 v3.5.0 起已标记为弃用），非 VideoClip 的稳定公开 API。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoClipGetDuration |
| 分类 | 资产 |
| 二级分类 | 视频 |
| 分组 | VideoClip |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoClip | 视频剪辑 | 数据 | cc.Asset / VideoClip | VideoClip 视频剪辑 这里需要连接一个已经加载好的 VideoClip 实例。 该端口没有”选择视频”按钮，请先使用以下方式获取视频剪辑实例： - 加载资产：把”类型”选为 VIDEO_CLIP，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 VideoClip。 - 新建视频剪辑：创建一个空视频剪辑实例。 注意：VideoClip 只是视频资产引用，不负责播放控制。播放、暂停、静音、循环等能力属于 VideoPlayer 组件，不属于 VideoClip 资产。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
duration | 时长 | 数据 | number | 时长 视频总时长（秒）；数据未就绪时为 0。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取所有属性
一次性读出视频剪辑的全部常用信息：时长、是否有底层视频源。等同于同时使用 获取视频时长 和 有底层视频源，但只需一个节点。 适合调试、预览、条件判断等场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoClipGetProperties |
| 分类 | 资产 |
| 二级分类 | 视频 |
| 分组 | VideoClip |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoClip | 视频剪辑 | 数据 | cc.Asset / VideoClip | VideoClip 视频剪辑 这里需要连接一个已经加载好的 VideoClip 实例。 该端口没有”选择视频”按钮，请先使用以下方式获取视频剪辑实例： - 加载资产：把”类型”选为 VIDEO_CLIP，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 VideoClip。 - 新建视频剪辑：创建一个空视频剪辑实例。 注意：VideoClip 只是视频资产引用，不负责播放控制。播放、暂停、静音、循环等能力属于 VideoPlayer 组件，不属于 VideoClip 资产。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
duration | 时长 | 数据 | number | 时长 视频总时长（秒）；数据未就绪时为 0。 | - | 可选 |
hasNativeSource | 有视频源 | 数据 | boolean | 有底层视频源 true：已有底层视频句柄；false：视频源不存在或尚未就绪。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
新建视频剪辑
在游戏运行时创建一个全新的空视频剪辑实例。 空实例不可直接播放，适合作为占位引用或配合游戏运行时逻辑动态填充。若要加载已有的视频文件，请使用 加载资产，并把类型选为 VIDEO_CLIP。 注意：VideoClip 只是视频资产引用，播放、暂停等能力属于 VideoPlayer 组件。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoClipCreate |
| 分类 | 资产 |
| 二级分类 | 视频 |
| 分组 | VideoClip |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoClip | 视频剪辑 | 数据 | cc.Asset / VideoClip | VideoClip 实例 新建的空视频剪辑实例，不可直接播放。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
有底层视频源
判断当前 VideoClip 是否已绑定到底层视频源，输出 true 或 false。 true 表示资产内部已有视频句柄可供 VideoPlayer 同步，但实际播放还受组件状态、平台等因素影响。典型用法：在把 VideoClip 传给 VideoPlayer.clip 之前，先确认资产是否具备视频数据。 注意：此属性读取自引擎内部数据（_nativeAsset，自 v3.5.0 起已标记为弃用），非 VideoClip 的稳定公开 API。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoClipHasNativeSource |
| 分类 | 资产 |
| 二级分类 | 视频 |
| 分组 | VideoClip |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoClip | 视频剪辑 | 数据 | cc.Asset / VideoClip | VideoClip 视频剪辑 这里需要连接一个已经加载好的 VideoClip 实例。 该端口没有”选择视频”按钮，请先使用以下方式获取视频剪辑实例： - 加载资产：把”类型”选为 VIDEO_CLIP，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 VideoClip。 - 新建视频剪辑：创建一个空视频剪辑实例。 注意：VideoClip 只是视频资产引用，不负责播放控制。播放、暂停、静音、循环等能力属于 VideoPlayer 组件，不属于 VideoClip 资产。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
hasNativeSource | 有视频源 | 数据 | boolean | 有底层视频源 true：已有底层视频句柄；false：视频源不存在或尚未就绪。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。