> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# game_chat_speech_to_text_conversion_mode

> game_chat_speech_to_text_conversion_mode

# game\_chat\_speech\_to\_text\_conversion\_mode

定义 Game Chat 2 可用的语音转文本转换模式。

## 语法

```cpp theme={null}
enum class game_chat_speech_to_text_conversion_mode  
{  
    automatic,  
    title_managed,  
}  
```

## 常量

| 常量 | 描述 |
| - | - |
| automatic | 表示"自动"语音转文本转换模式。 如果本地用户已请求语音转文本,Game Chat 2 会自动转录与本地用户关联的传出音频以及与允许对本地用户说话的用户关联的传入音频。每次转录会作为 [game\_chat\_transcribed\_chat\_received\_state\_change](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/structs/game_chat_transcribed_chat_received_state_change.md) 状态更改提供给应用。应用应为已请求语音转文本的用户在屏幕上显示此消息。 |
| title\_managed | 表示"由标题管理"的语音转文本转换模式。 当用户请求语音转文本时,Game Chat 2 不会自动转录音频。当用户启用了语音转文本设置时(如 [chat\_user\_local::speech\_to\_text\_conversion\_preference\_enabled](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_speech_to_text_conversion_preference_enabled.md) 所指示),游戏本身负责转录音频。 |

## 备注

默认情况下,Game Chat 2 会自动管理支持语音转文本无障碍场景的大部分工作。在初始化 Game Chat 2 时,可以通过在 [chat\_manager::initialize](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_initialize.md) 方法的 `speechToTextConversion` 参数中指定 `title_managed`,允许游戏禁用此自动化工作,改为使用独立的语音转文本方案。有关初始化 Game Chat 2 的更多信息,请参阅 [使用 Game Chat 2 C++ API](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)。

## 需求

**头文件:** GameChat2.h

**支持的平台:** Windows、XBOX One 家族主机以及 XBOX Series 主机

## 另请参阅

[Game Chat 2 简介](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)\
[GameChat2 members](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/gamechat2_members.md)


## Related topics

- [语音无障碍用户设置](https://docs.xbox.com/zh-CN/build/game-principles/accessibility/speech-accessibility.md)
- [GameChat2 成员（API 内容）](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/gamechat2_members.md)
- [initialize](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_initialize.md)
- [speech_to_text_conversion_preference_enabled](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_speech_to_text_conversion_preference_enabled.md)
- [text_to_speech_conversion_preference_enabled](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_text_to_speech_conversion_preference_enabled.md)