共用方式為

類別 Intent：：IntentRecognizer

  • 發行項
class Intent::IntentRecognizer
  : public AsyncRecognizer< IntentRecognitionResult, IntentRecognitionEventArgs, IntentRecognitionCanceledEventArgs >

除了執行語音轉換文字辨識之外，IntentRecognizer 還擷取說話者意圖的結構化資訊，可用來使用專用意圖觸發程式推動進一步的動作（請參閱 IntentTrigger）。

成員

性能

語法：public PropertyCollection & Properties;

針對這個 IntentRecognizer 定義的屬性及其值集合。

IntentRecognizer

語法：public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

內部建構函式。 使用提供的句柄建立新的實例。

參數

  • hreco 辨識器句柄。

~IntentRecognizer

語法：public inline ~IntentRecognizer ( );

破壞者

RecognizeOnceAsync

語法：public inline virtual std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( );

啟動意圖辨識，並在辨識單一語句之後傳回。 單一語句的結尾取決於在結尾接聽無聲，或直到處理最多 30 秒的音訊為止。 工作會傳回辨識文字作為結果。 注意：由於 RecognizeOnceAsync（） 只會傳回單一語句，因此它只適用於命令或查詢等單一射擊辨識。 針對長時間執行的多重語句辨識，請改用 StartContinuousRecognitionAsync。。

返回

未來包含異步意圖辨識的結果值（IntentRecognitionResult 的共用指標）。

RecognizeOnceAsync

語法：public inline std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( std::string text );

啟動意圖辨識，並從傳入的文字產生結果。 當語音輸入未系結至 IntentRecognizer 時，這適用於測試和其他時間。 注意：意圖服務目前不支援此功能，因此它只適用於離線模式比對或完全比對意圖。

參數

  • text 要評估的文字。

返回

未來包含異步意圖辨識的結果值（IntentRecognitionResult 的共用指標）。

StartContinuousRecognitionAsync

語法：public inline virtual std::future< void > StartContinuousRecognitionAsync ( );

以異步方式起始連續意圖辨識作業。

返回

空的未來。

StopContinuousRecognitionAsync

語法：public inline virtual std::future< void > StopContinuousRecognitionAsync ( );

以異步方式終止進行中的連續意圖辨識作業。

返回

空的未來。

StartKeywordRecognitionAsync

語法：public inline virtual std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );

以異步方式起始關鍵詞辨識作業。

參數

  • model 指定要使用的關鍵詞模型。

返回

空的未來。

StopKeywordRecognitionAsync

語法：public inline virtual std::future< void > StopKeywordRecognitionAsync ( );

以異步方式終止關鍵詞辨識作業。

返回

空的未來。

AddIntent

語法：public inline void AddIntent ( const std::string & simplePhrase );

新增使用者可說出的簡單片語，指出特定使用者意圖。 這個簡單的片語可以是一種模式，包括和 Enitity 包圍著大括弧。 例如「按兩下 」{checkboxName} 複選框」。

參數

  • simplePhrase 對應至意圖的片語。

辨識之後，IntentRecognitionResult 的 IntentId 屬性將會符合此處指定的 simplePhrase。 如果指定並比對任何實體，則會在 IntentResult->GetEntities（） 呼叫中使用。

AddIntent

語法：public inline void AddIntent ( const std::string & simplePhrase , const std::string & intentId );

新增使用者可說出的簡單片語，指出特定使用者意圖。 這個簡單的片語可以是一種模式，包括和 Enitity 包圍著大括弧。 例如「按兩下 」{checkboxName} 複選框」。

參數

  • simplePhrase 對應至意圖的片語。

  • intentId IntentRecognitionResult 的 IntentId 屬性中要傳回的自定義標識符字串。

一旦辨識，結果的意圖標識碼將會符合此處提供的標識符。 如果指定並比對任何實體，則會在 IntentResult->GetEntities（） 呼叫中使用。

AddIntent

語法：public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName );

依名稱從指定的 Language Understanding 模型新增單一意圖。 針對 PatternMatchingModel 和 ConversationalLanguageUnderstandingModel 類型，這會先清除任何現有的模型，再加以啟用。 針對這些類型，會忽略 intentName。

