次の方法で共有


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

関連項目

XAccessibility