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

IntentRecognizer class

包:

microsoft-cognitiveservices-speech-sdk

意向识别器。

Extends

Recognizer

构造函数

IntentRecognizer(SpeechConfig, AudioConfig)

初始化 IntentRecognizer 的实例。

属性

authorizationToken	获取用于与服务通信的授权令牌。 获取/设置用于与服务通信的授权令牌。 注意：请将派生自 LanguageUnderstanding 订阅密钥的令牌用于意向识别器。
canceled	事件已取消，表明识别期间发生了错误。
properties	为此 IntentRecognizer 定义的属性及其值的集合。
recognized	识别的事件表示收到最终识别结果的信号。
recognizing	识别事件表示收到中间识别结果的信号。
speechRecognitionLanguage	获取识别的口语。
telemetryEnabled	此方法返回遥测设置的当前状态。

继承属性

sessionStarted	定义会话启动事件的事件处理程序。
sessionStopped	定义会话停止事件的事件处理程序。
speechEndDetected	定义语音停止事件的事件处理程序。
speechStartDetected	定义语音启动事件的事件处理程序。

方法

addAllIntents(LanguageUnderstandingModel, string)
addIntent(string, string)	添加应识别为意向的短语。
addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)	从语言理解服务添加意向以供识别。
close(() => void, (error: string) => void)	关闭此类的实例持有的所有外部资源。
recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)	启动意向识别，并在识别第一个言语后停止。 任务返回识别文本和意向作为结果。 注意：识别第一个言语后，RecognizeOnceAsync () 将返回 ，因此它仅适用于单次识别，如命令或查询。 对于长时间运行的识别，请改用 StartContinuousRecognitionAsync () 。
startContinuousRecognitionAsync(() => void, (e: string) => void)	启动语音识别，直到调用 stopContinuousRecognitionAsync () 。 用户必须订阅事件才能接收识别结果。
startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)	使用关键字识别启动语音识别，直到调用 stopKeywordRecognitionAsync () 。 用户必须订阅事件才能接收识别结果。 注意：关键字识别功能仅在语音设备 SDK 上可用。 此功能目前不包括在 SDK 本身中。
stopContinuousRecognitionAsync(() => void, (e: string) => void)	停止连续意向识别。
stopKeywordRecognitionAsync(() => void, (e: string) => void)	停止连续语音识别。 注意：关键字识别功能仅在语音设备 SDK 上可用。 此功能目前不包括在 SDK 本身中。

继承的方法

enableTelemetry(boolean)

此方法全局启用或禁用遥测。

构造函数详细信息

IntentRecognizer(SpeechConfig, AudioConfig)

初始化 IntentRecognizer 的实例。

new IntentRecognizer(speechConfig: SpeechConfig, audioConfig?: AudioConfig)

参数

speechConfig

SpeechConfig

配置属性集。

audioConfig

AudioConfig

与识别器关联的可选音频输入配置

属性详细信息

authorizationToken

获取用于与服务通信的授权令牌。 获取/设置用于与服务通信的授权令牌。 注意：请将派生自 LanguageUnderstanding 订阅密钥的令牌用于意向识别器。

string authorizationToken

属性值

string

授权令牌。

canceled

事件已取消，表明识别期间发生了错误。

