Skip to content

物件节点

物体节点通常是和Cocos产生关联的节点,用于操作Cocos中的对象属性

动画

骨骼动画

控制Spine骨骼动画的播放,包括切换皮肤、播放动画、设置循环等。

输入:

  • 物体:Spine类型的物体节点
  • 播放:触发播放动画的事件

输出:

  • 结束:动画播放结束时触发的事件
  • 点击:物体被点击时触发的事件

属性:

  • 更新模式:选择"全设置"、"仅设置皮肤"或"仅设置动画"
  • 选择皮肤:要切换的皮肤名称
  • 选择动画:要播放的动画名称
  • 是否循环:动画是否循环播放
  • 播放速率:动画播放的速度倍数(0-10)
  • 是否自动播放:启动时是否自动播放
  • 点击等待动画结束:是否等待动画结束后才能点击
  • 柔和过度:切换动画时是否使用柔和过渡效果
  • 取消其他触摸事件:播放时是否取消其他触摸事件
  • 动画结束后响应点击:是否在动画结束后才响应点击
  • 结束触发次数:动画结束事件触发的次数
  • 点击重播动画:点击时是否重新播放动画
  • 点击时间间隔:两次点击之间的最小时间间隔(秒)
  • 可点击时显示描边:可点击时是否显示描边提示
  • 是否可点击:物体是否可以响应点击
  • 触摸提示:关联的触摸提示节点
  • 触摸提示只出现一次:触摸提示是否只显示一次
  • 关联动画音频:是否监听动画中的音频事件
  • 音效:播放时播放的音效

说明:

  • 节点会自动从连接的物体获取可用的皮肤和动画列表
  • 如果物体只有一个动画,可以点击"创建点击彩蛋交互"自动创建交互逻辑
  • 支持预览动画功能

数值动画

控制物体属性的数值变化动画,如位置、缩放、透明度等。

输入:

  • 物体:要动画的物体节点
  • 播放:触发播放动画的事件

输出:

  • 结束:动画播放结束时触发的事件
  • 点击:物体被点击时触发的事件

属性:

  • 动画时长:动画持续的时间(秒)
  • 延迟播放时间:延迟多久后开始播放(秒)
  • 缓动效果:动画的缓动类型(无、淡入、淡出、淡入淡出、回弹、弹跳)
  • 动画模式:选择"变化目标值"或"变化多少值"
    • 变化目标值:将属性变化到指定的目标值
    • 变化多少值:在现有值基础上增加或减少指定值
  • 无动画直接修改值:是否不使用动画,直接修改值
  • 取消其他触摸事件:播放时是否取消其他触摸事件
  • 打断其它数值动画:是否停止物体上正在播放的其他数值动画
  • 是否自动播放:启动时是否自动播放
  • 坐标-x/y:目标x/y坐标或变化量
  • 缩放-x/y:目标缩放值或变化量
  • 透明度:目标透明度值或变化量(0-255)
  • 角度:目标角度值或变化量(度)
  • 锚点x/y:目标锚点值或变化量(-1到1)
  • 宽度/高度:目标尺寸或变化量
  • 物体颜色:目标颜色值
  • 镜头缩放:镜头缩放比例(仅对镜头节点有效)

说明:

  • 可以点击"同步目标物体属性"将物体的当前属性同步到动画节点
  • 可以点击"重置变化多少值"将所有变化量重置为0
  • 支持预览动画功能

路径动画

控制物体沿着贝塞尔曲线路径移动。

输入:

  • 物体:要移动的物体节点
  • 长度:移动的长度(动画模式为"随长度"时使用)
  • 播放:触发播放动画的事件
  • 重置位置:重置物体到起始位置的事件

输出:

  • 结束:动画播放结束时触发的事件

属性:

  • 曲线控制点:贝塞尔曲线的控制点坐标数组
  • 选择控制点:当前选中的控制点索引(-1表示不选中)
  • 起始位置:路径上的起始位置(0-1)
  • 终点位置:路径上的终点位置(0-1)
  • 动画模式:选择"随步长"、"随时间"或"随长度"
    • 随步长:每次输入根据步长增加移动位置的百分比
    • 随时间:输入后自动根据时间从起始位置运行到终点位置
    • 随长度:根据输入的数值移动对应长度
  • 动画时长:动画持续的时间(秒,仅"随时间"模式)
  • 动画步长:每次移动的步长(仅"随步长"模式)
  • 角度跟随路径:移动时物体角度是否跟随路径方向
  • 开始运行时重置:开始运行时是否重置到起始位置
  • 是否自动播放:启动时是否自动播放

说明:

  • 可以添加、删除控制点来编辑曲线
  • 支持预览动画功能
  • 曲线长度会自动计算

