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