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 本体