Skip to main content

XSpeechToTextBeginHypothesisString

开始一个假设,并在文本覆盖层中显示其字符串。

语法

参数

speakerName   _In_z_
类型:char*
要与假设字符串一同显示的说话者名称。 content   _In_z_
类型:char*
初始的假设字符串。 type   _In_
类型:XSpeechToTextType
假设字符串的源类型。 hypothesisId   _Out_
类型:uint32_t*
假设的 ID。

返回值

类型:HRESULT HRESULT 成功或错误代码。

备注

假设(hypothesis)是对说话者所说内容的一种推测,通常由语音识别器在说话者说到短语中间时生成。语音转文本覆盖层 API 可以在游戏画面上显示假设字符串。 语音转文本覆盖层 API 还支持键入的文本。type 参数用于标识假设字符串的源。 应用负责在假设被最终确定或取消之前保留 hypothesisId 的值。 若要更新覆盖层中的假设字符串,请使用 XSpeechToTextUpdateHypothesisString 若要取消假设并将其从覆盖层中移除,请使用 XSpeechToTextCancelHypothesisString 若要最终确定假设,请使用 XSpeechToTextFinalizeHypothesisString 在某些平台上,假设字符串在应用调用 XSpeechToTextFinalizeHypothesisString 之前不会显示。除非取消假设,否则你的应用必须始终调用 XSpeechToTextFinalizeHypothesisString 以确保该字符串得以显示。 以下代码示例展示了一个应用创建假设、更新假设,然后将其最终确定的过程。
以下代码示例展示了一个应用创建假设、更新假设,然后将其取消的过程。

要求

头文件: XAccessibility.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

XAccessibility
最后修改于 2026年8月24日