对象与内容节点

对象节点用于控制 3D 对象、材质、文字、动画和图表。大多数动作节点都需要 trigger 和目标对象识别码，并在完成后输出 done。

变换与层级

节点	主要输入	作用
Set Object Position	uuid、position [x,y,z]	设置对象位置
Set Object Rotation	uuid、rotation [x,y,z]	设置对象欧拉旋转
Set Object Scale	uuid、scale [x,y,z]	设置对象缩放
Set Object Parent	uuid、parent	将对象放入指定父对象
Set Object Visible	uuid、visible	显示或隐藏对象

位置和缩放使用三维数组。旋转通常使用弧度；例如约 1.57 表示 90°。

Control Object Rotation

控制对象持续旋转。

输入/属性	说明
uuid	目标对象
axis	旋转轴 [x,y,z]
stepAngle	每步角度
speed	旋转速度
action	start、pause、stop 或 reset

适合产品转台、设备运转和循环演示。离开页面或切换状态前应设计停止或重置路径。

Set Object Material Color

修改目标对象材质颜色。可以使用颜色值、十六进制数值或 HTML 颜色字符串。多材质模型应在运行模式确认实际影响范围。

Set Object Material Texture

为对象材质设置单张贴图或图片序列。

主要输入

• uuid：目标对象；
• textureUrl：单张图片；
• images：图片序列；
• intervalMs：序列帧间隔。

常用属性

• Map Slot：要修改的贴图槽；
• Fit Mode：拉伸、重复或镜像重复；
• Repeat / Offset / Rotation / Center：贴图变换；
• Flip Y：Y 轴翻转；
• Color Space：色彩空间；
• Loop：图片序列是否循环；
• Preserve Texture Config：只替换图片，保留当前贴图变换。

目标包含多个网格或材质时，可以进一步限定网格、材质名称、材质序号或区域。

Set Object Animation

控制模型自带动画片段。

输入	说明
uuid	目标对象
clip	动画片段名称，留空通常使用第一段
weight	动画混合权重，0–1
fade	淡入淡出秒数
play / pause / stop / toggle	播放控制
seek(t)	跳转到 0–1 的进度
speed	播放速度
loop	once、loop 或 pingpong

last_op 输出返回最近执行的操作，可用于状态显示或继续判断。

精灵文字节点

节点	主要输入	作用
Set Sprite Text	uuid、text	替换完整文字
Set Sprite Text Variable	uuid、name、value	更新一个模板变量
Set Sprite Text Variables	uuid、values	一次合并多个变量

变量节点适合实时状态、设备数值和动态说明，不会替换文字模板的样式。

图表节点

节点	主要输入	作用
Set Option	uuid、option	设置 ECharts 图表配置
Set Append Data	uuid、data	向已有图表追加数据

追加数据适合连续趋势；完整切换图表类型或结构时使用 Set Option。数据格式必须与目标图表当前配置匹配。