Třída KeywordRecognizer

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é) Události pak musí být kabelové, aby bylo možné dostávat oznámení:

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

A konečně, rozpoznávání musí být spuštěno.

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

Členové

Uznáno

Syntaxe: public EventSignal< const KeywordRecognitionEventArgs & > Recognized;

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

Zrušeno

Syntaxe: public EventSignal< const SpeechRecognitionCanceledEventArgs & > 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 const PropertyCollection & Properties;

Kolekce vlastností ajejichch

~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. V takovém případě se vyvolá událost Rozpoznaná a relace skončí. Aby bylo možné klíčové slovo změnit, je potřeba metodu volat 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 nevyřeší (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ž je aktivní relace zastavená (pokud existuje).

FromConfig

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

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

Parametry

  • audioConfig Definuje zvukový vstup, který bude používat rozpoznávání.

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í konstruovanou pomocí AudioConfig::FromDefaultMicrophoneInput

  • Last updated on