故障排除

查找 Convai Unreal Engine 插件中安装、API 密钥、音频、唇形同步和连接问题的修复方法，以及日志导出和诊断指导。

本节涵盖插件层面发生的问题：安装、身份验证、会话启动、麦克风采集、常规口型同步设置以及诊断。如果 Convai Unreal Engine 插件已成功连接，但某个功能表现异常，请先查看该功能的故障排查页面。

不知道从哪里开始？ 打开 Unreal 编辑器输出日志（Window > Output Log）并查找第一个 Convai 错误或警告。使用日志类别作为路线： LogConvai 或 LogConvaiEditor → 安装和插件问题； ConvaiConnectionManagerLog, ConvaiSubsystemLog，还是 ConvaiChatbotComponentLog → 连接和 API 密钥问题； ConvaiAudioLog, ConvaiAudioStreamerLog，还是 ConvaiPlayerLog → 音频和麦克风问题； ConvaiFaceSyncLog → 口型同步和动画问题。如果没有出现 Convai 类别，请从安装和插件问题开始。

故障排查类别

安装和插件问题 未找到插件、模块加载失败、仅蓝图项目限制以及 Android 打包错误。

连接和 API 密钥问题 身份验证失败、缺少 API 密钥、会话超时错误以及防火墙配置。

音频和麦克风问题 无音频输入、错误的采集设备、Android 权限失败以及音频播放错误。

口型同步和动画问题 没有嘴部动作、错误的混合形状曲线、帧不足以及打包构建中的动画失败。

诊断和日志导出 日志类别、详细级别控制、配置默认值、蓝图诊断节点以及用于支持的日志文件导出。

特定功能故障排查

插件成功连接后出现的问题——即某个特定功能行为不正确——记录在各自功能的专属章节中。

功能	故障排查页面
角色动作	排查角色动作问题
动态上下文	排查动态上下文问题
Emotion	排查情绪问题
长期记忆	排查长期记忆问题
叙事设计	排查叙事设计问题
场景元数据	排查场景元数据问题
视觉	排查视觉问题
视线注意力	排查凝视注意力问题
口型同步	排查口型同步问题

下一步

当单条错误消息难以诊断问题时，请为相关类别启用详细日志记录，并检查输出日志。诊断页面还说明了 Unreal 将日志写入何处，以及如何从 Convai 编辑器窗口创建可共享的支持包。

诊断与日志导出