核心子系统：DictationSubsystem - MRTK3

2025-02-18

注意

有关 MRTK3 中子系统的一般信息，请参阅此处。

核心定义包附带 DictationSubsystem，是和 MRTKSubsystemIDictationsystem 的基本实现，用作 MRTK3 中负责听写的子系统的基础。作为 MRTK 的一部分提供的具体实现（例如 WindowsDictationSubsystem ）和其他可能构建的潜在听写子系统都应基于此类。继承自 DictationSubsystem 的子系统允许启动和停止听写会话，并提供在处理语音输入、识别最终结果以及听写会话完成或出错时触发的事件。可以将事件处理程序添加到这些事件中，以处理听写功能。

有关更具体的信息，请参阅要使用的具体 DictationSubsystem 实现的文档。

安装

注意

本指南提供了在新的 MRTK 项目中启用语音子系统的步骤， (其他基本非语音相关设置) 。如果你正在使用我们的示例项目，你可能会注意到已为你执行了一些步骤。

1. 启用语音子系统

转到“项目设置”“>MRTK3 可用的 MRTK 子系统”，然后启用要使用的听写子系统。

2.分配配置资产

对于某些子系统，需要配置资产才能正常运行。

单击在安装程序 1 中启用的子系统。
检查右侧的“子系统详细信息”下是否显示空 Configuration Asset 槽。如果是这样，请选择 “资产 ”->“创建MRTK>子系统>[子系统的名称]”配置“ ，然后将创建的配置拖到槽上，以创建新的配置。
确保配置槽已填充后，更改特定项目新创建的配置中的设置。完成后，请记得保存项目。

3.确保在“播放器设置”中设置了适当的功能

的不同实现 DictationSubsystem 具有不同的所需功能。有关详细信息，请参阅要使用的子系统的文档。

例如，若要在 UWP 平台上使用WindowsDictationSubsystem，请转到“项目设置”“>播放器>发布设置功能”>，并确保设置了“麦克风”功能。

4.在设备/编辑器中运行场景

项目现在应该已准备好在设备或编辑器中运行。请注意，可能需要配置语音隐私设置，以便听写在编辑器中工作。

使用 DictationSubsystem

若要在脚本中使用 DictationSubsystem ，请将事件处理程序添加到要响应的听写事件，然后调用 StartDictation。

// Get the first running dictation subsystem.
DictationSubsystem dictationSubsystem = XRSubsystemHelpers.GetFirstRunningSubsystem<DictationSubsystem>();

// If we found one...
if (dictationSubsystem != null)
{
    // Add event handlers to all dictation subsystem events. 
    dictationSubsystem.Recognizing += DictationSubsystem_Recognizing;
    dictationSubsystem.Recognized += DictationSubsystem_Recognized;
    dictationSubsystem.RecognitionFinished += DictationSubsystem_RecognitionFinished;
    dictationSubsystem.RecognitionFaulted += DictationSubsystem_RecognitionFaulted;

    // And start dictation
    dictationSubsystem.StartDictation();
}

在触发事件时，你将使用任何想要发生的事件来实现这些事件处理程序。

Recognizing 在识别器处理输入并返回暂定结果时触发。
Recognized 当识别器识别输入并返回最终结果时触发。
RecognitionFinished 在识别会话完成并返回原因时触发。
RecognitionFaulted 在识别出错 (即) 发生错误并返回原因时触发。

完成后，删除这些事件处理程序。

if (dictationSubsystem != null)
{
    dictationSubsystem.StopDictation();
    dictationSubsystem.Recognizing -= DictationSubsystem_Recognizing;
    dictationSubsystem.Recognized -= DictationSubsystem_Recognized;
    dictationSubsystem.RecognitionFinished -= DictationSubsystem_RecognitionFinished;
    dictationSubsystem.RecognitionFaulted -= DictationSubsystem_RecognitionFaulted;
}

可以在示例场景中的示例脚本DictationExample中找到DictationHandler使用 DictationSubsystem 的完整示例。

通过