參數

  • model 包含意圖的語言理解模型。

  • intentName 要包含在語言理解模型中的單一意圖名稱。

辨識之後，IntentRecognitionResult 的 IntentId 屬性將會包含此處指定的 intentName。

AddIntent

語法：public inline void AddIntent ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentName , const std::string & intentId );

依名稱從指定的 Language Understanding 模型新增單一意圖。 針對 PatternMatchingModel 和 ConversationalLanguageUnderstandingModel 類型，這會先清除任何現有的模型，再加以啟用。 針對這些類型，會忽略 intentName 和 intentId。

參數

  • model 包含意圖的語言理解模型。

  • intentName 要包含在語言理解模型中的單一意圖名稱。

  • intentId IntentRecognitionResult 的 IntentId 屬性中要傳回的自定義標識符字串。

AddAllIntents

語法：public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model );

從指定的 Language Understanding 模型新增所有意圖。 針對 PatternMatchingModel 和 ConversationalLanguageUnderstandingModel 類型，這會先清除任何現有的模型，再加以啟用。

參數

  • model 包含意圖的語言理解模型。

辨識之後，IntentRecognitionResult 的 IntentId 屬性將會包含已辨識意圖的名稱。

AddAllIntents

語法：public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model , const std::string & intentId );

從指定的 Language Understanding 模型新增所有意圖。 針對 PatternMatchingModel 和 ConversationalLanguageUnderstandingModel 類型，這會先清除任何現有的模型，再加以啟用。

參數

  • model 包含意圖的語言理解模型。

  • intentId 在 IntentRecognitionResult 的 IntentId 屬性中傳回的自定義字串識別碼。

AddIntent

語法：public inline void AddIntent ( std::shared_ptr< IntentTrigger > trigger , const std::string & intentId );

加入指定的 IntentTrigger。

參數

  • trigger 與意圖對應的 IntentTrigger。

  • intentId 在 IntentRecognitionResult 的 IntentId 屬性中傳回的自定義字串識別碼。

SetAuthorizationToken

語法：public inline void SetAuthorizationToken ( const std::string & token );

設定將用於連線至服務的授權令牌。 注意：呼叫端必須確定授權令牌有效。 授權令牌到期之前，呼叫端必須以新的有效令牌呼叫此 setter 來重新整理它。 否則，辨識器會在辨識期間發生錯誤。

參數

  • token 代表授權令牌的字串。

GetAuthorizationToken

語法：public inline std::string GetAuthorizationToken ( );

取得授權令牌。

返回

授權令牌

ApplyLanguageModels

語法：public inline bool ApplyLanguageModels ( const std::vector< std::shared_ptr< LanguageUnderstandingModel > > & collection );

採用語言理解模型的集合、製作其復本，並將其套用至辨識器。 此應用程式會根據語言理解模型類型而不同時間發生。 簡單語言模型幾乎會立即變成作用中，而使用 LUIS 的語言理解模型將在下一個語音回合中變成作用中。 這會取代任何先前套用的模型。

參數

  • collection LanguageUnderstandingModels 的共享指標向量。

返回

如果模型的應用程式立即生效，則為 True。 否則為 false。

FromConfig

語法：public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< SpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );

從語音設定和音訊設定建立意圖辨識器。用戶應該使用此函式來建立意圖辨識器的新實例。

參數

  • speechConfig 語音設定。

  • audioInput 音訊設定。

返回

意圖辨識器的實例。

FromConfig

語法：public inline static std::shared_ptr< IntentRecognizer > FromConfig ( std::shared_ptr< EmbeddedSpeechConfig > speechConfig , std::shared_ptr< Audio::AudioConfig > audioInput );

從內嵌語音組態和音訊設定建立意圖辨識器。用戶應該使用此函式來建立意圖辨識器的新實例。 已在1.19.0版中新增。

參數

  • speechConfig 內嵌語音設定。

  • audioInput 音訊設定。

返回

意圖辨識器的實例。

BaseType

語法：typedef BaseType;