Skip to main content

XSpeechToTextBeginHypothesisString

開始一個假設,並在文字覆疊中顯示其字串。

語法

參數

speakerName   _In_z_
類型:char*
要與假設字串一起顯示的說話者名稱。 content   _In_z_
類型:char*
初始假設字串。 type   _In_
類型:XSpeechToTextType
假設字串的來源類型。 hypothesisId   _Out_
類型:uint32_t*
假設的識別碼。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

假設是對說話者所說內容的猜測,通常由語音辨識器在說話者說到一半時產生。語音轉文字覆疊 API 可以在遊戲畫面上顯示假設字串。 語音轉文字覆疊 API 也支援輸入的文字。type 參數會識別假設字串的來源。 應用程式負責保留 hypothesisId 的值,直到假設完成或取消為止。 若要更新覆疊中的假設字串,請使用 XSpeechToTextUpdateHypothesisString。 若要取消假設並將其從覆疊中移除,請使用 XSpeechToTextCancelHypothesisString。 若要完成假設,請使用 XSpeechToTextFinalizeHypothesisString。 在某些平台上,必須等到應用程式呼叫 XSpeechToTextFinalizeHypothesisString 之後,才會顯示假設字串。除非假設已取消,否則您的應用程式一律必須呼叫 XSpeechToTextFinalizeHypothesisString,以確保字串會顯示。 下列程式碼範例示範應用程式建立假設、更新假設,然後完成假設。
下列程式碼範例示範應用程式建立假設、更新假設,然後取消假設。

需求

標頭: XAccessibility.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

XAccessibility
Last modified on October 6, 2026