classe KeywordRecognizer

class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

Tipo de reconhecedor especializado para manipular apenas a ativação da palavra-chave.

Primeiro, o objeto precisa ser instanciado:

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

(opcional) Em seguida, os eventos precisam ser conectados para receber notificações:

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

E, por fim, o reconhecimento precisa ser iniciado.

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

Membros

Reconhecido

Sintaxe: public EventSignal< const KeywordRecognitionEventArgs & > Recognized;

Sinal para eventos relacionados ao reconhecimento de palavras-chave.

Cancelado

Sintaxe: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

Sinal para eventos relacionados ao cancelamento de uma interação. O evento indica se o motivo é um cancelamento direto ou um erro.

Propriedades

Sintaxe: public const PropertyCollection & Properties;

Uma coleção de propriedades e seus valores definidos para este KeywordRecognizer.

~KeywordRecognizer

Sintaxe: public inline ~KeywordRecognizer ( );

Destruidor.

RecognizeOnceAsync

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

Inicia uma sessão de reconhecimento de palavra-chave. Esta sessão durará até que a primeira palavra-chave seja reconhecida. Quando isso acontecer, um evento Recognized será acionado e a sessão será encerrada. Para rearmar a palavra-chave, o método precisa ser chamado novamente depois que o evento é emitido.

Parâmetros

  • model a palavra-chave RecognitionModel que descreve a palavra-chave que queremos detectar.

Devoluções

Um futuro que é resolvido para um KeywordRecognitionResult que é resolvido quando uma palavra-chave é detectada.

Observe que, se nenhuma palavra-chave for detectada na entrada, a tarefa nunca será resolvida (a menos que StopRecognition seja chamado.

StopRecognitionAsync

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

Interrompe uma sessão de reconhecimento de palavra-chave ativa no momento.

Devoluções

Um futuro que é resolvido quando a sessão ativa (se houver) é interrompida.

FromConfig

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

Cria uma palavra-chaveRecognizer de um AudioConfig. A configuração destina-se a definir a entrada de áudio a ser usada pelo objeto reconhecedor.

Parâmetros

  • audioConfig Define a entrada de áudio a ser usada pelo reconhecedor.

Devoluções

Uma nova palavra-chaveRecognizer que consumirá áudio da entrada especificada.

Se nenhuma configuração de áudio for fornecida, ela será equivalente à chamada com uma configuração construída com AudioConfig::FromDefaultMicrophoneInput

  • Last updated on