class KeywordRecognizer

  • Artykuł 
class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Typ rozpoznawania wyspecjalizowany do obsługi aktywacji słów kluczowych.

Najpierw należy utworzyć wystąpienie obiektu:

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

(opcjonalnie) Następnie zdarzenia muszą być przewodowe, aby otrzymywać powiadomienia:

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

Na koniec należy uruchomić rozpoznawanie.

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

Elementy członkowskie

Rozpoznawane

Składnia: public EventSignal< const KeywordRecognitionEventArgs & > Recognized;

Sygnał dla zdarzeń związanych z rozpoznawaniem słów kluczowych.

Anulowane

Składnia: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

Sygnał dla zdarzeń związanych z anulowaniem interakcji. Zdarzenie wskazuje, czy przyczyną jest bezpośrednie anulowanie lub błąd.

Właściwości

Składnia: public const PropertyCollection & Properties;

Kolekcja właściwości i ich wartości zdefiniowanych dla tego słowa kluczowegoRecognizer.

~KeywordRecognizer

Składnia: public inline ~KeywordRecognizer ( );

Destruktora.

RecognizeOnceAsync

Składnia: public inline std::future< std::shared_ptr< KeywordRecognitionResult > > RecognizeOnceAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Uruchamia sesję rozpoznawania słów kluczowych. Ta sesja będzie trwać do momentu rozpoznania pierwszego słowa kluczowego. W takim przypadku zostanie zgłoszone zdarzenie Rozpoznane , a sesja zostanie zakończona. Aby zmienić słowo kluczowe, metoda musi zostać wywołana ponownie po emisji zdarzenia.

Parametry

Zwraca

Przyszłość, która rozpoznaje słowo kluczoweRecognitionResult , który rozpoznaje po wykryciu słowa kluczowego.

Należy pamiętać, że jeśli żadne słowo kluczowe nie zostanie wykryte w danych wejściowych, zadanie nigdy nie zostanie rozpoznane (chyba że zostanie wywołana funkcja StopRecognition.

StopRecognitionAsync

Składnia: public inline std::future< void > StopRecognitionAsync ( );

Zatrzymuje obecnie aktywną sesję rozpoznawania słów kluczowych.

Zwraca

Przyszłość, która zostanie rozwiązana, gdy aktywna sesja (jeśli istnieje) zostanie zatrzymana.

Z konfiguracji

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

Tworzy słowo kluczoweRecognizer z pliku AudioConfig. Konfiguracja ma na celu zdefiniowanie danych wejściowych dźwięku używanych przez obiekt rozpoznawania.

Parametry

  • audioConfig Definiuje dane wejściowe audio, które mają być używane przez rozpoznawanie.

Zwraca

Nowe słowo kluczoweRecognizer, które będzie używać dźwięku z określonych danych wejściowych.

Jeśli nie podano konfiguracji audio, będzie ona odpowiednikiem wywołania z konfiguracją skonstruowaną za pomocą elementu AudioConfig::FromDefaultMicrophoneInput