Class KeywordRecognizer

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) Quindi, gli eventi devono 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

Riconosciuto

Sintassi: public EventSignal< const KeywordRecognitionEventArgs & > Recognized;

Segnalare gli eventi correlati al riconoscimento delle parole chiave.

Annullato

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

Raccolta di proprietà e dei relativi valori definiti per keywordRecognizer.

~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 durerà fino a quando non viene riconosciuta la prima parola chiave. In questo caso, verrà generato un evento riconosciuto e la sessione terminerà. Per riprogemare la parola chiave, è necessario chiamare nuovamente il metodo dopo l'emissione dell'evento.

Parametri

Restituzioni

Un futuro che si risolve in un KeywordRecognitionResult che viene risolto 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 attualmente attiva.

Restituzioni

Un futuro che si 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 oggetto AudioConfig. La configurazione è progettata per definire l'input audio da usare dall'oggetto recognizer.

Parametri

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

Restituzioni

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

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

  • Last updated on