Compartir a través de

Class KeywordRecognizer

  • Artículo
class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Tipo de reconocedor especializado para controlar solo la activación de palabras clave.

En primer lugar, se debe crear una instancia del objeto:

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

(opcional) A continuación, los eventos deben estar conectados para recibir notificaciones:

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

Y, por último, es necesario iniciar el reconocimiento.

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

Miembros

Reconocido

Sintaxis: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

Señal de eventos relacionados con el reconocimiento de palabras clave.

Canceled

Sintaxis: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Señal de eventos relacionados con la cancelación de una interacción. El evento indica si el motivo es una cancelación directa o un error.

Propiedades

Sintaxis: public constPropertyCollection & Properties;

Colección de propiedades y sus valores definidos para este KeywordRecognizer.

~KeywordRecognizer

Sintaxis: public inline ~KeywordRecognizer ( );

Destructor.

RecognizeOnceAsync

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

Inicia una sesión de reconocimiento de palabras clave. Esta sesión durará hasta que se reconozca la primera palabra clave. Cuando esto sucede, se generará un evento Reconocido y finalizará la sesión. Para rediseñar la palabra clave, el método debe llamarse de nuevo después de emitir el evento.

Parámetros

Devoluciones

Un futuro que se resuelve en un KeywordRecognitionResult que se resuelve una vez que se detecta una palabra clave.

Tenga en cuenta que si no se detecta ninguna palabra clave en la entrada, la tarea nunca se resolverá (a menos que se llame a StopRecognition.

StopRecognitionAsync

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

Detiene una sesión de reconocimiento de palabras clave actualmente activa.

Devoluciones

Un futuro que se resuelve cuando se detiene la sesión activa (si existe).

FromConfig

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

Crea un KeywordRecognizer a partir de un objeto AudioConfig. La configuración está pensada para definir la entrada de audio que va a usar el objeto recognizer.

Parámetros

  • audioConfig Define la entrada de audio que va a usar el reconocedor.

Devoluciones

Nuevo KeywordRecognizer que consumirá audio de la entrada especificada.

Si no se proporciona ninguna configuración de audio, será equivalente a llamar a con una configuración construida con AudioConfig::FromDefaultMicrophoneInput.