classe KeywordRecognizer

class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

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

Primeiro, o objeto precisa ser instanciado:

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

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

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

E, finalmente, 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 com o 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.

~Palavra-chaveRecognizer

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 palavras-chave. Esta sessão durará até que a primeira palavra-chave seja reconhecida. Quando isso acontecer, um evento de reconhecido será gerado 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

Devoluções

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

Observe que, se nenhuma palavra-chave for detetada 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 atualmente ativa.

Devoluções

Um futuro que se resolve 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 a partir 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

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

  • Last updated on