你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

KeywordRecognizer 类

定义

命名空间:

Microsoft.CognitiveServices.Speech

程序集:

Microsoft.CognitiveServices.Speech.csharp.dll

包:

Microsoft.CognitiveServices.Speech v1.38.0

使用关键字 (keyword) 模型识别单词或短语。

public sealed class KeywordRecognizer : IDisposable

type KeywordRecognizer = class
    interface IDisposable

Public NotInheritable Class KeywordRecognizer
Implements IDisposable

继承

Object

KeywordRecognizer

实现

IDisposable

示例

首先，需要实例化对象：

// (This sample uses the microphone. You can use any input source.)
var audioConfig = Microsoft.CognitiveServices.Speech.Audio.AudioConfig.FromDefaultMicrophoneInput();
var recognizer = new KeywordRecognizer (audioConfig);

(可选) 然后，需要连接事件才能接收通知：

recognizer.Recognized += (s, e) =>
{
    // Keyword detected!
};

全部设置。 开始识别。

// for .table, see:
// https://docs.microsoft.com/azure/cognitive-services/speech-service/custom-keyword-basics
var keywordModel = KeywordRecognitionModel.FromFile(@"C:\path\to\your\tablefile.table");
var result = recognizer.RecognizeOnceAsync(keywordModel);
result.Wait();

注解

在 Speech Studio 中创建关键字 (keyword) 模型，该模型将其保存在“.table”文件中。

另请参阅：

• 自定义关键字入门
• KeywordRecognitionResult * KeywordRecognitionEventArgs * KeywordRecognitionModel * AudioConfig

构造函数

KeywordRecognizer(AudioConfig)

从 AudioConfig创建 KeywordRecognizer。 该配置定义识别器对象要使用的音频输入。

属性

Properties

为此 KeywordRecognizer定义的属性及其值的集合。

方法

Dispose()	此方法执行资源的清理。
RecognizeOnceAsync(KeywordRecognitionModel)	以异步操作的形式启动关键字 (keyword) 识别会话。
StopRecognitionAsync()	异步停止当前活动的关键字 (keyword) 识别会话。

事件

Canceled	与取消交互相关的事件的信号。 事件指示原因是直接取消还是错误。
Recognized	与关键字识别相关的事件的信号。