SpeechRecognizer 类

定义

命名空间:

Windows.Media.SpeechRecognition

使用默认或自定义图形用户界面 (GUI) 启用语音识别。

public ref class SpeechRecognizer sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class SpeechRecognizer final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SpeechRecognizer : System.IDisposable

function SpeechRecognizer(language)

Public NotInheritable Class SpeechRecognizer
Implements IDisposable

继承

Object Platform::Object IInspectable SpeechRecognizer

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

实现

IClosable IDisposable

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

必须始终在 RecognizeAsync 或 RecognizeWithUIAsync 之前调用 CompileConstraintsAsync，即使 Constraints 属性中未指定约束也是如此。

版本历史记录

Windows 版本	SDK 版本	增值
1709	16299	TrySetSystemSpeechLanguageAsync

构造函数

SpeechRecognizer()	创建 SpeechRecognizer 类的新实例。
SpeechRecognizer(Language)	使用语言说明符创建 SpeechRecognizer 类的新实例。

属性

Constraints	获取当前添加到 SpeechRecognizer 对象的约束对象的集合。
ContinuousRecognitionSession	获取 (SpeechContinuousRecognitionSession) 与此 SpeechRecognizer 关联的连续识别会话对象。
CurrentLanguage	获取用于语音识别的语言。
State	获取语音识别器的状态。
SupportedGrammarLanguages	获取在 Constraints 属性中指定的 SpeechRecognitionGrammarFileConstraint 和 SpeechRecognitionListConstraint 对象的自定义语法支持的语言集合。
SupportedTopicLanguages	获取由在 Constraints 属性中指定的 SpeechRecognitionTopicConstraint 对象的预定义 Web 服务语法支持的语言集合。
SystemSpeechLanguage	获取在“设置>时间”& 语言语音“中指定的设备的语音语言>。
Timeouts	获取语音识别器忽略静音或无法识别的声音 (babble) 并继续侦听语音输入的时间。
UIOptions	获取 RecognizeWithUIAsync 方法的 UI 设置。

方法

Close()	通过释放、释放或重置分配的资源来释放语音识别器。
CompileConstraintsAsync()	异步编译 由 Constraints 属性指定的所有约束。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
RecognizeAsync()	开始 SpeechRecognizer 对象的语音识别会话。
RecognizeWithUIAsync()	异步启动语音识别会话，其中包含其他 UI 机制，包括提示、示例、文本转语音 (TTS) 和确认。
StopRecognitionAsync()	异步结束语音识别会话。
TrySetSystemSpeechLanguageAsync(Language)	异步尝试在 IoT 设备上设置用于语音识别的系统语言。 注意 此方法仅在 嵌入模式下可用。

事件

HypothesisGenerated	当语音识别器返回识别结果片段时，在正在进行的听写会话期间发生。
RecognitionQualityDegrading	当检测到可能影响识别准确性的 音频问题 时，将引发此事件。
StateChanged	当在音频捕获期间对 State 属性进行更改时，将引发此事件。

另请参阅

• Windows.Media.SpeechRecognition
• 语音交互
• 语音识别和语音合成示例
• 全息语音输入示例