Skip to main content

XSpeechToTextBeginHypothesisString

仮説を開始し、その文字列をテキスト オーバーレイに表示します。

構文

パラメーター

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日