SpeechRecognizer 类

定义

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

public ref class SpeechRecognizer sealed : IClosable
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SpeechRecognizer final : 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.Activatable(typeof(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SpeechRecognizer : System.IDisposable
[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
属性
实现

Windows 要求

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

注解

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

版本历史记录

Windows 版本 SDK 版本 增值
1709 16299 TrySetSystemSpeechLanguageAsync

构造函数

SpeechRecognizer()

创建 SpeechRecognizer 类的新实例。

SpeechRecognizer(Language)

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

属性

Constraints

获取当前添加到 SpeechRecognizer 对象的约束对象的集合。

ContinuousRecognitionSession

获取 (SpeechContinuousRecognitionSession) 与此 SpeechRecognizer 关联的连续识别会话对象。

CurrentLanguage

获取用于语音识别的语言。

State

获取语音识别器的状态。

SupportedGrammarLanguages

获取在 Constraints 属性中指定的 SpeechRecognitionGrammarFileConstraintSpeechRecognitionListConstraint 对象的自定义语法支持的语言集合。

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 属性进行更改时,将引发此事件。

适用于

另请参阅