演员切换状态

功能描述

切换指定演员的状态。默认会依次淡出当前状态、应用新状态、淡入新状态，并在转场完成后继续执行剧情。

语法结构

actor change <角色名称> <新状态>

参数详解

参数	必需	示例	说明
角色	是	kona	指定要切换状态的演员名称
新状态	是	happy	指定要切换到的新状态

示例

actor change kona happy

状态切换转场

actor change 的默认转场顺序如下：

1. 当前角色淡出。
2. 角色场景应用新状态。
3. 角色以新状态淡入。
4. 转场结束后，继续执行下一条剧情命令。

在 KND_ActingInterface 节点的检查器中可以配置转场：

属性	默认值	说明
enable_actor_state_fade	true	是否为演员状态切换启用淡入淡出
actor_state_fade_duration	0.3	完整转场的总时长（秒）；淡出和淡入各占一半

关闭 enable_actor_state_fade 或把 actor_state_fade_duration 设为 0 时，状态会立即切换。

转场作用于稳定的角色挂载层，不会复制角色场景，因此图片、视频、Spine、Live2D 和自定义角色场景可以使用相同的切换流程。目标演员不存在或角色场景无法应用该状态时，系统会结束本次命令并继续剧情，不会一直等待。