Skip to main content

XSpeechToTextBeginHypothesisString

가설(hypothesis)을 시작하고 그 문자열을 텍스트 오버레이에 표시합니다.

구문

매개 변수

speakerName   _In_z_
형식: char*
가설 문자열과 함께 표시할 화자의 이름입니다. content   _In_z_
형식: char*
초기 가설 문자열입니다. type   _In_
형식: XSpeechToTextType
가설 문자열의 원본 유형입니다. hypothesisId   _Out_
형식: uint32_t*
가설의 ID입니다.

반환 값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.

설명

가설이란 화자가 말하는 내용에 대한 추측으로, 일반적으로 화자가 문구를 말하는 도중에 음성 인식기가 생성합니다. 음성-텍스트 오버레이 API는 게임 화면 위에 가설 문자열을 표시할 수 있습니다. 음성-텍스트 오버레이 API는 입력한 텍스트도 지원합니다. type 매개 변수는 가설 문자열의 원본을 식별합니다. 앱은 가설이 확정되거나 취소될 때까지 hypothesisId 값을 유지해야 합니다. 오버레이의 가설 문자열을 업데이트하려면 XSpeechToTextUpdateHypothesisString을 사용합니다. 가설을 취소하고 오버레이에서 제거하려면 XSpeechToTextCancelHypothesisString을 사용합니다. 가설을 확정하려면 XSpeechToTextFinalizeHypothesisString을 사용합니다. 일부 플랫폼에서는 앱이 XSpeechToTextFinalizeHypothesisString을 호출할 때까지 가설 문자열이 표시되지 않습니다. 가설이 취소되지 않는 한, 앱은 문자열이 표시되도록 하기 위해 항상 XSpeechToTextFinalizeHypothesisString을 호출해야 합니다. 다음 코드 예제는 앱이 가설을 만들고, 업데이트한 다음 확정하는 방법을 보여줍니다.
다음 코드 예제는 앱이 가설을 만들고, 업데이트한 다음 취소하는 방법을 보여줍니다.

요구 사항

헤더: XAccessibility.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

XAccessibility
마지막 수정일 2026년 8월 24일