Partilhar via

classe KeywordRecognizer

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

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

Primeiro, o objeto tem de ser instanciado:

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

(opcional) Em seguida, os eventos têm de ser transferidos para receber notificações:

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

Por fim, o reconhecimento tem de 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 de eventos relacionados com o reconhecimento de palavras-chave.

Cancelado

Sintaxe: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Sinal de eventos relacionados com o 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 os respetivos valores definidos para este KeywordRecognizer.

~KeywordRecognizer

Sintaxe: public inline ~KeywordRecognizer ( );

Destrutor.

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 isto acontece, será gerado um evento Reconhecido e a sessão terminará. Para rearmar a palavra-chave, o método tem de ser chamado novamente depois de o evento ser emitido.

Parâmetros

Devoluções

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

Tenha em atenção que se não for detetada nenhuma palavra-chave na entrada, a tarefa nunca será resolvida (a menos que StopRecognition seja chamada.

StopRecognitionAsync

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

Para uma sessão de reconhecimento de palavras-chave atualmente ativa.

Devoluções

Um futuro que é resolvido quando a sessão ativa (se existir) é parada.

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 utilizada pelo objeto de reconhecimento.

Parâmetros

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

Devoluções

Um novo KeywordRecognizer que irá consumir áudio a partir da entrada especificada.

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