> ## 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.

# XBOX Accessibility Guidelines（XAG）

> XBOX Accessibility Guidelines（XAG v3.2）概述，涵盖由 MGATS 评估的游戏在文本、音频、输入、UI 与光敏感性方面的最佳实践。

**XBOX Accessibility Guidelines（XAG）** 是与行业专家和 Gaming and Disability 社群共同制定的最佳实践。它们的角色包括：

* 供设计师参考的**灵感来源**。
* 供开发者对齐的**护栏**。
* 供测试团队核对的**验证清单**。

XAG **并非**合规检查清单。它们的目标是让游戏对所有人都好玩、可玩。Microsoft 的无障碍测试服务 MGATS 按 XAG 进行评估。

<Note>
  当前发布版本：**XAG v3.2**（2023 年 6 月 8 日）。如需变更历史，请联系您的 Microsoft 对接人。
</Note>

## 每条指南的结构

每条 XAG 都包含相同的部分：

* **目标（Goal）** — 期望达到的玩家影响。
* **概述（Overview）** — 残障玩家在该主题下常遇到的障碍。
* **范围界定问题（Scoping questions）** — 帮助判断该指南是否适用于您的作品。
* **背景（Background）** — 针对复杂主题的入门材料。
* **关键目标区域（Key areas to target）** — 不容忽视的游戏元素。
* **实施指南（Implementation guidelines）** — 规定性的最低要求。
* **示例内容（Example content）** — 展示正确实施的图像和视频片段。
* **潜在的玩家影响（Potential player impact）** — 最受影响的残障类型。
* **资源与工具（Resources and tools）** — 外部延伸阅读。

## 全部 23 条指南

### 视觉

| #       | 指南                                                                                                | 主要内容              |
| ------- | ------------------------------------------------------------------------------------------------- | ----------------- |
| **101** | [文本显示](/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display)                  | 字号、行距、颜色、自定义      |
| **102** | [对比度](/build/game-principles/accessibility/xag-deep-dives/xag-102-contrast)                       | 前景 / 背景对比度比值      |
| **109** | [物体清晰度](/build/game-principles/accessibility/xag-deep-dives/xag-109-objective-clarity)            | 游戏内物体与目标的可区分度     |
| **112** | [UI 导航](/build/game-principles/accessibility/xag-deep-dives/xag-112-ui-navigation)                | 合乎逻辑的阅读与焦点顺序      |
| **113** | [UI 焦点处理](/build/game-principles/accessibility/xag-deep-dives/xag-113-ui-focus-handling)          | 可见的焦点指示器          |
| **114** | [UI 上下文](/build/game-principles/accessibility/xag-deep-dives/xag-114-ui-context)                  | 标题、标签与上下文线索       |
| **117** | [视觉干扰与运动](/build/game-principles/accessibility/xag-deep-dives/xag-117-visual-distractions-motion) | 镜头晃动、视差、动态模糊的关闭选项 |
| **118** | [光敏感性](/build/game-principles/accessibility/xag-deep-dives/xag-118-photosensitivity)              | 闪烁图案、光敏性癫痫的安全     |

### 音频

| #       | 指南                                                                                        | 主要内容                     |
| ------- | ----------------------------------------------------------------------------------------- | ------------------------ |
| **103** | [补充提示](/build/game-principles/accessibility/xag-deep-dives/xag-103-additional-cues)       | 任何提示都不要仅依赖单一感官           |
| **104** | [字幕与隐藏字幕](/build/game-principles/accessibility/xag-deep-dives/xag-104-subtitles-captions) | 字幕文本、说话者标签、音效            |
| **105** | [音频无障碍](/build/game-principles/accessibility/xag-deep-dives/xag-105-audio-accessibility)  | 音乐 / 对白 / 音效 / 聊天的独立音量滑块 |
| **106** | [屏幕旁白](/build/game-principles/accessibility/xag-deep-dives/xag-106-screen-narration)      | 为盲人/低视力玩家提供 UI 的 TTS 旁白  |
| **111** | [音频描述](/build/game-principles/accessibility/xag-deep-dives/xag-111-audio-descriptions)    | 对视觉场景/过场进行旁白描述           |

### 输入

| #       | 指南                                                                                  | 主要内容                 |
| ------- | ----------------------------------------------------------------------------------- | -------------------- |
| **107** | [输入](/build/game-principles/accessibility/xag-deep-dives/xag-107-input)             | 按键重映射、按住 vs 点按、无障碍外设 |
| **110** | [触觉反馈](/build/game-principles/accessibility/xag-deep-dives/xag-110-haptic-feedback) | 可选、可提供信息的震动          |

