Compartilhar via

classe KeywordRecognizer

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

Tipo de reconhecedor especializado para lidar apenas com palavra-chave ativação.

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

Sinal para eventos relacionados ao reconhecimento de palavras-chave.

Canceled

Sintaxe: public EventSignal< constSpeechRecognitionCanceledEventArgs & > 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 constPropertyCollection & 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 o primeiro palavra-chave seja reconhecido. Quando isso acontecer, um evento Reconhecido será gerado e a sessão terminará. Para rearmá-lo palavra-chave, o método precisa ser chamado novamente após o evento ser emitido.

Parâmetros

Retornos

Um futuro que é resolvido para um KeywordRecognitionResult que é resolvido depois que um palavra-chave é detectado.

Observe que, se nenhuma palavra-chave for detectada na entrada, a tarefa nunca resolve (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.

Retornos

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 um KeywordRecognizer 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.

Retornos

Um novo KeywordRecognizer que consumirá áudio da entrada especificada.

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