Sdílet prostřednictvím

class Intent::IntentRecognizer

  • Článek
class Intent::IntentRecognizer
  : public AsyncRecognizer< IntentRecognitionResult, IntentRecognitionEventArgs, IntentRecognitionCanceledEventArgs >

Kromě rozpoznávání řeči na text extrahuje objekt IntentRecognizer strukturované informace o záměru mluvčího, který lze použít k řízení dalších akcí pomocí vyhrazených triggerů záměru (viz IntentTrigger).

Členové

Vlastnosti

Syntaxe: public PropertyCollection & Properties;

Kolekce vlastností a jejich hodnot definovaných pro tento intentRecognizer.

IntentRecognizer

Syntaxe: public inline explicit IntentRecognizer ( SPXRECOHANDLE hreco );

Interní konstruktor. Vytvoří novou instanci pomocí poskytnutého popisovače.

Parametry

  • hreco popisovač rozpoznávání.

~IntentRecognizer

Syntaxe: public inline ~IntentRecognizer ( );

destruktor

RecognizeOnceAsync

Syntaxe: public inline virtual std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( );

Spustí rozpoznávání záměru a vrátí se po rozpoznání jedné promluvy. Konec jedné promluvy je určen poslechem ticha na konci nebo až do zpracování maximálně 30 sekund zvuku. Úkol vrátí text rozpoznávání jako výsledek. Poznámka: Vzhledem k tomu, že funkce RecognizeOnceAsync() vrací jenom jednu promluvu, je vhodná pouze pro rozpoznávání jednoho snímku, jako je příkaz nebo dotaz. Pro dlouhotrvající rozpoznávání více promluv použijte místo toho StartContinuousRecognitionAsync().

Návraty

Budoucnost obsahující výslednou hodnotu (sdílený ukazatel na IntentRecognitionResult) asynchronního rozpoznávání záměru.

RecognizeOnceAsync

Syntaxe: public inline std::future< std::shared_ptr< IntentRecognitionResult > > RecognizeOnceAsync ( std::string text );

Spustí rozpoznávání záměru a vygeneruje výsledek předaného textu. To je užitečné pro testování a jindy, když vstup řeči není vázán na IntentRecognizer. Poznámka: Služba záměru tuto funkci v současné době nepodporuje, takže je platná pouze pro porovnávání offline vzorů nebo přesných odpovídajících záměrů.

Parametry

  • text Text, který se má vyhodnotit.

Návraty

Budoucnost obsahující výslednou hodnotu (sdílený ukazatel na IntentRecognitionResult) asynchronního rozpoznávání záměru.

StartContinuousRecognitionAsync

Syntaxe: public inline virtual std::future< void > StartContinuousRecognitionAsync ( );

Asynchronně inicializuje operaci průběžného rozpoznávání záměru.

Návraty

Prázdná budoucnost.

StopContinuousRecognitionAsync

Syntaxe: public inline virtual std::future< void > StopContinuousRecognitionAsync ( );

Asynchronně ukončí probíhající průběžnou operaci rozpoznávání záměru.

Návraty

Prázdná budoucnost.

StartKeywordRecognitionAsync

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

Asynchronně zahájí operaci rozpoznávání klíčových slov.

Parametry

  • model Určuje model klíčových slov, který se má použít.

Návraty

Prázdná budoucnost.

StopKeywordRecognitionAsync

Syntaxe: public inline virtual std::future< void > StopKeywordRecognitionAsync ( );

Asynchronně ukončí operaci rozpoznávání klíčových slov.

Návraty

Prázdná budoucnost.

AddIntent

Syntaxe: public inline void AddIntent ( const std::string & simplePhrase );

Přidá jednoduchou frázi, kterou může uživatel vyslovit, což označuje konkrétní záměr uživatele. Tato jednoduchá fráze může být vzor, včetně a nitity obklopené složenými závorkami. Například "klikněte na zaškrtávací políčko {checkboxName}".

Parametry

  • simplePhrase frázi odpovídající záměru.

Po rozpoznání se vlastnost IntentRecognitionResult IntentId shoduje se zadaným jednoduchým frázem. Pokud jsou zadané a odpovídající entity, budou k dispozici ve volání IntentResult–>GetEntities().

AddIntent

Syntaxe: public inline void AddIntent ( const std::string & simplePhrase , const std::string & intentId );

Přidá jednoduchou frázi, kterou může uživatel vyslovit, což označuje konkrétní záměr uživatele. Tato jednoduchá fráze může být vzor, včetně a nitity obklopené složenými závorkami. Například "klikněte na zaškrtávací políčko {checkboxName}".

