event_cutscene_started - MD/AI 引擎事件

说明#

过场动画开始时触发。

事件数据#

字段	类型 / 用途	含义
`event.param`	MD 字符串	幕的键字串.
`event.param2`	unknown	幕身份证.
`event.param3`	MD 布尔值	如果是信箱,这是真的.

MD 标签描述 MD 值与对象的语义角色，并非 Lua 类型。unknown 表示来源未声明准确的表示方式，并不保证值为 nil。不要推断未列出的事件字段。

事件订阅示例#

将此独立片段放入 MD 脚本中合适的 cues 节点。使用多个示例时，请为 WikiWatch 更名以免冲突。

XML

<cue name="WikiWatch" instantiate="true" namespace="this">
  <conditions>
    <event_cutscene_started />
  </conditions>
  <actions>
    <set_value name="$Key" exact="event.param" />
    <set_value name="$CutsceneID" exact="event.param2" />
    <set_value name="$Letterboxed" exact="event.param3" />
    <debug_text text="'Wiki: event_cutscene_started received'" />
  </actions>
</cue>

运行效果#

每次匹配的事件都会创建处理函数实例，并将已记录的字段复制到其局部变量。启用脚本调试后，预期出现以下诊断标记：

TEXT

Wiki: event_cutscene_started received

这是独立教学示例的预期输出，不是已完成的游戏测试。订阅只观察事件，不会触发对应的游戏操作。对于频繁触发的事件，请避免逐次记录日志造成刷屏。

XML 订阅过滤条件#

这些属性用于筛选事件，不是上表中的事件数据字段。架构类型.

libraries/common.xsd

属性	架构类型	要求	默认 / 固定
`chance`	`expression`	没有	没有申报
`comment`	`comment`	没有	没有申报
`key`	`expression`	没有	没有申报
`cutscene`	`expression`	没有	没有申报

返回值#

这是 MD 事件条件，而不是返回 Lua 元组的函数调用。请在对应的 MD 操作上下文中读取 event.object/event.param。

接口约定依据#

字段映射已与本机 X4 9.00 (611726) 的 common.xsd / md.xsd 注释核对。本站仅发布独立编写的说明和示例。XML 有效并不能单独证明游戏效果。

类型与方法 · MD cue · 调试

说明#