编写清晰的操作名称和描述

用于命名、描述和测试角色动作的简单示例。

操作让你的角色在项目中执行各种事情，例如移动到某处、检查对象、装备物品或更改设置。

你可以在 Convai 聊天机器人组件，在 操作.

先从清晰的操作名称开始

将操作名称与一个示例值一起阅读。结果应当易于理解。

操作名称	参数	示例值	一起阅读
移动到	目的地	装卸区	移动到装卸区
检查	对象	控制面板	检查控制面板
装备	物品	青铜盾牌	装备青铜盾牌
设置难度	难度	困难	设置难度为困难
发送消息	消息	在桥上见我	发送消息：在桥上见我
放下桥	无	无	放下桥

参数本身就可以说明该值是什么。例如， 检查 可以有一个 对象 参数。你不必将该操作命名为 检查对象 ，除非这样对你的项目来说更清晰。

两种版本都可以。请选择对你和你的团队来说最容易阅读的那个。

使用对你有意义的参数名称

参数是操作所需的额外信息。例如：

• 目的地 告诉 移动到 要去哪里。
• 物品 告诉 装备 要装备什么。
• 消息 告诉 发送消息 要发送什么。

值 也是一个有效的名称。更具体的名称可以让你的设置更易于阅读，但这不是必需的。

添加简短说明

有用的说明应回答与该操作相关的重要问题：

• 角色应在什么时候使用它？
• 运行时会发生什么？
• 角色应包含哪些信息？

说明中的完整示例也会有所帮助。

移动到某处

名称： 移动到

参数： 目的地

当用户要求角色去某处时使用此操作。它会将角色移动到那个地方。请包含目的地。示例：移动到装卸区。

注意我们如何在说明中添加“示例：移动到装卸区”作为示例。

检查某物

名称： 检查

参数： 对象

当用户要求角色检查某物时使用此操作。它会在游戏中开始检查。请包含对象。示例：检查控制面板。

传递消息

名称： 发送消息

参数： 消息

当用户要求角色传递消息时使用此操作。它会通过游戏发送消息。即使角色也会口头回应，也要使用它。请包含完整消息。示例：发送消息：在桥上见我。

从固定列表中选择

名称： 设置难度

参数： 难度

当用户要求更改难度时使用此操作。请包含所请求的难度。示例：设置难度为困难。

这些示例展示了模式。请描述你自己的操作实际做什么。

选择值的输入方式

使用 选项 当你想提供一个可用值列表时。

使用 字符串 当该操作应接受不在固定列表中的文本时。

例如，难度操作可以使用诸如以下的选项： 简单, 普通，以及 困难。消息操作可以使用字符串，因为每次消息都可能不同。

选择适合你项目的选项。这两种选项都不是通用的准确性设置。

保持措辞易于理解

操作可以使用西班牙语、英语或其他语言。尽可能让操作名称、参数和说明保持同一种语言，这样设置会更便于阅读。

如果角色支持多种语言，请在你计划使用的每种语言中测试该操作。

测试不止一句话

先试试说明中的示例，然后再尝试几种自然的变体。

对于一个 检查 操作，你可以尝试：

• 直接：“检查控制面板。”
• 自然：“你能再仔细看看那个控制面板吗？”
• 不应运行：“控制面板通常是做什么的？”

在新的会话中重复重要测试。一次成功尝试表明设置可以工作；多次尝试则表明它工作得有多稳定。

在启用许多相似操作之前，先单独测试该操作也会有所帮助。

如果某个操作未运行

请检查以下项目：

• 你正在测试的角色上是否已启用该操作？
• 操作名称是否与蓝图中使用的事件匹配？
• 参数名称是否与蓝图的预期一致？
• 说明是否清楚写明了何时使用该操作？
• 说明是否写明了应包含哪些信息？
• 如果你使用“选项”，该值是否在列表中？
• 当它是唯一启用的操作时，该操作是否可正常工作？

还要检查传到 Unreal 的内容：

• 未收到操作。
• 操作已到达，但缺少一个值。
• 操作和值都已到达，但游戏没有使用它们。

知道发生了哪一种情况会让下一步检查容易得多。