---
title: event_conversation_started
summary: 与指定角色开始对话时触发。
section: reference
kind: api
status: reference
updated: 2026-10-27
tags: ["API","X4"]
sources: ["https://wiki.egosoft.com/X%20Rebirth%20Wiki/Modding%20support/Mission%20Director%20Guide/","https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## 说明

与指定角色开始对话时触发。

## 事件数据

| 字段 | 类型 / 用途 | 含义 |
| --- | --- | --- |
| `event.object` | [MD 对象](wiki:type-md-values) | 参与者:包含文本和模板的实体或列表. |
| `event.param` | [MD 字符串](wiki:type-md-values) | 谈话名称. |
| `event.param2` | [unknown](wiki:type-results) | 发射者定义的对话参数. |

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

## 事件订阅示例

插入这个独立的碎片到您的 MD 脚本的适当的线索节点中. 使用多个例子时更改WikiWatch名称. 在启用之前,您的脚本中的Init标志必须包含该过器所需的作用的有效$Actor. 这种例子并没有创造这个对象.

```xml
<cue name="WikiWatch" instantiate="true" namespace="this">
  <conditions>
    <event_conversation_started actor="md.WikiExample.Init.$Actor" />
  </conditions>
  <actions>
    <set_value name="$Actor" exact="event.object" />
    <set_value name="$Conversation" exact="event.param" />
    <set_value name="$ConversationParam" exact="event.param2" />
    <debug_text text="'Wiki: event_conversation_started received'" />
  </actions>
</cue>
```

## 运行效果

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

```text
Wiki: event_conversation_started received
```

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

这些属性用于筛选事件，不是上表中的事件数据字段。 [架构类型](wiki:schema-types).

`libraries/common.xsd`

| 属性 | 架构类型 | 要求 | 默认 / 固定 |
| --- | --- | --- | --- |
| `chance` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |
| `comment` | [`comment`](wiki:schema-comment-c44bb2fd) | 没有 | 没有申报 |
| `actor` | [`genericactor`](wiki:schema-genericactor-b8e050db) | 没有 | 没有申报 |
| `conversation` | [`conversation`](wiki:schema-conversation-8b34dbc2) | 没有 | 没有申报 |
| `convprefix` | [`namestring`](wiki:schema-namestring-3646b03f) | 没有 | 没有申报 |
| `convparam` | [`expression`](wiki:schema-expression-b8bc0e4f) | 没有 | 没有申报 |

## 返回值

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

## 接口约定依据

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

[类型与方法](wiki:types) · [MD cue](wiki:md-cues) · [调试](wiki:debugging)