学习目标
访问 Cocos Creator 组件的属性、方法和事件,把引擎能力转成可视化工作流。
覆盖范围
- 节点数量:6
- 分类路径:Cocos 组件 / 杂项 / SubContextView
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制,页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|
| 获取全部属性 | subContextViewGetProperties | 1 / 2 | 立即继续 |
| 获取设计分辨率 | subContextViewGetDesignResolutionSize | 1 / 1 | 立即继续 |
| 获取帧率 | subContextViewGetFps | 1 / 1 | 立即继续 |
| 设置全部属性 | subContextViewSetProperties | 3 / 2 | 立即继续 |
| 设置帧率 | subContextViewSetFps | 3 / 2 | 立即继续 |
| 刷新子域视图 | subContextViewUpdate | 3 / 2 | 立即继续 |
获取全部属性
一次性读取子域视图属性:聚合读取设计分辨率(只读)和帧率。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | subContextViewGetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | SubContextView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
subContextView | 子域视图 | 数据 | cc.Component / SubContextView | 目标 SubContextView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
designResolutionSize | 设计分辨率 | 数据 | size | 子域设计分辨率(只读) | - | 可选 |
fps | 帧率 | 数据 | number | 当前帧率(共享画布贴图更新频率) | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。
获取设计分辨率
获取子域设计分辨率:读取子域视图当前的设计分辨率(宽高)。
注意:该属性仅在游戏运行时只读,请在编辑器中配置。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | subContextViewGetDesignResolutionSize |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | SubContextView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
subContextView | 子域视图 | 数据 | cc.Component / SubContextView | 目标 SubContextView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
designResolutionSize | 设计分辨率 | 数据 | size | 子域设计分辨率(只读,游戏运行时禁止修改) | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。
获取帧率
获取子域帧率:读取子域视图当前的更新帧率。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | subContextViewGetFps |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | SubContextView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
subContextView | 子域视图 | 数据 | cc.Component / SubContextView | 目标 SubContextView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
fps | 帧率 | 数据 | number | 当前帧率(共享画布贴图更新频率) | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。
设置全部属性
批量修改子域视图可写属性:当前仅包含帧率(fps)。
说明:除执行流与子域视图组件引脚外,所有可写属性引脚默认不公开,只有被显式公开的属性才参与写入。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | subContextViewSetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | SubContextView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
subContextView | 子域视图 | 数据 | cc.Component / SubContextView | 目标 SubContextView 组件 | - | 必填 |
fps | 帧率 | 数据 | number | 目标帧率(共享画布贴图更新频率) | 输入框 默认值:60 | 可选 默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
subContextView | 子域视图 | 数据 | cc.Component / SubContextView | 透传 SubContextView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。
设置帧率
设置子域帧率:配置子域视图的更新帧率,用于性能调优。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | subContextViewSetFps |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | SubContextView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
subContextView | 子域视图 | 数据 | cc.Component / SubContextView | 目标 SubContextView 组件 | - | 必填 |
fps | 帧率 | 数据 | number | 目标帧率(共享画布贴图更新频率) | 输入框 默认值:60 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
subContextView | 子域视图 | 数据 | cc.Component / SubContextView | 透传 SubContextView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。
刷新子域视图
手动刷新子域视图:立即刷新子域的显示内容。
不传帧间隔时立即刷新;传值时则根据帧间隔逻辑判断是否需要刷新。
节点信息
| 字段 | 值 |
|---|
| 节点 ID | subContextViewUpdate |
| 分类 | Cocos 组件 |
| 二级分类 | 杂项 |
| 分组 | SubContextView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
exe | 执行 | 执行流 | 执行流 | 执行触发 | - | 必填 |
subContextView | 子域视图 | 数据 | cc.Component / SubContextView | 目标 SubContextView 组件 | - | 必填 |
deltaTime | 帧间隔 | 数据 | number | 帧间隔时间(秒)。不公开时立即刷新;公开并传值时按帧推进逻辑判断是否更新共享贴图。 | 输入框 默认值:0 | 可选 默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|
out | 完成 | 执行流 | 执行流 | 执行完成 | - | 可选 |
subContextView | 子域视图 | 数据 | cc.Component / SubContextView | 透传 SubContextView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。