XSpeechToTextFinalizeHypothesisString
가설을 마무리하고 텍스트 오버레이의 문자열을 업데이트합니다.
구문
HRESULT XSpeechToTextFinalizeHypothesisString(
uint32_t hypothesisId,
const char* content
)
매개 변수
hypothesisId _In_
형식: uint32_t
XSpeechToTextBeginHypothesisString에서 반환된 가설 ID입니다.
content _In_z_
형식: char*
가설 문자열의 최종 버전입니다.
반환 값
형식: HRESULT
HRESULT 성공 또는 오류 코드입니다.
설명
이 함수는 가설을 마무리하고 해당 문자열을 오버레이 맨 아래로 이동하지 않고 제자리에서 업데이트합니다.
오버레이는 제한된 수의 문자열만 표시할 수 있습니다. 최대 수에 도달하면 이전 문자열은 만료됩니다. 만료된 문자열이 아직 확정되지 않았거나 취소되지 않은 가설이라면 해당 hypothesisId 값이 유효하지 않게 됩니다. 잘못된 hypothesisId 값을 전달해도 오류가 반환되지 않습니다.
가설 문자열을 마무리하지 않고 업데이트하려면 XSpeechToTextUpdateHypothesisString을 사용합니다.
가설을 취소하고 오버레이에서 제거하려면 XSpeechToTextCancelHypothesisString를 사용합니다.
일부 플랫폼에서는 앱에서 XSpeechToTextFinalizeHypothesisString을(를) 호출할 때까지 가설 문자열이 표시되지 않습니다. 가설이 취소되지 않는 한, 앱에서 항상 XSpeechToTextFinalizeHypothesisString을(를) 호출하여 문자열이 표시되도록 해야 합니다.
코드 예제는 XSpeechToTextBeginHypothesisString의 설명 섹션을 참조하세요.
요구 사항
헤더: XAccessibility.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