物体成组

连接零件

将一个物体设置为另一个物体的子物体,实现父子关系。

输入:

  • 关联父物体:作为父物体的节点
  • 关联子物体:作为子物体的节点(可动态添加多个)

说明:

  • 子物体会跟随父物体移动、旋转、缩放
  • 可以连接多个子物体到一个父物体
  • 断开连接时,子物体会自动回到根节点

传感器

接触感应器

检测两个物体是否发生碰撞接触。

说明: 需要配合物体的碰撞框设置使用,当两个物体的碰撞框重叠时触发。

位置感应器

检测物体是否到达指定位置。

说明: 可以检测物体的x、y坐标是否在指定范围内。

属性感应器

检测物体的某个属性是否满足条件。

说明: 可以检测物体的透明度、缩放、角度等属性是否达到指定值。

物体

创建和管理Cocos Creator中的物体节点。

输出:

  • 物体:创建的物体节点(类型为codeNode)

属性:

  • 是否作为UI:是否将物体作为UI元素
  • 物体类型:选择物体类型(空物体、图片、文本、spine等)
  • 资源:物体使用的资源路径
  • 加载时机:选择"初始化时"或"输入时"
  • 是否预乘:是否使用预乘Alpha
  • 层级:物体的zIndex层级
  • 以y轴动态计算层级:是否根据y坐标自动计算层级
  • 坐标-x/y:物体的位置坐标
  • 缩放-x/y:物体的缩放比例
  • 透明度:物体的透明度(0-255)
  • 角度:物体的旋转角度(度)
  • 锚点x/y:物体的锚点位置(-1到1)
  • 宽度/高度:物体的尺寸
  • 物体颜色:物体的颜色(十六进制)
  • 文本:文本内容(仅文本类型)
  • 描边宽度:文本描边宽度(仅文本类型)
  • 描边颜色:文本描边颜色(仅文本类型)

说明:

  • 物体节点包含一个特殊的codeNode输出接口,需要与接受codeNode输入的节点连接
  • 如果没有连接codeNode输出,相关节点可能无法响应触摸事件或获取实体对象
  • 可以右键点击节点选择"编辑碰撞框"来设置碰撞检测区域
  • 节点会根据资源类型自动显示预览图

字幕组

快速创建和管理绘本中的浮动字幕。

输入:

  • 物体:作为字幕容器的物体节点

输出:

  • 列表:字幕文本列表(数组)

属性:

  • 用作底部字幕:是否作为页面底部的通用字幕
  • 竖向文本:文本是否竖向排列
  • 排列:文本的对齐方式(居左/下、居中、居右/上)
  • 首行缩进:首行的缩进距离
  • 行距:行与行之间的间距
  • 字号:字体大小
  • 颜色:文字颜色
  • 描边宽度:文字描边宽度
  • 描边颜色:文字描边颜色
  • 运行前隐藏:是否在运行前隐藏字幕
  • 运行结束隐藏:是否在运行结束后隐藏字幕
  • 隐藏底层文字:是否隐藏底层的基础文字
  • 是否颜色过渡:是否使用颜色过渡动画
  • 过渡颜色:颜色过渡的目标颜色

说明:

  • 可以点击"添加一行"和"删除一行"来管理字幕行数
  • 每行字幕可以单独设置文本内容
  • 支持自动识别音频生成字幕(需要配置讯飞接口)

镜头

在绘本中使用镜头位移和缩放效果。

输出:

  • 物体:镜头节点(类型为codeNode)

属性:

  • 坐标-x/y:镜头的位置坐标
  • 镜头缩放:镜头的缩放比例(1-10)

说明:

  • 镜头节点会创建一个Camera组件
  • 可以控制整个场景的视角和缩放
  • 支持预览模式显示镜头范围
  • 可以点击"重置到默认状态"恢复初始设置

整体移动

用于在开发时整体移动所有物体,方便调整布局。

属性:

  • 坐标-x:所有物体x坐标的变化量
  • 坐标-y:所有物体y坐标的变化量

说明:

  • 修改坐标值后,所有物体节点会同步移动相同的距离
  • 主要用于开发阶段的快速布局调整

分镜预览缩放

用于在开发时分镜预览缩放,以便看清超出屏幕范围的物体。

属性:

  • 位移x:预览区域的x轴偏移
  • 位移y:预览区域的y轴偏移
  • 缩放:预览区域的缩放比例(0.25-1)

说明:

  • 仅影响编辑器的预览显示,不影响实际运行效果
  • 可以调整预览区域的位置和缩放,方便查看大场景
  • 可以点击"重置到默认状态"恢复初始设置