Godot Dialogue Manager 中获取突变对话行的正确方法

在使用 Godot Dialogue Manager 插件时，开发者可能会遇到需要预判下一行对话内容的情况，特别是当下一行包含突变(mutation)操作时。本文将详细介绍如何正确使用 get_next_dialogue_line() 方法来检测突变行。

问题背景

在对话管理系统中，突变(mutation)是指对话过程中执行的特殊操作，通常以 do something() 的形式出现在对话资源文件中。开发者有时需要提前知道下一行是否是突变行，以便做出相应的逻辑处理。

常见错误

许多开发者尝试直接调用 resource.get_next_dialogue_line(dialogue_line.next_id) 来获取下一行内容，但会遇到以下错误：

Assertion failed: Method "something" not found. States with directly referenceable properties/methods/signals include "TestScene". Autoloads need to be referenced by their name to use their properties.

解决方案

正确的做法是在调用 get_next_dialogue_line() 时传入 temporary_game_states 参数。这个参数包含了当前对话的上下文状态，使得系统能够正确解析突变方法。

var next_line = resource.get_next_dialogue_line(
    dialogue_line.next_id,
    temporary_game_states
)

实现细节

1. 临时游戏状态的重要性：temporary_game_states 包含了对话系统运行时的上下文信息，特别是那些可以访问突变方法的节点引用。

2. 突变行的处理：当下一行是突变行时，返回的 DialogueLine 对象的 type 属性会是 DialogueLine.TYPE_MUTATION，开发者可以通过检查这个属性来判断是否是突变行。

3. 跳过突变行的情况：如果确实需要跳过突变行获取实际的对话内容，可以递归调用 get_next_dialogue_line() 直到获取到非突变行。

最佳实践

1. 始终传递 temporary_game_states 参数
2. 检查返回行的 type 属性以确定行类型
3. 对于需要连续跳过突变行的情况，实现递归获取逻辑

示例代码

func get_next_non_mutation_line(resource, id, game_states):
    var line = resource.get_next_dialogue_line(id, game_states)
    while line and line.type == DialogueLine.TYPE_MUTATION:
        line = resource.get_next_dialogue_line(line.next_id, game_states)
    return line

通过以上方法，开发者可以可靠地检测和处理对话中的突变行，实现更复杂的对话逻辑控制。