使用指南
Cocos 组件 / 视频 / VideoPlayer节点
Cocos 组件 / 视频 / VideoPlayer 节点手册，包含 42 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：42
- 分类路径：Cocos 组件 / 视频 / VideoPlayer
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 绑定播放错误事件 | videoPlayerErrorBind | 3 / 2 | 立即继续 |
| 绑定播放完毕事件 | videoPlayerCompletedBind | 3 / 2 | 立即继续 |
| 绑定播放中事件 | videoPlayerPlayingBind | 3 / 2 | 立即继续 |
| 绑定视频点击事件 | videoPlayerClickedBind | 3 / 2 | 立即继续 |
| 绑定停止事件 | videoPlayerStoppedBind | 3 / 2 | 立即继续 |
| 绑定元数据加载事件 | videoPlayerMetaLoadedBind | 3 / 2 | 立即继续 |
| 绑定暂停事件 | videoPlayerPausedBind | 3 / 2 | 立即继续 |
| 绑定准备就绪事件 | videoPlayerReadyToPlayBind | 3 / 2 | 立即继续 |
| 播放视频 | videoPlayerPlay | 2 / 2 | 立即继续 |
| 恢复播放 | videoPlayerResume | 2 / 2 | 立即继续 |
| 获取保持宽高比 | videoPlayerGetKeepAspectRatio | 1 / 1 | 立即继续 |
| 获取播放速率 | videoPlayerGetPlaybackRate | 1 / 1 | 立即继续 |
| 获取播放中 | videoPlayerGetIsPlaying | 1 / 1 | 立即继续 |
| 获取播放状态 | videoPlayerGetState | 1 / 1 | 立即继续 |
| 获取当前时间 | videoPlayerGetCurrentTime | 1 / 1 | 立即继续 |
| 获取底层渲染 | videoPlayerGetStayOnBottom | 1 / 1 | 立即继续 |
| 获取唤醒全屏 | videoPlayerGetFullScreenOnAwake | 1 / 1 | 立即继续 |
| 获取唤醒自动播放 | videoPlayerGetPlayOnAwake | 1 / 1 | 立即继续 |
| 获取静音状态 | videoPlayerGetMute | 1 / 1 | 立即继续 |
| 获取全部属性 | videoPlayerGetProperties | 1 / 16 | 立即继续 |
| 获取视频时长 | videoPlayerGetDuration | 1 / 1 | 立即继续 |
| 获取视频资产 | videoPlayerGetClip | 1 / 1 | 立即继续 |
| 获取循环播放 | videoPlayerGetLoop | 1 / 1 | 立即继续 |
| 获取音量 | videoPlayerGetVolume | 1 / 1 | 立即继续 |
| 获取原生视频对象 | videoPlayerGetNativeVideo | 1 / 1 | 立即继续 |
| 获取远程地址 | videoPlayerGetRemoteURL | 1 / 1 | 立即继续 |
| 获取资产来源 | videoPlayerGetResourceType | 1 / 1 | 立即继续 |
| 设置保持宽高比 | videoPlayerSetKeepAspectRatio | 3 / 2 | 立即继续 |
| 设置播放时间 | videoPlayerSetCurrentTime | 3 / 2 | 立即继续 |
| 设置播放速率 | videoPlayerSetPlaybackRate | 3 / 2 | 立即继续 |
| 设置底层渲染 | videoPlayerSetStayOnBottom | 3 / 2 | 立即继续 |
| 设置唤醒全屏 | videoPlayerSetFullScreenOnAwake | 3 / 2 | 立即继续 |
| 设置唤醒自动播放 | videoPlayerSetPlayOnAwake | 3 / 2 | 立即继续 |
| 设置静音 | videoPlayerSetMute | 3 / 2 | 立即继续 |
| 设置全部属性 | videoPlayerSetProperties | 14 / 2 | 立即继续 |
| 设置视频资产 | videoPlayerSetClip | 3 / 2 | 立即继续 |
| 设置循环播放 | videoPlayerSetLoop | 3 / 2 | 立即继续 |
| 设置音量 | videoPlayerSetVolume | 3 / 2 | 立即继续 |
| 设置远程地址 | videoPlayerSetRemoteURL | 3 / 2 | 立即继续 |
| 设置资产来源 | videoPlayerSetResourceType | 3 / 2 | 立即继续 |
| 停止视频 | videoPlayerStop | 2 / 2 | 立即继续 |
| 暂停视频 | videoPlayerPause | 2 / 2 | 立即继续 |
绑定播放错误事件
监听播放错误事件：视频加载或播放过程中出错时触发（如资产找不到、格式不支持等）。可用于显示错误提示或尝试切换视频源。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerErrorBind |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接到事件节点的输出引脚以触发绑定 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
绑定播放完毕事件
监听播放完毕事件：视频自然播放到最后一帧后触发（手动停止不会触发此事件）。可用于在视频播完后播放下一个或退出播放界面。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerCompletedBind |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接到事件节点的输出引脚以触发绑定 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
绑定播放中事件
监听播放中事件：视频开始播放或从暂停恢复时触发。可用于在视频播放时同步更新 UI 或隐藏加载提示。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerPlayingBind |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接到事件节点的输出引脚以触发绑定 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
绑定视频点击事件
监听视频点击事件：当用户点击视频画面时触发。可用于实现点击视频暂停/继续播放等功能。 注意：不是所有平台都支持此事件（Web 端通常可用，iOS/Android 视情况而定）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerClickedBind |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接到事件节点的输出引脚以触发绑定 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
绑定停止事件
监听停止事件：视频播放被停止后触发。可用于重置播放相关的 UI 或状态。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerStoppedBind |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接到事件节点的输出引脚以触发绑定 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
绑定元数据加载事件
监听元数据加载完成事件：当视频的时长、分辨率等基本信息加载完毕时触发，之后可安全读取视频时长等属性。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerMetaLoadedBind |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接到事件节点的输出引脚以触发绑定 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
绑定暂停事件
监听暂停事件：视频被暂停时触发。可用于显示暂停提示或停止与视频同步的相关逻辑。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerPausedBind |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接到事件节点的输出引脚以触发绑定 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
绑定准备就绪事件
监听准备就绪事件：视频资产加载完成，可以开始播放了。在收到此事件后再播放视频，可避免加载延迟。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerReadyToPlayBind |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接到事件节点的输出引脚以触发绑定 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
播放视频
播放视频：如果已在播放，会从头重新播放；如果在暂停状态，会继续播放。建议在视频准备好后（READY_TO_PLAY 事件后）调用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerPlay |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
恢复播放
继续播放视频：只对暂停中的视频有效，非暂停状态下调用可能无效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerResume |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取保持宽高比
获取是否保持宽高比：true 表示视频以原始比例显示（可能出现黑边），false 表示拉伸填满容器。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetKeepAspectRatio |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
keepAspectRatio | 保持宽高比 | 数据 | boolean | 保持宽高比- true：原始比例 - false：拉伸填充 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取播放速率
获取播放速率：1.0 为正常速度，0.5 为半速，2.0 为双倍速，有效范围 0~10。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetPlaybackRate |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
playbackRate | 播放速率 | 数据 | number | 播放速率（有效范围 0~10，1.0 为正常速度） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取播放中
获取是否正在播放：true 表示视频当前处于播放状态，等价于检查播放状态是否为 PLAYING。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetIsPlaying |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isPlaying | 正在播放 | 数据 | boolean | 是否正在播放（等价于 state === PLAYING） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取播放状态
获取当前播放状态：返回 播放状态 枚举值，表示视频当前所处的阶段。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetState |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
state | 播放状态 | 数据 | enum / VideoPlayer.EventType | 播放状态：NONE=未开始，META_LOADED=元数据已就绪，READY_TO_PLAY=可以播放，PLAYING=播放中，PAUSED=已暂停，STOPPED=已停止，COMPLETED=播放完毕，ERROR=出错，CLICKED=被点击 | 下拉选择 默认值：“NONE” | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取当前时间
获取当前播放进度：单位为秒。 在视频元数据加载完成（META_LOADED）后读取更可靠。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetCurrentTime |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
currentTime | 当前时间 | 数据 | number | 当前播放时间（单位：秒） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取底层渲染
获取是否置于底层渲染：在 Web 端，开启后视频会显示在 Canvas 画面下方（需要先将 Canvas 背景设为透明）。原生平台通常不受影响。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetStayOnBottom |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
stayOnBottom | 底层渲染 | 数据 | boolean | 保持底层渲染（主要 Web 平台有效，需透明 Canvas；true=底层渲染，false=正常渲染层级） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取唤醒全屏
获取是否唤醒全屏：true 表示场景加载时视频自动进入全屏模式（各平台支持情况有差异）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetFullScreenOnAwake |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
fullScreenOnAwake | 唤醒全屏 | 数据 | boolean | 唤醒时是否全屏（true=全屏，平台支持有差异） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取唤醒自动播放
获取是否自动播放：检查视频在场景加载时是否会自动开始播放。 开启后，组件加载完成时会自动调用播放；关闭则需要手动触发。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetPlayOnAwake |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
playOnAwake | 唤醒自动播放 | 数据 | boolean | true=唤醒时自动播放；false=需手动触发 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取静音状态
获取静音状态：true 表示静音播放（不改变音量值），false 表示正常出声。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetMute |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
mute | 静音 | 数据 | boolean | 静音状态- true：静音 - false：正常播放声音 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取全部属性
一次性读取 VideoPlayer 所有属性：同时获取全部 16 个属性值，适合需要批量读取时使用，减少节点数量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
resourceType | 资产来源 | 数据 | number | 视频资产来源类型 | - | 可选 |
remoteURL | 远程地址 | 数据 | string | 远程视频地址 | - | 可选 |
clip | 视频资产 | 数据 | cc.Asset / VideoClip | 本地视频资产 | - | 可选 |
playOnAwake | 唤醒自动播放 | 数据 | boolean | 唤醒时是否自动播放 | - | 可选 |
playbackRate | 播放速率 | 数据 | number | 播放速率（0~10） | - | 可选 |
volume | 音量 | 数据 | number | 音量（0~1） | - | 可选 |
mute | 静音 | 数据 | boolean | 是否静音 | - | 可选 |
loop | 循环播放 | 数据 | boolean | 是否循环播放 | - | 可选 |
keepAspectRatio | 保持宽高比 | 数据 | boolean | 是否保持宽高比 | - | 可选 |
fullScreenOnAwake | 唤醒全屏 | 数据 | boolean | 唤醒时是否全屏 | - | 可选 |
stayOnBottom | 底层渲染 | 数据 | boolean | 是否保持底层渲染 | - | 可选 |
nativeVideo | 原生视频对象 | 数据 | object | 底层原生视频对象（高级用途） | - | 可选 |
currentTime | 当前时间 | 数据 | number | 当前播放时间（秒） | - | 可选 |
duration | 视频时长 | 数据 | number | 视频总时长（秒） | - | 可选 |
state | 播放状态 | 数据 | enum / VideoPlayer.EventType | 当前播放状态（播放状态） | - | 可选 |
isPlaying | 正在播放 | 数据 | boolean | 是否正在播放 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取视频时长
获取视频总时长：单位为秒。 需等视频元数据加载完毕（META_LOADED 事件）后才能获得正确值，加载前通常为 0。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetDuration |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
duration | 视频时长 | 数据 | number | 视频总时长（单位：秒，META_LOADED 事件后才有有效值） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取视频资产
获取本地视频资产：读取当前绑定的视频文件（VideoClip）。 仅在来源方式为”本地资产”时有意义；使用远程地址时此值通常为 null。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetClip |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
clip | 视频资产 | 数据 | cc.Asset / VideoClip | 本地视频资产（仅 resourceType=LOCAL 时有效） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取循环播放
获取是否循环播放：true 表示播放完毕后自动从头重播。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetLoop |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
loop | 循环播放 | 数据 | boolean | 循环播放- true：播放完自动重播 - false：播放完停止 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取音量
获取音量：0 为无声，1 为最大音量，有效范围 0~1。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetVolume |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
volume | 音量 | 数据 | number | 音量（有效范围 0~1，0 为静音，1 为最大音量） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取原生视频对象
获取底层原生视频对象：在 Web 端通常返回 HTMLVideoElement，在 iOS/Android 原生端可能为 null。 此功能仅供高级调试场景使用，普通场景无需用到。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetNativeVideo |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
nativeVideo | 原生视频对象 | 数据 | object | Web 平台通常为 HTMLVideoElement；原生平台可能为 null。高级调试/透传专用，不建议直接解构。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取远程地址
获取远程视频地址：读取播放器当前设置的网络视频 URL。 仅在来源方式为”远程地址”时有意义；使用本地视频资产时此值通常为空。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetRemoteURL |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
remoteURL | 远程地址 | 数据 | string | 远程视频地址（仅 resourceType=REMOTE 时有效） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取资产来源
获取视频来源方式：是来自远程网络地址，还是本地视频资产文件？ 切换来源方式后，记得同步设置对应的地址或资产。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerGetResourceType |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
resourceType | 资产来源 | 数据 | number | 视频资产来源：0=远程地址（远程地址），1=本地资产（本地资产） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置保持宽高比
设置是否保持宽高比：开启后视频以原始比例显示（可能出现黑边），关闭则拉伸填满容器。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetKeepAspectRatio |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
keepAspectRatio | 保持宽高比 | 数据 | boolean | 保持宽高比- true：原始比例 - false：拉伸填充 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置播放时间
调整视频播放进度：单位为秒，设置后视频会跳转到该时间点。用于实现视频快进、重播或跳转。 值会自动限制在 0 到总时长之间。建议在视频就绪后再调用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetCurrentTime |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
currentTime | 播放时间 | 数据 | number | 目标时间（秒），自动限制在 0~视频时长；建议在视频就绪后调用 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置播放速率
设置播放速率：1.0 为正常速度，有效范围 0~10。请勿超出平台支持的最大速率。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetPlaybackRate |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
playbackRate | 播放速率 | 数据 | number | 播放速率（有效范围 0~10，1.0 为正常速度） | 输入框 默认值：1 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置底层渲染
设置视频是否置于底层渲染：主要用于 Web 平台，设为 true 后视频显示在 Canvas 下方（需先将 Canvas 设为透明背景）。原生平台通常无效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetStayOnBottom |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
stayOnBottom | 底层渲染 | 数据 | boolean | 保持底层渲染（主要 Web 平台有效，需透明 Canvas；true=底层，false=正常层级） | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置唤醒全屏
设置是否唤醒全屏：开启后场景加载时视频自动进入全屏（各平台支持情况有差异，原生平台更常见）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetFullScreenOnAwake |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
fullScreenOnAwake | 唤醒全屏 | 数据 | boolean | 唤醒时是否全屏（true=全屏，平台支持有差异） | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置唤醒自动播放
设置是否自动播放：开启后场景加载时视频会自动开始播放，关闭则需手动触发。 此设置仅影响下一次场景加载，不影响当前播放状态。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetPlayOnAwake |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
playOnAwake | 唤醒自动播放 | 数据 | boolean | 唤醒时是否自动播放- true：自动播放 - false：手动触发 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置静音
设置静音状态：true 为静音播放（不改变音量值），false 恢复正常出声。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetMute |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
mute | 静音 | 数据 | boolean | 静音状态- true：静音 - false：恢复声音；不影响 volume 属性值 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置全部属性
批量修改 VideoPlayer 属性：一次性设置多个属性。 默认所有属性引脚是隐藏的，需要点击引脚旁的按钮将其公开后才会参与写入。只读属性（原生视频对象、总时长、播放状态、是否播放中）不在此节点中。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
resourceType | 资产来源 | 数据 | number | 视频资产来源类型 | 下拉选择 默认值：1 | 可选 默认隐藏 |
remoteURL | 远程地址 | 数据 | string | 远程视频地址 | 输入框 默认值："" | 可选 默认隐藏 |
clip | 视频资产 | 数据 | cc.Asset / VideoClip | 本地视频资产 | - | 可选 默认隐藏 |
playOnAwake | 唤醒自动播放 | 数据 | boolean | 唤醒时是否自动播放 | 开关 默认值：true | 可选 默认隐藏 |
playbackRate | 播放速率 | 数据 | number | 播放速率（0~10） | 输入框 默认值：1 | 可选 默认隐藏 |
volume | 音量 | 数据 | number | 音量（0~1） | 输入框 默认值：1 | 可选 默认隐藏 |
mute | 静音 | 数据 | boolean | 是否静音 | 开关 默认值：false | 可选 默认隐藏 |
loop | 循环播放 | 数据 | boolean | 是否循环播放 | 开关 默认值：false | 可选 默认隐藏 |
keepAspectRatio | 保持宽高比 | 数据 | boolean | 是否保持宽高比 | 开关 默认值：true | 可选 默认隐藏 |
fullScreenOnAwake | 唤醒全屏 | 数据 | boolean | 唤醒时是否全屏 | 开关 默认值：false | 可选 默认隐藏 |
stayOnBottom | 底层渲染 | 数据 | boolean | 是否保持底层渲染（主要 Web 平台有效，需透明 Canvas） | 开关 默认值：false | 可选 默认隐藏 |
currentTime | 播放时间 | 数据 | number | 目标时间（秒，自动限制在 0~视频时长） | 输入框 默认值：0 | 可选 默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置视频资产
设置本地视频资产：将 VideoClip 资产绑定到播放器。 仅在来源方式为”本地资产”时生效，绑定前请确保 VideoClip 资产已加载完成。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetClip |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
clip | 视频资产 | 数据 | cc.Asset / VideoClip | 本地视频资产（仅 resourceType=LOCAL 时生效） | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置循环播放
设置是否循环播放：开启后视频播放完毕会自动从头重播。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetLoop |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
loop | 循环播放 | 数据 | boolean | 循环播放- true：播放完自动重播 - false：播放完停止 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置音量
设置音量：0 为无声，1 为最大音量，有效范围 0~1。音量和静音是独立控制的，互不影响。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetVolume |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
volume | 音量 | 数据 | number | 音量（有效范围 0~1，0=静音，1=最大） | 输入框 默认值：1 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置远程地址
设置远程视频地址：填入网络视频的完整 URL（需包含 https:// 等协议头）。 仅在来源方式为”远程地址”时生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetRemoteURL |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
remoteURL | 远程地址 | 数据 | string | 远程视频地址（仅 resourceType=REMOTE 时生效，需包含协议头） | 输入框 默认值："" | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置资产来源
设置视频来源方式：选择从远程 URL 还是本地视频资产加载视频。 切换后需要同时设置远程地址（远程）或视频资产（本地），否则可能加载旧内容或无内容。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerSetResourceType |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
resourceType | 资产来源 | 数据 | number | 视频资产来源：0=远程地址（远程地址），1=本地资产（本地资产） | 下拉选择 默认值：1 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
停止视频
停止视频：停止播放并将进度归零（与暂停的区别：暂停保留当前进度，停止则回到起点）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerStop |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
暂停视频
暂停视频：暂停后画面定格在当前帧，可以通过 继续播放 节点恢复。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | videoPlayerPause |
| 分类 | Cocos 组件 |
| 二级分类 | 视频 |
| 分组 | VideoPlayer |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 要操作的视频播放器组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
videoPlayer | 视频播放器 | 数据 | cc.Component / VideoPlayer | 原样传出，方便链式连接 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。