响应玩家开始说话

在服务通过网络连接确认之前，先在本地响应玩家开始说话或按下按键通话。

玩家是否在说话一直由 Convai 自行判断，并通过网络回传通知——因此角色在那次往返完成之前什么都不会做，看起来像是很晚才注意到玩家。SDK 现在也会在本地监听并发布 LocalPlayerActivityChanged 只要检测到本地证据就立即发布，无论哪种轮流发言模式。

前提条件

• 一个具有 ConvaiManager 已连接。请参见 会话生命周期.

订阅该事件

LocalPlayerActivityChanged 在……上没有类型化属性 ConvaiEvents，因此请通过原始事件中心订阅：

using Convai.Domain.DomainEvents.Runtime;
using Convai.Domain.EventSystem;
using Convai.Runtime.Components;
using UnityEngine;

public class MicrophoneMeter : MonoBehaviour
{
    private SubscriptionToken _token;

    private void OnEnable()
    {
        var hub = ConvaiManager.ActiveManager?.Events?.Raw;
        if (hub == null) return;

        _token = hub.Subscribe<LocalPlayerActivityChanged>(HandleLocalActivity);
    }

    private void OnDisable()
    {
        ConvaiManager.ActiveManager?.Events?.Raw?.Unsubscribe(_token);
        _token = default;
    }

    private void HandleLocalActivity(LocalPlayerActivityChanged e)
    {
        Debug.Log($"[MicrophoneMeter] {e.Source}: {(e.IsActive ? "active" : "inactive")} ({e.Level:F1})");
    }
}

各个来源分别表示什么

LocalPlayerActivityChanged.Source 会告诉你是哪种本地证据触发了该事件：

来源	由以下触发	当
Microphone	开放麦克风的电平门限	采集到的音频高于房间自身学习到的噪声底。只要它仍高于该噪声底附近就保持激活，因此句子中的停顿不会让状态闪烁。
PushToTalk	按住说话控件	玩家按下该控件——这是一个决策，不是声音，因此会在玩家开口之前触发。

麦克风源会学习房间自身的噪声底，而不是使用固定的响度阈值，因此它在安静的耳机和响亮的桌面麦克风上表现一致。只要玩家扬声器中还能听到角色自己的声音，它就保持关闭，除非输入设备上真正启用了声学回声消除——在这种情况下，角色的声音一开始就不会进入麦克风信号。

LocalPlayerActivityChanged.Level 是相对于测得噪声底的比值，适合用于麦克风电平表。它是 0 用于 PushToTalk 以及……的下降沿 Microphone.

LocalPlayerActivityChanged 只是一个提示，不是一次轮次。它只是基于本地证据的推测，绝不会路由消息、提交轮次或产生任何计费。 PlayerSpeakingStateChanged 仍然是 Convai 自己的最终判定——这是唯一会生成转写内容或将角色切换到监听状态的事件。

角色如何处理它

注意到本地活动的角色会进入 关注中 对话状态，仅此而已——它不能进入 倾听中、轮到发言，或仅凭该信号发送任何内容，因此一次误报带来的只是一次查看，而不是一次错误。

角色是否会据此行动

这种本地证据是否会让角色进入对话状态，由……控制 noticeYouLocally Conversation Flow 配置文件中的该项默认随版本提供，且不对编辑开放——该配置文件的 Inspector 不会显示它，也没有公开的 setter。因此每个角色都会对本地活动作出反应，而 LocalPlayerActivityChanged 无论哪种情况，该事件都会传到你自己的代码中。请参见 Conversation flow 参考 以了解该配置文件其余的固定行为。

验证响应

进入 Play 模式，连接后，要么对着麦克风说话，要么按下按住说话控件。确认你的订阅者会立即触发，早于 Convai 对该发言的转写。

下一步

对话流程根据可用性控制 UI