public canceled: (sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

属性值

(sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

properties

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

PropertyCollection properties

属性值

PropertyCollection

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

recognized

识别的事件表示收到最终识别结果的信号。

public recognized: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

属性值

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

recognizing

识别事件表示收到中间识别结果的信号。

public recognizing: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

属性值

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

speechRecognitionLanguage

获取识别的口语。

string speechRecognitionLanguage

属性值

string

识别的口语。

telemetryEnabled

此方法返回遥测设置的当前状态。

static boolean telemetryEnabled

属性值

boolean

如果启用遥测，则为 true;否则为 false。

继承属性详细信息

sessionStarted

定义会话启动事件的事件处理程序。

public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void

属性值

(sender: Recognizer, event: SessionEventArgs) => void

继承自Recognizer.sessionStarted

sessionStopped

定义会话停止事件的事件处理程序。

public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void

属性值

(sender: Recognizer, event: SessionEventArgs) => void

继承自Recognizer.sessionStopped

speechEndDetected

定义语音停止事件的事件处理程序。

public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

属性值

(sender: Recognizer, event: RecognitionEventArgs) => void

继承自Recognizer.speechEndDetected

speechStartDetected

定义语音启动事件的事件处理程序。

public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

属性值

(sender: Recognizer, event: RecognitionEventArgs) => void

继承自Recognizer.speechStartDetected

方法详细信息

addAllIntents(LanguageUnderstandingModel, string)

function addAllIntents(model: LanguageUnderstandingModel, intentId?: string)

参数

model

LanguageUnderstandingModel

包含意向的语言理解模型。

intentId

string

在 IntentRecognitionResult 的 getIntentId () 方法中返回的自定义 ID String。

addIntent(string, string)

添加应识别为意向的短语。

function addIntent(simplePhrase: string, intentId?: string)

参数

simplePhrase

string

intentId

string

一个字符串，表示要识别的意向的标识符。

addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)

从语言理解服务添加意向以供识别。

function addIntentWithLanguageModel(intentId: string, model: LanguageUnderstandingModel, intentName?: string)

参数

intentId

string

一个字符串，表示要识别的意向的标识符。 如果 intentName 为空，则忽略。

model

LanguageUnderstandingModel

语言理解服务中的意向模型。

intentName

string

意向模型中定义的意向名称。 如果为空，则将添加模型中定义的所有意向名称。

close(() => void, (error: string) => void)

关闭此类的实例持有的所有外部资源。

function close(cb?: () => void, errorCb?: (error: string) => void)

参数

cb

() => void

errorCb

(error: string) => void

recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)

启动意向识别，并在识别第一个言语后停止。 任务返回识别文本和意向作为结果。 注意：识别第一个言语后，RecognizeOnceAsync () 将返回 ，因此它仅适用于单次识别，如命令或查询。 对于长时间运行的识别，请改用 StartContinuousRecognitionAsync () 。

function recognizeOnceAsync(cb?: (e: IntentRecognitionResult) => void, err?: (e: string) => void)

参数

cb

(e: IntentRecognitionResult) => void

接收识别的回调已完成，并带有 IntentRecognitionResult。

err

(e: string) => void

发生错误时调用的回调。

startContinuousRecognitionAsync(() => void, (e: string) => void)

启动语音识别，直到调用 stopContinuousRecognitionAsync () 。 用户必须订阅事件才能接收识别结果。

function startContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)

参数

cb

() => void

识别开始后调用回调。

err

(e: string) => void

发生错误时调用的回调。

startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

使用关键字识别启动语音识别，直到调用 stopKeywordRecognitionAsync () 。 用户必须订阅事件才能接收识别结果。 注意：关键字识别功能仅在语音设备 SDK 上可用。 此功能目前不包括在 SDK 本身中。

function startKeywordRecognitionAsync(model: KeywordRecognitionModel, cb?: () => void, err?: (e: string) => void)

参数

model

KeywordRecognitionModel

指定要识别的关键字的关键字识别模型。

cb

() => void

识别开始后调用回调。

err

(e: string) => void

发生错误时调用的回调。

stopContinuousRecognitionAsync(() => void, (e: string) => void)

停止连续意向识别。

function stopContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)

参数

cb

() => void

识别停止后调用的回调。

err

(e: string) => void

发生错误时调用的回调。

stopKeywordRecognitionAsync(() => void, (e: string) => void)

停止连续语音识别。 注意：关键字识别功能仅在语音设备 SDK 上可用。 此功能目前不包括在 SDK 本身中。

function stopKeywordRecognitionAsync(cb?: () => void, err?: (e: string) => void)

参数

cb

() => void

识别停止后调用的回调。

err

(e: string) => void

发生错误时调用的回调。

继承的方法详细信息

enableTelemetry(boolean)

此方法全局启用或禁用遥测。

static function enableTelemetry(enabled: boolean)

参数

enabled

boolean

遥测收集的全局设置。 如果设置为 true，则会收集麦克风错误、识别错误等遥测信息并将其发送给 Microsoft。 如果设置为 false，则不会向 Microsoft 发送遥测数据。

继承自Recognizer.enableTelemetry