SpeechRecognizer 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
使用默认或自定义图形用户界面 (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
- 继承
- 属性
- 实现
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 属性进行更改时,将引发此事件。 |