Script Graph

使用指南

Cocos 组件 / 杂项 / SubContextView节点

Cocos 组件 / 杂项 / SubContextView 节点手册,包含 6 个节点的用途、引脚、使用场景和注意事项。

16

学习目标

访问 Cocos Creator 组件的属性、方法和事件,把引擎能力转成可视化工作流。

覆盖范围

  • 节点数量:6
  • 分类路径:Cocos 组件 / 杂项 / SubContextView

典型使用场景

  • 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
  • 读取组件状态后驱动游戏逻辑
  • 批量设置组件属性完成游戏运行时效果

通用注意事项

  • 目标组件引脚必须连接正确的组件实例。
  • 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。
  • 部分组件能力受 Cocos Creator 版本限制,页面会标出版本字段。

节点索引

节点节点 ID输入/输出执行方式
获取全部属性subContextViewGetProperties1 / 2立即继续
获取设计分辨率subContextViewGetDesignResolutionSize1 / 1立即继续
获取帧率subContextViewGetFps1 / 1立即继续
设置全部属性subContextViewSetProperties3 / 2立即继续
设置帧率subContextViewSetFps3 / 2立即继续
刷新子域视图subContextViewUpdate3 / 2立即继续

获取全部属性

一次性读取子域视图属性:聚合读取设计分辨率(只读)和帧率。

节点信息

字段
节点 IDsubContextViewGetProperties
分类Cocos 组件
二级分类杂项
分组SubContextView
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
subContextView子域视图数据cc.Component / SubContextView目标 SubContextView 组件-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
designResolutionSize设计分辨率数据size子域设计分辨率(只读)-可选
fps帧率数据number当前帧率(共享画布贴图更新频率)-可选

使用场景

  • 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
  • 读取组件状态后驱动游戏逻辑
  • 批量设置组件属性完成游戏运行时效果

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 目标组件引脚必须连接正确的组件实例。
  • 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。

获取设计分辨率

获取子域设计分辨率:读取子域视图当前的设计分辨率(宽高)。 注意:该属性仅在游戏运行时只读,请在编辑器中配置。

节点信息

字段
节点 IDsubContextViewGetDesignResolutionSize
分类Cocos 组件
二级分类杂项
分组SubContextView
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
subContextView子域视图数据cc.Component / SubContextView目标 SubContextView 组件-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
designResolutionSize设计分辨率数据size子域设计分辨率(只读,游戏运行时禁止修改)-可选

使用场景

  • 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
  • 读取组件状态后驱动游戏逻辑
  • 批量设置组件属性完成游戏运行时效果

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 目标组件引脚必须连接正确的组件实例。
  • 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。

获取帧率

获取子域帧率:读取子域视图当前的更新帧率。

节点信息

字段
节点 IDsubContextViewGetFps
分类Cocos 组件
二级分类杂项
分组SubContextView
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
subContextView子域视图数据cc.Component / SubContextView目标 SubContextView 组件-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
fps帧率数据number当前帧率(共享画布贴图更新频率)-可选

使用场景

  • 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
  • 读取组件状态后驱动游戏逻辑
  • 批量设置组件属性完成游戏运行时效果

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 目标组件引脚必须连接正确的组件实例。
  • 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。

设置全部属性

批量修改子域视图可写属性:当前仅包含帧率(fps)。 说明:除执行流与子域视图组件引脚外,所有可写属性引脚默认不公开,只有被显式公开的属性才参与写入。

节点信息

字段
节点 IDsubContextViewSetProperties
分类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。
  • 目标组件引脚必须连接正确的组件实例。
  • 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。

设置帧率

设置子域帧率:配置子域视图的更新帧率,用于性能调优。

节点信息

字段
节点 IDsubContextViewSetFps
分类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。
  • 目标组件引脚必须连接正确的组件实例。
  • 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。

刷新子域视图

手动刷新子域视图:立即刷新子域的显示内容。 不传帧间隔时立即刷新;传值时则根据帧间隔逻辑判断是否需要刷新。

节点信息

字段
节点 IDsubContextViewUpdate
分类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。
  • 目标组件引脚必须连接正确的组件实例。
  • 设置类节点通常需要接入执行流,才会真正修改游戏运行时状态。