Udostępnij za pośrednictwem

class KeywordRecognizer

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

Typ rozpoznawania, który jest 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...
};

I wreszcie 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< constKeywordRecognitionEventArgs & > Recognized;

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

Anulowane

Składnia: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

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

Właściwości

Składnia: public constPropertyCollection & 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 rozpoznane zdarzenie, a sesja zostanie zakończona. Aby zmienić nazwę słowa kluczowego, należy wywołać metodę ponownie po wyemitowaniu zdarzenia.

Parametry

Zwraca

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

Należy pamiętać, że jeśli w danych wejściowych nie zostanie wykryte żadne słowo kluczowe, 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 element KeywordRecognizer z pliku AudioConfig. Konfiguracja ma na celu zdefiniowanie danych wejściowych dźwięku, które mają być używane przez obiekt rozpoznawania.

Parametry

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

Zwraca

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

Jeśli nie zostanie podana żadna konfiguracja audio, będzie ona równoważna wywołaniu za pomocą konfiguracji skonstruowanej za pomocą elementu AudioConfig::FromDefaultMicrophoneInput