IKeywordDetectorOemAdapter::VerifyUserKeyword 메서드(keyworddetectoroemadapter.h)

VerifyUserKeyword 메서드는 학습 사용자 환경에서 학습 중에 캡처된 음성 발언의 instance 하나가 일부 허용 오차 내에서 미리 정의된 키워드(keyword) 일치하는지 확인하는 데 사용됩니다.

구문

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

매개 변수

[in] ModelData

지정된 저장된 모델의 모델 데이터에 바인딩된 IStream 개체에 대한 포인터입니다. 초기 호출 시 비어 있습니다.

[in] KeywordId

UserRecording 매개 변수의 KEYWORDID입니다.

[in] LangId

UserRecording 매개 변수에 있는 음성 언어의 LANGID입니다.

[in] KeywordEndBytePos

UserRecording에서 키워드(keyword) 끝을 나타냅니다.

[in] UserRecording

적절한 IMFMediaType 형식의 원시 데이터를 포함하는 버퍼에 대한 포인터입니다.

사용자 기록에는 다음 특성이 있어야 합니다.

• 형식 = 오디오
• 하위 유형 = IEEE_FLOAT
• 샘플링 속도 = 16kHz
• 비트 = 32

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	함수가 성공적으로 종료되었습니다.
E_NOTIMPL	사용자 키워드(keyword) 학습은 디바이스에서 지원되지 않습니다.
E_INVALIDARG	다음 조건 중 하나 이상이 true입니다. ModelData 포인터가 NULL입니다. KeywordId 매개 변수가 잘못되었습니다. LangId 매개 변수가 잘못되었습니다.
E_NO_MATCH	사용자 기록에 지정된 키워드(keyword) 포함되지 않았습니다.

설명

오디오는 음성 활성화 학습을 위한 고유한 방식으로 처리됩니다. 다음 표에서는 음성 활성화 학습과 일반 음성 인식 사용 간의 차이점을 요약합니다.

	훈련	인식
모드	Raw	음성
Pin	보통	버스트
오디오 형식	32비트 float(Type = Audio, Subtype = IEEE_FLOAT, 샘플링 속도 = 16kHz, bits = 32)	OS 오디오 스택으로 관리
마이크	마이크 0	배열의 모든 마이크

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10
지원되는 최소 서버	Windows Server 2016
대상 플랫폼	Windows
헤더	keyworddetectoroemadapter.h

추가 정보

IKeywordDetectorOemAdapter

IMFMediaType

KEYWORDID