学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：12
- 分类路径：Cocos 组件 / 杂项 / WebView
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|
| 绑定加载失败事件 | webViewErrorBind | 3 / 2 | 立即继续 |
| 绑定加载完成事件 | webViewLoadedBind | 3 / 2 | 立即继续 |
| 绑定加载中事件 | webViewLoadingBind | 3 / 2 | 立即继续 |
| 获取地址 | webViewGetUrl | 1 / 1 | 立即继续 |
| 获取全部属性 | webViewGetProperties | 1 / 3 | 立即继续 |
| 获取原生对象 | webViewGetNativeWebView | 1 / 1 | 立即继续 |
| 获取状态 | webViewGetState | 1 / 1 | 立即继续 |
| 设置 JS Scheme | webViewSetJavascriptInterfaceScheme | 3 / 2 | 立即继续 |
| 设置地址 | webViewSetUrl | 3 / 2 | 立即继续 |
| 设置全部属性 | webViewSetProperties | 3 / 2 | 立即继续 |
| 执行 JS 脚本 | webViewEvaluateJS | 3 / 2 | 立即继续 |
| 注册 JS 回调 | webViewSetOnJSCallback | 4 / 2 | 需要等待结果 |
绑定加载失败事件
绑定 WebView 页面加载失败事件：当页面加载出错时触发（网络不可用、地址错误等）。
典型用途：显示错误提示或重试按钮。
payload 结构依平台而异，不应对具体结构有强依赖。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewErrorBind |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接 执行事件 节点，绑定目标事件 ID | - | 必填 |
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄
用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
绑定加载完成事件
绑定 WebView 页面加载完成事件：当页面加载成功后触发。
典型用途：隐藏加载提示、在页面加载完成后立即执行 JS 脚本。
payload 为触发事件的 WebView 组件实例。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewLoadedBind |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接 执行事件 节点，绑定目标事件 ID | - | 必填 |
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄
用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
绑定加载中事件
绑定 WebView 页面加载中事件：当 WebView 开始加载页面时触发。典型用途：显示加载中的提示动画或进度条。
payload 为触发事件的 WebView 组件实例本身。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewLoadingBind |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接 执行事件 节点，绑定目标事件 ID | - | 必填 |
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄
用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取地址
获取 WebView 当前加载地址：读取 WebView 的 url 属性。
典型用途：判断当前是否在正确的页面，或记录玩家访问的网页地址。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewGetUrl |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
url | 地址 | 数据 | string | 当前加载地址（应包含 http/https 前缀） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取全部属性
一次性读取 WebView 属性：聚合读取 url、state 和 nativeWebView。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewGetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
url | 地址 | 数据 | string | 当前加载地址 | - | 可选 |
state | 状态 | 数据 | enum / WebView.EventType | WebView 加载状态（WebView.EventType 字符串枚举）：NONE/LOADING/LOADED/ERROR | - | 可选 |
nativeWebView | 原生对象 | 数据 | object | 底层原生 WebView 对象（高级用途） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取原生对象
获取底层原生 WebView 对象：Web 平台通常返回 HTMLIFrameElement；原生平台（iOS/Android）可能为 null 或不可直接操作的内部对象。
这是高级调试/透传能力，不建议零基础用户依赖此输出。如需操作原生 WebView，请确认平台与 Cocos 版本兼容性。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewGetNativeWebView |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
nativeWebView | 原生对象 | 数据 | object | Web 平台通常为 HTMLIFrameElement；原生平台可能为 null。高级用户调试/透传专用，不建议在工作流中直接解构。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取状态
获取 WebView 当前加载状态：读取 WebView 的 state 属性（WebViewEventType 枚举值）。
典型用途：页面加载完成后显示加载提示，加载失败时显示重试按钮。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewGetState |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
state | 状态 | 数据 | enum / WebView.EventType | WebView 加载状态（WebView.EventType 字符串枚举）：NONE=无状态，LOADING=加载中，LOADED=加载完成，ERROR=加载出错 | 下拉选择
默认值：“NONE” | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置 JS Scheme
设置 JavaScript 接口协议：配置 WebView 监听的自定义 URL scheme，用于接收原生 JS 回调。
此方法仅 Android/iOS 原生侧有效，Web 端通常不支持。需与 注册 JS 回调 节点配套使用，先设置 scheme，再绑定回调。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewSetJavascriptInterfaceScheme |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
scheme | Scheme | 数据 | string | 自定义 URL scheme（仅原生平台有效，如 “myapp”） | 输入框
默认值："" | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
webView | WebView | 数据 | cc.Component / WebView | 透传 WebView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置地址
设置 WebView 加载地址：写入 url 属性，设置后立即触发页面重新加载。
地址应包含 http/https 前缀。典型用途：跳转到游戏内公告页面、FAQ 帮助页或外部活动链接。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewSetUrl |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
url | 地址 | 数据 | string | 目标加载地址（应包含 http/https 前缀） | 输入框
默认值：“https://cocos.com” | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
webView | WebView | 数据 | cc.Component / WebView | 透传 WebView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置全部属性
批量修改 WebView 可写配置：聚合写入 url（唯一游戏运行时可写字段）。
说明：除 exe 与 webView 外，所有可写属性引脚默认不公开（isPublic: false），只有被显式公开的引脚才参与写入。state 与 nativeWebView 为只读属性，不纳入快捷写入。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewSetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
url | 地址 | 数据 | string | 目标加载地址（应包含 http/https 前缀） | 输入框
默认值：“https://cocos.com” | 可选
默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
webView | WebView | 数据 | cc.Component / WebView | 透传 WebView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
执行 JS 脚本
在页面上下文执行 JavaScript：调用 WebView.evaluateJS() 向当前加载的网页注入并执行脚本字符串。
典型用途：在网页中触发 JS 函数（如通知游戏中心登录成功）、修改页面样式。
注意：跨域限制与页面内容安全策略（CSP）需自行保证。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewEvaluateJS |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
script | 脚本 | 数据 | string | 要执行的 JavaScript 字符串；需保证跨域与 CSP 合规 | 输入框
默认值："" | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
webView | WebView | 数据 | cc.Component / WebView | 透传 WebView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
注册 JS 回调
注册原生 JS 回调（原生平台优先）：在目标 WebView 上注册 JS 回调监听，当原生页面通过约定 scheme 触发回调时，将消息传递到后续节点执行链。
payload 结构为 { webView, message }，其中 message 在原生侧为字符串，在 Web 平台此回调通常不会触发。
注意：此节点执行时建立长期回调监听，而非立即返回数据。开启”自动解绑旧绑定”（默认 true）时，若同一事件 ID 已存在绑定则先解绑再重绑。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | webViewSetOnJSCallback |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | WebView |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
event | 事件 | 事件 | 事件 | 连接 执行事件 节点，绑定目标事件 ID | - | 必填 |
webView | WebView | 数据 | cc.Component / WebView | 目标 WebView 组件 | - | 必填 |
autoUnbindPrevious | 自动解绑旧绑定 | 数据 | boolean | 执行前是否自动解绑同一事件 ID 的旧回调绑定（默认 true） | 开关
默认值：true | 可选
默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄
用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
