验证你的设置

运行一份插件、组件、音频和 API 密钥检查清单，以确认你的 Convai Unreal Engine 设置在添加功能前可正常工作。

在继续添加功能之前，请使用此页面确认你的 Convai 设置的每个部分都能正常工作。请按顺序完成每个部分。任何一步失败通常都指向一个具体问题，并且有明确的修复方法。

插件检查

检查	如何验证
插件已启用	前往 Edit > Plugins，搜索 Convai，并确认 已启用 复选框已勾选。
工具栏图标可见	Convai 图标会在插件加载后出现在 Unreal Editor 工具栏中。
没有加载错误	该 输出日志 未显示提及 Convai 或 AudioCapture 在编辑器启动时。

API 密钥检查

检查	如何验证
已登录	打开 Convai 编辑器窗口（点击 Convai 工具栏图标），并确认已显示你的账户详情。
密钥已存储	UConvaiSettings.API_Key 已填充——可在以下位置读取： 编辑 > 项目设置 > 插件 > Convai.

如果你尚未登录，请参阅 配置您的 API 密钥.

组件检查

检查	如何验证
角色已添加 Convai Chatbot	打开角色蓝图并确认 UConvaiChatbotComponent 出现在 组件 面板。
角色 ID 已设置	选择 Convai 聊天机器人 组件，并确认 角色 ID 字段不为空，并且与您仪表板中的某个角色匹配。
玩家 Pawn 已添加 Convai Player	打开玩家 Pawn 蓝图并确认 UConvaiPlayerComponent 出现在 组件 面板。
已包含 Face Sync（如果使用口型同步）	请确认 UConvaiFaceSyncComponent 位于角色蓝图中，并且 口型同步模式 与你的骨骼绑定设置正确。

音频检查

检查	如何验证
麦克风可用	按 F10 在播放模式下打开设置面板，然后查看并测试可用的麦克风设备。或者，调用 GetAvailableCaptureDeviceNames() on UConvaiPlayerComponent 在运行时，并确认列表不为空。
默认设备可打开	进入播放模式并确认 GetIsStreaming() 返回 true 在触发按住说话或启用免提模式后。
已授予 Android 权限	在 Android 上，确认 android.permission.RECORD_AUDIO 在开始对话前已请求并授予该权限。

对话检查

请在其他所有检查通过后运行此检查。

1

进入播放模式

按 播放 在 Unreal Editor 工具栏中。

2

开始对话

按住按键通话（默认： T）并说一句简短的话，然后松开。或者，在聊天小部件中输入消息并按下 回车.

3

观察角色状态

当角色正在说话时， GetIsTalking() （“正在说话”）在 UConvaiChatbotComponent 返回 true。 IsInConversation() 返回 true.

添加 打印字符串 在 Blueprint 中连接到这些函数的节点，以便在视口中观察状态转换。 IsListening() 是位于 IsProcessing() 已在 Blueprint 中公开，但目前返回 false 插件源代码中的

4

确认音频输出

角色会发出可听见的回复。如果已配置口型同步，角色的嘴会与语音同步移动。

当验证通过后，角色会通过音频进行回应，并且——如果已配置——进行口型同步。前往功能页面添加动作、情感、动态上下文和其他能力。

常见故障点

角色完全没有回应

症状： 角色从不对语音或文本输入生成回复。

原因： API 密钥未设置，或缺少角色 ID。

修复： 请参见 配置您的 API 密钥；请确认 角色 ID Chatbot 组件上的字段。

验证： 进入播放模式并发送一句简短的话。角色会发出可听见的回复。

角色没有音频输出

症状： 角色似乎在处理输入，但没有发出语音音频。

原因： 音频输出设备问题，或会话未开始。

修复： 请确认 bAutoInitializeSession 为 true 在 Chatbot 组件上，或者调用 StartSession() 之前先检查。

验证： GetIsTalking() 返回 true ，同时角色作出回应。

角色听不到玩家

症状： 角色从不对麦克风输入做出反应。

原因： 未捕获麦克风，或缺少 Player 组件。

修复： 请确认 UConvaiPlayerComponent 位于 Pawn 上；请参阅 配置麦克风.

验证： GetIsStreaming() 返回 true 在按住说话或 VAD 激活之后。

口型同步不播放

症状： 有音频播放，但角色的嘴没有动。

原因： 缺少 Face Sync 组件或口型同步模式错误。

修复： 添加 UConvaiFaceSyncComponent 并设置正确的 LipSyncMode 以适配你的骨骼绑定。

验证： 进入播放模式并确认说话时嘴部会移动。

OnFailureEvent 触发

症状： 该 OnFailureEvent 委托在对话期间触发。

原因： 网络错误或角色 ID 无效。

修复： 请查看 输出日志 请查看详情；验证网络访问和角色 ID。

验证： 修复报告的错误后重试。

下一步

配置麦克风配置角色音频配置对话输入添加聊天 UI