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

# XAG 119：语音转文字与文字转语音聊天

> 支持语音转文字与文字转语音聊天，为收到的文字与表情朗读，并遵循（且允许玩家覆盖）平台的聊天无障碍设置。

## 目标

确保所有玩家都能参与文本聊天或语音聊天等交流场景。对聋人或听力受损、无口语能力、低视力或无视觉的玩家尤为重要。

## 概述

交流场景是玩家之间一对一或一对多的信息交换——在线文本聊天、玩法中的队伍语音、多人大厅聊天，或发送到玩家收件箱的消息。

* 聋人或听力受损玩家应能使用**语音转文字聊天**，将口语实时转写为屏幕上的文本。
* 无法（因个人选择或残障原因）通过口语交流的玩家应能使用**文字转语音聊天**——通过文本输入框，将他们输入的任何内容以合成语音朗读给其他玩家听。其他玩家无需启用任何功能，直接就能听到朗读。

<Note>
  语音聊天并不等同于让文本聊天具有无障碍性。反之亦然。玩家应能按自己所选的方式进行交流。
</Note>

## 范围界定问题

您的游戏是否包含：

* 玩家之间的文本聊天？
* 基于语音的音频聊天？
* 聊天轮盘等预设短语？
* 好友请求、邀请、玩家间通知？
* 表情或表情符号等非文本交流？

## 实施指南

### 语音转文字聊天

玩家可启用 STT，将其他玩家的语音沟通实时转写为文字。示例：《Halo Wars 2》在屏幕右侧显示实时转写区域。

### 文字转语音聊天

启用后，玩家获得一个文本输入框；输出的文字被实时转换为合成音频，通过语音通道播送给所有其他玩家。示例：《Sea of Thieves》和《Gears 5》都提供文本输入框；输入的文字通过合成语音广播给所有玩家。Gears 5 还会将消息标记为“Global”或“Speech”，让发送者知道消息如何送达他人。

### 在所有可交流处提供文本输入框

只要有可交流的地方，就应提供文本输入框——包括非核心玩法之外的画面。《Sea of Thieves》与《Gears 5》都在所有沟通界面中提供文本输入框。

### 对基于文本的交流进行屏幕旁白

对启用屏幕旁白设置的玩家，所有收到的文本消息都应在本地实时朗读。示例：《Minecraft》基岩版在启用屏幕旁白时会朗读收到的聊天消息。

### 对非文本交流进行屏幕旁白

对启用了屏幕旁白的玩家，所有短语、表情符号或表情都应在本地实时朗读。

* 表情符号应以友好名称朗读（“Grinning Face”“Two Hearts”），依据 [Unicode CLDR Short Names](https://unicode.org/emoji/charts/full-emoji-list.html)。示例：《Minecraft》会朗读“Hi! Welcome to my world! Red Heart.”。

### 玩家发起的角色语音

所有由玩家发起并被朗读的角色沟通（例如预设聊天轮盘消息的语音配音），都应实时转写为文字，并在本地展示给启用 STT 的玩家。

* 预设消息选项的浏览也须无障碍：启用屏幕旁白的玩家在聚焦每条消息时应听到预览，以便知道即将发送的内容。

### 读取并遵循平台设置

在平台提供 STT 或 TTS 聊天设置时，游戏应默认支持这些设置。XBOX 的“轻松使用”下的 Game Transcription 菜单提供了平台级默认值。

### 游戏内覆盖平台设置

所有核心受支持功能（STT 聊天、TTS 聊天与屏幕旁白）都应能在游戏级别调整，让玩家按游戏覆盖平台默认设置。

* 示例：《Sea of Thieves》允许玩家分别覆盖平台的 STT、TTS 与 game transcription 设置。
* 示例：《Forza Horizon 4》的 Screen Reader 选项按游戏提供“System Default”“On”和“Off”。

## 潜在的玩家影响

| 玩家                       | 受影响 |
| :----------------------- | :-: |
| 无视觉的玩家                   |  ✓  |
| 低视力玩家                    |  ✓  |
| 完全失聪的玩家                  |  ✓  |
| 听力受限的玩家                  |  ✓  |
| 无口语能力的玩家                 |  ✓  |
| 有认知或学习障碍的玩家              |  ✓  |
| 因隐私原因不愿在线分享嗓音、无麦克风或耳机的玩家 |  ✓  |

## 资源

* [Azure PlayFab Party overview](/services/playfab/multiplayer/networking)
* [PlayFab Party speech-to-text and text display UX guidelines](/services/playfab/multiplayer/networking)
* [PlayFab Party text-to-speech and text input UX guidelines](/services/playfab/multiplayer/networking)
* [Full Emoji List — Unicode.org](https://unicode.org/emoji/charts/full-emoji-list.html)


## Related topics

- [语音无障碍用户设置](/zh-CN/build/game-principles/accessibility/speech-accessibility.md)
- [PartyXblAccessibilitySettings](/zh-CN/services/playfab/multiplayer/networking/xblreference/structs/partyxblaccessibilitysettings.md)
- [Azure PlayFab Party](/zh-CN/build/console-features/networking/game-mesh/playfab-party-intro-networking.md)
- [可选服务](/zh-CN/build/gdk-and-engines/optional-services.md)
- [无障碍元数据](/zh-CN/publishing/game-publishing/concepts/metadata-accessibility.md)