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