玩家输入故障排查

修复 Convai Unity SDK 对话中的被拒绝消息、永久禁用的聊天输入框，或始终无法打开的麦克风。

大多数玩家输入问题都可追溯到对话可用性：由于被提及的角色还听不到，消息、按键通话按下或开启麦克风被拒绝。请在下方找到确切的消息或症状。

开始之前

• 确认当前被指向的是哪个角色，使用 ConvaiManager.AddressedCharacter，并直接读取其 ConversationAvailability — 参见 会话可用性如何工作.
• 请在故障发生处读取控制台行。下面的消息按其原样引用。

输入的消息被拒绝

ConvaiPlayer.TrySendTextMessage 返回 否 并给出一个原因。 SendTextMessage 会将相同原因记录为一条控制台警告，前缀为 消息未发送：.

症状	原因	修复方法	验证
消息为空。	传递给 SendTextMessage 或 TrySendTextMessage 的字符串为空或仅包含空白字符。	发送前检查输入字符串。	该调用返回 是.
没有任何对象在监听玩家消息。场景中是否存在并启用了 ConvaiManager？	没有处理程序订阅 ConvaiPlayer.OnTextMessageSent.	确认 ConvaiManager 是否在场景中存在且处于活动状态。	某个处理程序接收到 OnTextMessageSent.
当前没有指向任何角色。请向场景中添加一个 Convai Character，或使用 ConvaiManager.TalkTo 将对话指向其中一个。	ConversationAvailability 是 NoCharacter.	添加一个处于活动状态的 ConvaiCharacter，或者调用 ConvaiManager.TalkTo ，以将对话指向其中一个。	AddressedCharacter 不是 null.
房间尚未连接。请先开始对话。	ConversationAvailability 是 Offline.	发送前先连接房间。	ConversationAvailability 不再 Offline.
房间仍在连接中。	ConversationAvailability 是 Connecting.	等待连接完成，或者基于以下条件来控制发送 UI： CanAcceptPlayerInput()。请参见 基于可用性控制你的 UI.	ConversationAvailability 进入 Connecting.
“<character>”尚未完成加入对话。一旦服务确认它，它就会立即回应——通常只需片刻。	ConversationAvailability 是 Preparing。房间已连接，但被指向的角色尚未被 Convai 确认。	请等待——一旦服务确认该角色，这会自动解决。自定义 UI 应基于 CanAcceptPlayerInput() 而不是房间的已连接状态来进行控制。	ConversationAvailability 变为 就绪.
“<character>”在本次对话中不可用。	ConversationAvailability 是 Unavailable。该角色未能启动或已离开房间。	检查 ConvaiCharacter 请查看底层故障的连接日志；这种状态不会自行恢复。	角色重新连接并且 ConversationAvailability 报告的内容不是 Unavailable.

随附的聊天输入框保持禁用状态

症状	原因	修复方法	验证
聊天输入框始终无法交互	ConversationAvailability 从未达到 就绪 或 Answering — 原因请参见上方的拒绝理由。	请根据上方表格进行诊断，而不是看输入框本身；输入框只反映最终结果。	输入框的占位符显示 Ready Prompt。
该输入框始终可交互，即使在角色还听不到	根据可用性门控输入 已在……上关闭 ChatTranscriptUI.	重新启用它，或者接受玩家会通过被拒绝而不是输入框关闭来得知。参见 自定义聊天输入框提示.	ConvaiPlayer.TrySendTextMessage 无论哪种情况仍会被拒绝。
拒绝原因从未显示在屏幕上	否 TMP_Text 已分配给 通知文本 时 ChatTranscriptUI，或 拒绝通知秒数 是 0.	分配一个 TMP_Text 引用，并将 Refusal Notice Seconds 设置为大于 0.	拒绝原因会显示，并在设定时长后自动清除。

按键通话无法打开

ConvaiPushToTalkController.Press() 返回 否 并设置 BlockedReason 当其拒绝时。

症状	原因	修复方法	验证
当前会话未启用按键通话。	解析出的轮流发言策略不是 PushToTalk.	将按键通话配置为对话输入模式。参见 配置对话输入模式.	Press() 返回 是.
按键通话需要活动的房间连接。	按下控件时房间尚未连接。	在允许按下之前，等待房间连接。	Press() 返回 是 连接后。
按键通话无法解析目标角色。	无法解析出目标角色——没有分配明确目标，没有被指向的角色，而且场景中有多个角色。	分配一个明确目标，或者使用 ConvaiManager.TalkTo 先指向某个角色，然后再按下。	Press() 会解析目标角色 ID。
“<character>”还听不到玩家（<state>）。	被指向角色的 ConversationAvailability 不接受输入——房间已连接，但角色尚未被确认。	等待 ConversationAvailability 报告 就绪 或 Answering 之后再允许按下，或者像 基于可用性控制你的 UI.	一旦可用状态接受输入，按下就会成功。

在多角色房间中，麦克风始终不会打开

症状	原因	修复方法	验证
10 秒后仍在等待房间确认其第一个角色。麦克风保持关闭，并会在该角色准备好时打开。	免提自动启动会等待房间确认其第一个角色后再打开麦克风，而不是在传输连接后立刻打开。在多角色房间中，这可能会超过 10 秒。	这是预期行为，不是故障——在第一个角色被确认后麦克风就会打开。如果等待时间始终很长，请检查为什么该角色确认得这么慢。	麦克风打开，警告不再重复出现。
麦克风打开的时间明显晚于单角色场景	这是预期的。单角色房间的会话只会到达 已连接 ，因为其角色已经被播报，所以不会有额外等待。多角色房间可以在其第一个角色被确认之前就达到 已连接 ，而麦克风会等待该确认。	无需修复——这是这两种房间结构之间的预期差异。	不适用

仍然被阻塞

收集确切的控制台消息、当前 ConversationAvailability 针对两者的 ConvaiManager 以及具体的 ConvaiCharacter 所涉及内容，以及在可用状态报告后，相同输入是否能够成功 就绪.

相关页面

对话可用性如何运作对话可用性参考