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

VerifyUserKeyword 메서드는 학습 사용자 환경에서 학습 중에 캡처된 음성 발화의 한 인스턴스가 일부 허용 오차 내에서 미리 정의된 키워드와 일치하는지 확인하는 데 사용됩니다.

구문

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에서 키워드의 끝을 나타냅니다.

[in] UserRecording

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

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

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

반환 값

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

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

설명

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

	훈련	인식
모드	원시	음성
Pin	정상	버스트
오디오 형식	32비트 float(Type = Audio, Subtype = IEEE_FLOAT, 샘플링 속도 = 16kHz, 비트 = 32)	OS 오디오 스택에서 관리
마이크	마이크 0	배열의 모든 마이크

요구 사항

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

참고 항목

IKeywordDetectorOemAdapter

IMFMediaType

KEYWORDID