Método IKeywordDetectorOemAdapter::VerifyUserKeyword (keyworddetectoroemadapter.h)

Artigo
02/07/2025

O método VerifyUserKeyword é usado pela experiência do usuário de treinamento para verificar se uma instância de um enunciado falado, capturada durante o treinamento, corresponde a uma palavra-chave predefinida dentro de alguma tolerância.

Sintaxe

HRESULT VerifyUserKeyword(
  [in] IStream        *ModelData,
  [in] KEYWORDID      KeywordId,
  [in] LANGID         LangId,
  [in] LONG           KeywordEndBytePos,
  [in] IMFMediaBuffer *UserRecording
);

Parâmetros

[in] ModelData

Um ponteiro para um objeto IStream associado a dados de modelo para um determinado modelo armazenado. Na chamada inicial, isso estará vazio.

[in] KeywordId

O KEYWORDID no parâmetro UserRecording.

[in] LangId

O LANGID do idioma falado no parâmetro UserRecording do.

[in] KeywordEndBytePos

Indica o final da palavra-chave no UserRecording.

[in] UserRecording

Um ponteiro para o buffer que contém os dados brutos no formato IMFMediaType apropriado.

A gravação do usuário deve ter os seguintes atributos:

Tipo = Áudio
Subtipo = IEEE_FLOAT
Taxa de Amostragem = 16 kHz
Bits = 32

Valor de retorno

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	A função foi encerrada com êxito.
E_NOTIMPL	Não há suporte para o treinamento de palavra-chave do usuário para o dispositivo.
E_INVALIDARG	Uma ou mais das seguintes condições são verdadeiras: O ponteiro ModelData é NULL. O parâmetro KeywordId é inválido. O parâmetro LangId é inválido.
E_NO_MATCH	A gravação do usuário não continha a palavra-chave especificada.

Observações

Observe que o áudio é processado de maneira exclusiva para o treinamento de ativação de voz. A tabela a seguir resume as diferenças entre o treinamento de ativação de voz e o uso regular de reconhecimento de voz.

	de treinamento do	de Reconhecimento de
Modo	Cru	Discurso
Alfinete	Normal	Irromper
Formato de áudio	Float de 32 bits (Tipo = Áudio, Subtipo = IEEE_FLOAT, Taxa de Amostragem = 16 kHz, bits = 32)	Gerenciado pela pilha de áudio do sistema operacional
Microfone	Microfone 0	Todos os microfones na matriz

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
cabeçalho	keyworddetectoroemadapter.h

Consulte também

IKeywordDetectorOemAdapter

IMFMediaType

KEYWORDID

Compartilhar via