Parametry

  • simplePhrase frázi odpovídající záměru.

  • intentId řetězec vlastního ID, který se má vrátit ve vlastnosti IntentRecognitionResult IntentId.

Po rozpoznání se ID záměru výsledku bude shodovat s ID zadaným zde. Pokud jsou zadané a odpovídající entity, budou k dispozici ve volání IntentResult–>GetEntities().

AddIntent

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

Přidá jeden záměr podle názvu ze zadaného modelu Language Understanding. U typů PatternMatchingModel a ConversationalLanguageUnderstandingModel se před povolením vymažou všechny existující modely. U těchto typů je záměrName ignorován.

Parametry

  • model model pro porozumění jazyku obsahující záměr.

  • intentName Název jediného záměru, který se má zahrnout z modelu language understanding.

Po rozpoznání bude vlastnost IntentRecognitionResult IntentId obsahovat intentName zadaný zde.

AddIntent

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

Přidá jeden záměr podle názvu ze zadaného modelu Language Understanding. U typů PatternMatchingModel a ConversationalLanguageUnderstandingModel se před povolením vymažou všechny existující modely. U těchto typů se záměrName a intentId ignorují.

Parametry

  • model model pro porozumění jazyku obsahující záměr.

  • intentName Název jediného záměru, který se má zahrnout z modelu language understanding.

  • intentId řetězec vlastního ID, který se má vrátit ve vlastnosti IntentRecognitionResult IntentId.

AddAllIntents

Syntaxe: public inline void AddAllIntents ( std::shared_ptr< LanguageUnderstandingModel > model );

Přidá všechny záměry ze zadaného modelu Language Understanding. U typů PatternMatchingModel a ConversationalLanguageUnderstandingModel se před povolením vymažou všechny existující modely.

Parametry

  • model model pro porozumění jazyku obsahující záměry.

Po rozpoznání bude vlastnost IntentRecognitionResult IntentId obsahovat název rozpoznaného záměru.

AddAllIntents

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

Přidá všechny záměry ze zadaného modelu Language Understanding. U typů PatternMatchingModel a ConversationalLanguageUnderstandingModel se před povolením vymažou všechny existující modely.

Parametry

  • model model pro porozumění jazyku obsahující záměry.

  • intentId ID vlastního řetězce, které se má vrátit ve vlastnosti IntentRecognitionResult IntentId.

AddIntent

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

Přidá zadaný IntentTrigger.

Parametry

  • trigger IntentTrigger odpovídající záměru.

  • intentId ID vlastního řetězce, které se má vrátit ve vlastnosti IntentRecognitionResult IntentId.

SetAuthorizationToken

Syntaxe: public inline void SetAuthorizationToken ( const std::string & token );

Nastaví autorizační token, který se použije pro připojení ke službě. Poznámka: Volající musí zajistit platnost autorizačního tokenu. Než vyprší platnost autorizačního tokenu, volající ho musí aktualizovat zavoláním tohoto setteru s novým platným tokenem. V opačném případě se během rozpoznávání zobrazí chyby.

Parametry

  • token řetězec, který představuje autorizační token.

GetAuthorizationToken

Syntaxe: public inline std::string GetAuthorizationToken ( );

Získá autorizační token.

Návraty

Autorizační token

ApplyLanguageModels

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

Vezme kolekci modelů porozumění jazyku, vytvoří jejich kopii a použije je na rozpoznávání. K této aplikaci dochází v různých časech v závislosti na typu modelu pro porozumění jazyku. Jednoduché jazykové modely budou aktivní téměř okamžitě, zatímco modely rozpoznávání jazyka využívající službu LUIS se stanou aktivními na dalším turnu řeči. Tím se nahradí všechny dříve použité modely.

Parametry

  • collection Vektor sdílených ukazatelů na LanguageUnderstandingModels.

Návraty

True, pokud se aplikace modelů projeví okamžitě. Jinak nepravda.

FromConfig

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

Vytvoří rozpoznávání záměru z konfigurace řeči a konfigurace zvuku. Uživatelé by tuto funkci měli použít k vytvoření nové instance rozpoznávání záměru.

Parametry

  • speechConfig konfigurace služby Speech.

  • konfigurace zvuku audioInput.

Návraty

Instance rozpoznávání záměru

FromConfig

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

Vytvoří rozpoznávání záměru z vložené konfigurace řeči a konfigurace zvuku. Uživatelé by tuto funkci měli použít k vytvoření nové instance rozpoznávání záměru. Přidáno ve verzi 1.19.0.

Parametry

  • speechConfig Vložená konfigurace řeči

  • konfigurace zvuku audioInput.

Návraty

Instance rozpoznávání záměru

BaseType

Syntaxe: typedef BaseType;