classe KeywordRecognizer

  • Articolo
class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Tipo di riconoscimento specializzato per gestire solo l'attivazione delle parole chiave.

Prima di tutto, è necessario creare un'istanza dell'oggetto:

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

(facoltativo) Gli eventi devono quindi essere cablati per ricevere notifiche:

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

Infine, il riconoscimento deve essere avviato.

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

Membri

Recognized

Sintassi: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

Segnale per gli eventi correlati al riconoscimento delle parole chiave.

Cancellati

Sintassi: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Segnale per gli eventi relativi all'annullamento di un'interazione. L'evento indica se il motivo è un annullamento diretto o un errore.

Proprietà

Sintassi: public constPropertyCollection & Properties;

Raccolta di proprietà e relativi valori definiti per questa parola chiaveRecognizer.

~KeywordRecognizer

Sintassi: public inline ~KeywordRecognizer ( );

Distruttore.

RecognizeOnceAsync

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

Avvia una sessione di riconoscimento delle parole chiave. Questa sessione dura fino a quando non viene riconosciuta la prima parola chiave. In questo caso, verrà generato un evento riconosciuto e la sessione terminerà. Per rimettere la parola chiave, il metodo deve essere chiamato di nuovo dopo che l'evento viene generato.

Parametri

Restituisce

Futuro che si risolve in una parola chiaveRecognitionResult che risolve una volta rilevata una parola chiave.

Si noti che se non viene rilevata alcuna parola chiave nell'input, l'attività non verrà mai risolta(a meno che non venga chiamata StopRecognition.

StopRecognitionAsync

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

Arresta una sessione di riconoscimento delle parole chiave attiva.

Restituisce

Futuro che risolve quando la sessione attiva (se presente) viene arrestata.

FromConfig

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

Crea una parola chiaveRecognizer da un AudioConfig. La configurazione è destinata a definire l'input audio da usare dall'oggetto riconoscimento.

Parametri

  • audioConfig Definisce l'input audio da usare dal riconoscimento.

Restituisce

Nuovo keywordRecognizer che utilizzerà l'audio dall'input specificato.

Se non viene fornita alcuna configurazione audio, sarà equivalente alla chiamata con una configurazione costruita con AudioConfig::FromDefaultMicrophoneInput