### 难度与节奏

| #       | 指南                                                                                     | 主要内容         |
| ------- | -------------------------------------------------------------------------------------- | ------------ |
| **108** | [难度选项](/build/game-principles/accessibility/xag-deep-dives/xag-108-difficulty-options) | 难度选择、细粒度辅助   |
| **115** | [错误消息](/build/game-principles/accessibility/xag-deep-dives/xag-115-error-messages)     | 确认、撤销、清晰的错误  |
| **116** | [时间限制](/build/game-principles/accessibility/xag-deep-dives/xag-116-time-limits)        | 暂停、延长或关闭时间压力 |

### 交流

| #       | 指南                                                                                            | 主要内容                   |
| ------- | --------------------------------------------------------------------------------------------- | ---------------------- |
| **119** | [聊天（STT / TTS）](/build/game-principles/accessibility/xag-deep-dives/xag-119-chat)             | 内置或平台提供的 STT 与 TTS     |
| **120** | [交流场景](/build/game-principles/accessibility/xag-deep-dives/xag-120-communication-experiences) | 更安全的聊天默认设置、对未审核频道的摩擦阻力 |

### 文档与支持

| #       | 指南                                                                                                      | 主要内容             |
| ------- | ------------------------------------------------------------------------------------------------------- | ---------------- |
| **121** | [无障碍功能文档](/build/game-principles/accessibility/xag-deep-dives/xag-121-accessible-feature-documentation) | 在哪里、如何记录无障碍功能    |
| **122** | [无障碍客户支持](/build/game-principles/accessibility/xag-deep-dives/xag-122-accessible-customer-support)      | 面向辅助技术用户的多渠道支持   |
| **123** | [心理健康最佳实践](/build/game-principles/accessibility/xag-deep-dives/xag-123-mental-health-best-practices)    | 更安全的内容警告、退出选项、休息 |

## 在流程中使用 XAG

<Steps>
  <Step title="设计阶段">
    针对您的设计支柱运行范围界定问题。标记落入范围的指南，并决定哪些辅助内建于核心系统、哪些作为选项。
  </Step>

  <Step title="实现阶段">
    将实施指南拉入您的任务追踪工具，为每个功能追踪无障碍验收标准。
  </Step>

  <Step title="QA / 认证准备">
    在最终认证前运行 [MGATS](/build/game-principles/accessibility/mgats)，并在提交前解决报告中发现的问题。
  </Step>

  <Step title="商店信息">
    在您的 [Properties](/publishing/game-publishing/concepts/properties-basic-info) 模块中记录所支持的无障碍功能，使其在商店 PDP 页面上得到展示。
  </Step>
</Steps>

## 相关 GDK 组件

* [无障碍概述](/build/game-principles/accessibility/accessibility-overview)
* [语音无障碍用户设置](/build/game-principles/accessibility/speech-accessibility)
* [文字转语音](/build/console-features/text-to-speech/text-to-speech)
* [XAccessibility API](/reference/system/xaccessibility/xaccessibility_members)
* [XSpeechSynthesizer API](/reference/system/xspeechsynthesizer/xspeechsynthesizer_members)

## 参见

* [Gaming and Disability Player Experience Guide (GADPEG)](/build/game-principles/accessibility/gadpeg)
* [Gaming Accessibility Fundamentals 学习路径](/build/game-principles/accessibility/gaf-info)
* [MGATS](/build/game-principles/accessibility/mgats)
* [无障碍功能标签](/build/game-principles/accessibility/accessibility-feature-tags)
* [XBOX Developer Programs](https://www.xbox.com/developers/id)

## 相关 API 文档

* [XGameUI API reference](/reference/system/xgameui/xgameui_members) — 具备无障碍能力的系统 UI（语音转文字、虚拟键盘）
* [XGameStreaming API reference](/reference/system/xgamestreaming/xgamestreaming_members) — 用于可读 UI 的物理串流尺寸
* [Touch adaptation kit reference](/reference/system/touchadaptationkit/touchadaptationkit-reference) — 无障碍触控布局


## Related topics

- [无障碍功能标签](/zh-CN/build/game-principles/accessibility/accessibility-feature-tags.md)
- [开发者无障碍资源](/zh-CN/build/game-principles/accessibility/accessibility-resources.md)
- [GDK 无障碍概览](/zh-CN/build/game-principles/accessibility/accessibility-overview.md)
- [术语表](/zh-CN/publishing/game-publishing/glossary.md)
- [XAG 112：UI 导航](/zh-CN/build/game-principles/accessibility/xag-deep-dives/xag-112-ui-navigation.md)