Windows.ApplicationModel.ConversationalAgent 命名空间

使应用程序能够通过 Windows 对话代理平台支持的任何数字助手公开功能。

重要

Windows.ApplicationModel.ConversationalAgent API 是受限访问功能的一部分 (请参阅 LimitedAccessFeatures 类) 。 有关详细信息或请求解锁令牌，请联系 Microsoft 支持部门。

类

ActivationSignalDetectionConfiguration	提供激活信号检测器支持的单个信号的配置详细信息。 例如，关键字 (keyword) 美国英语中的“你好小娜”。
ActivationSignalDetectionConfigurationCreationResult	在 ActivationSignalDetector 创建 ActivationSignalDetectionConfiguration 时提供结果。
ActivationSignalDetector	表示可以根据用户环境的输入生成激活信号的硬件和软件组件，例如语音关键字 (keyword) () 、声音检测或按钮按下。
ConversationalAgentDetectorManager	提供对数字助手的现有信号检测器和配置定义的访问。
ConversationalAgentSession	数字助手与 Windows 对话代理平台之间的信道。
ConversationalAgentSessionInterruptedEventArgs	提供 SessionInterrupted 事件的事件数据。
ConversationalAgentSignal	代理检测到的对应于 ActivationSignalDetectionConfiguration 的信号。 此信号指示应激活匹配代理来处理交互。
ConversationalAgentSignalDetectedEventArgs	提供 SignalDetected 事件的事件数据。
ConversationalAgentSystemStateChangedEventArgs	提供 SystemStateChanged 事件的事件数据。
DetectionConfigurationAvailabilityChangedEventArgs	提供 ActivationSignalDetectionConfiguration.AvailabilityChanged 事件的事件数据。
DetectionConfigurationAvailabilityInfo	提供 ActivationSignalDetector 的可用性详细信息。

枚举

ActivationSignalDetectionConfigurationCreationStatus	指定为数字助手创建 ActivationSignalDetectionConfiguration 时可能的结果。
ActivationSignalDetectionConfigurationRemovalResult	指定从数字助手中删除 ActivationSignalDetectionConfiguration 时可能的结果。
ActivationSignalDetectionConfigurationSetModelDataResult	指定在为数字助手设置 ActivationSignalDetectionConfiguration 的模型配置数据时返回的可能结果。
ActivationSignalDetectionConfigurationStateChangeResult	指定为数字助手启用或禁用 ActivationSignalDetectionConfiguration 时返回的可能结果。
ActivationSignalDetectionTrainingDataFormat	为数字助手指定 ActivationSignalDetector 支持的激活信号训练数据格式。
ActivationSignalDetectorKind	指定支持的 ActivationSignalDetector 类型。
ActivationSignalDetectorPowerState	指定 ActivationSignalDetector 支持的电源模式，这些模式描述允许检测器运行时与电源相关的条件。
ConversationalAgentActivationKind	指定支持的代理激活类型。
ConversationalAgentActivationResult	指定支持的代理激活请求结果值。
ConversationalAgentSessionUpdateResponse	指定 ConversationalAgentSession 更新的每个可能响应。
ConversationalAgentState	指定数字助手的每个可能的 AgentState。
ConversationalAgentSystemStateChangeType	指定 SystemStateChanged 事件的可能状态更改。
ConversationalAgentVoiceActivationPrerequisiteKind	指定语音激活正常运行所需的可能设置。
DetectionConfigurationAvailabilityChangeKind	指定用户授予 ActivationSignalDetector 的每个 ActivationSignalDetectionConfiguration 的权限级别。
DetectionConfigurationTrainingStatus	为数字助手指定 ActivationSignalDetector 识别的语音训练数据状态。 注意 这些确定由单个信号检测器的训练算法做出，可能特定于检测器的硬件或软件实现。
SignalDetectorResourceKind	指定可能报告为 ActivationSignalDetectionConfiguration 不可用的系统资源类型。

注解

用户可以在“设置”中为对话代理启用平台级检测信号。 此信号可能包括关键字 (keyword) 话语、蓝牙传输、系统键盘加速器、应用内语音识别或其他 (门砰声、烟雾检测器) 的声音。 例如，“你好小娜”关键字 (keyword) 开始与 Cortana 进行语音交互。

平台级信号检测器充当“首次通过”筛选器，并可能导致过多的意外激活。 出于此原因，建议考虑对激活信号进行其他验证，例如在代理应用程序的上下文中使用更严格的关键字 (keyword) 检测器。

如果在应用程序未运行时检测到 ConversationalAgentSignal ，或者无法响应 ConversationalAgentSession.SignalDetected 事件，则会使用使用 ConversationalAgentTrigger 注册的任务在后台激活该应用程序。

如果在应用程序能够通过调用 ConversationalAgentSession.RequestAgentStateChangeAsync) 响应 ConversationalAgentSession.SignalDetected 事件 (时检测到 ConversationalAgentSignal，则不会进行后台激活，因为信号已处理。

如果在可中断会话 (请参阅 RequestInterruptableAsync) 已处于活动状态时检测到会话代理的 ConversationalAgentSignal，则会话将收到 ConversationalAgentSession.SessionInterrupted 事件，以指示已引发新的信号事件。

注意

某些数字助手会话不能被另一个信号中断。 例如，Cortana 要求用户发出取消或停止命令以结束当前会话， (用户不能处于 Cortana 会话中，并) 向 Alexa 发出命令。