Sdílet prostřednictvím

Třída KeywordRecognizer

  • Článek
class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Typ rozpoznávání, který je specializovaný pouze na zpracování aktivace klíčových slov.

Nejprve je potřeba vytvořit instanci objektu:

auto audioConfig = AudioConfig::FromMicrophoneInput(); // Or an alternative input
auto recognizer = [KeywordRecognizer::FromConfig](#fromconfig)(audioConfig);

(volitelné) Aby bylo možné přijímat oznámení, musí být události připojeny kabelem:

recognizer->Recognized += [](const KeywordRecognitionEventArgs& event)
{
    // Your logic here...
};

A nakonec je potřeba zahájit rozpoznávání.

auto keywordModel = [KeywordRecognitionModel::FromFile](keywordrecognitionmodel.md#fromfile)(modelPath);
auto resultFuture = recognizer->RecognizeKeywordOnceAsync(keywordModel);
resultFuture.wait();
auto result = resultFuture.get();

Členové

Rozpoznán

Syntaxe: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

Signál pro události související s rozpoznáváním klíčových slov.

Zrušeno

Syntaxe: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Signál pro události související se zrušením interakce. Událost označuje, jestli je důvodem přímé zrušení nebo chyba.

Vlastnosti

Syntaxe: public constPropertyCollection & Properties;

Kolekce vlastností a jejich hodnoty definované pro tento KeywordRecognizer.

~KeywordRecognizer

Syntaxe: public inline ~KeywordRecognizer ( );

Destruktor.

RecognizeOnceAsync

Syntaxe: public inline std::future< std::shared_ptr< KeywordRecognitionResult > > RecognizeOnceAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Spustí relaci rozpoznávání klíčových slov. Tato relace bude trvat, dokud se nerozpozná první klíčové slovo. Když k tomu dojde, vyvolá se událost Recognized a relace se ukončí. Chcete-li změnit klíčové slovo, musí být metoda volána znovu po vygenerované události.

Parametry

Návraty

Budoucnost, která se přeloží na KeywordRecognitionResult , který se vyřeší po zjištění klíčového slova.

Všimněte si, že pokud se ve vstupu nezjistí žádné klíčové slovo, úloha se nikdy nepřeloží (pokud není volána funkce StopRecognition.

StopRecognitionAsync

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

Zastaví aktuálně aktivní relaci rozpoznávání klíčových slov.

Návraty

Budoucnost, která se vyřeší, když se aktivní relace (pokud existuje) zastaví.

Zkonfigurovat

Syntaxe: public inline static std::shared_ptr< KeywordRecognizer > FromConfig ( std::shared_ptr< Audio::AudioConfig > audioConfig );

Vytvoří KeywordRecognizer z AudioConfig. Konfigurace je určena k definování zvukového vstupu, který má objekt rozpoznávání používat.

Parametry

  • audioConfig Definuje zvukový vstup, který má být používán rozpoznáváním.

Návraty

Nový KeywordRecognizer, který bude využívat zvuk ze zadaného vstupu.

Pokud není k dispozici žádná konfigurace zvuku, bude ekvivalentní volání s konfigurací vytvořenou pomocí AudioConfig::FromDefaultMicrophoneInput.