> ## 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 102：对比度

> 让文本、HUD 及游戏元素与其背景之间保持足够的对比度，方便低视力玩家识别。

## 目标

让视觉元素与其背景之间保持足够的对比度，使低视力玩家能够识别这些元素。

## 概述

全球约有 **29 亿人** 存在低视力。默认 UI 常常在前景与背景之间缺乏足够对比度，从而将低视力或色觉缺陷玩家排除在感知与使用之外。因对比度不足而看不见小地图、HUD 计量条或瞄准准星，就等于失去了对应的玩法。

**对比度**指前景元素与背景之间亮度的比值。比值越高越显眼——但部分认知障碍玩家会觉得对比度过高的 UI 更难阅读，因此目标是**可配置**的对比度。

## 范围界定问题

以下内容是否清晰可辨于其背景？

* 菜单 UI 中的文本
* HUD 元素（血量、文字、小地图）
* 关键玩法元素（在多变背景下的瞄准图标）

## 对比度重要的场景

### 文本

游戏中出现文本的场景请参见 [XAG 101：文本显示](/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display)。以下均需检查对比度：

* 菜单 UI 文本
* 游戏进行中的文本
* 队伍聊天的输入框、占位文本与消息
* 字幕与隐藏字幕
* 加载画面提示
* 错误、Toast 与通知文本

### 非文本视觉元素

* 方向性受伤指示与瞄准准星
* HUD 元素（血量、小地图、任务标记）
* 按钮、滑块及其他控件
* 符号与字形
* 角色与平台的轮廓线
* 含关键信息的图像

<Warning>
  红色与绿色的搭配通常对常见色盲玩家不友好。请将颜色与形状 / 文字组合使用——参见 [XAG 103](/build/game-principles/accessibility/xag-deep-dives/xag-103-additional-cues)。
</Warning>

## 如何测量对比度

可使用：

* [Accessibility Insights for Windows](https://accessibilityinsights.io/)
* [Colour Contrast Analyser (CCA)](https://developer.paciellogroup.com/resources/contrastanalyser/)
* [Color Oracle simulator](https://colororacle.org/)
* [Contrast-ratio calculator](https://contrast-ratio.com/)

## 提升对比度的通用方法

* 允许玩家在屏幕文本后添加**纯色背景**，并调节其不透明度。
* 为屏幕文本与 HUD 元素提供颜色选项。
* 支持**高对比度模式**。
* 为文本与角色添加边框 / 描边。

## 实施指南

### 最小对比度比值

| 元素                 | 比值                  |
| ------------------ | ------------------- |
| 标准尺寸的文本或视觉元素       | **4.5:1**           |
| 大尺寸文本与视觉元素         | **3:1**             |
| 处于非激活 / 禁用状态元素上的文本 | **3:1**             |
| 高对比度模式（所有 UI 元素）   | **7:1**             |
| 占位文本或输入框文本         | **4.5:1**（大尺寸为 3:1） |

### 什么算“大尺寸”

| 平台                            | 分辨率 / DPI | 大尺寸文本  |
| ----------------------------- | --------- | ------ |
| **主机**                        | 1080p     | 52 px  |
| **主机**                        | 4K        | 104 px |
| **PC / VR**                   | 1080p     | 36 px  |
| **PC / VR**                   | 4K        | 72 px  |
| **移动端 / XBOX Game Streaming** | 100 DPI   | 36 px  |
| **移动端 / XBOX Game Streaming** | 200 DPI   | 72 px  |
| **移动端 / XBOX Game Streaming** | 400 DPI   | 144 px |

随 DPI 提升按线性比例放大。

### 其他规则

* **高对比度模式。** 提供浅色和/或深色高对比度模式。启用后，所有 UI 元素与背景的对比度需 **≥ 7:1**。高对比度模式应：
  * 增强重要元素的可见性
  * 加大不同重要元素之间的视觉区分
  * 加大重要元素与非重要元素之间的视觉区分
* **非纯色背景。** 在非纯色背景下，需按背景中**对比度最低的位置**测量文本对比度。
* **遵循系统设置。** 在可行时，启动时读取平台提供的对比度设置，并据此调整游戏 UI。
* **由玩家配置的颜色。** 前景与背景文字颜色可由玩家设定。
* **不要仅依赖颜色。** 当必须使用颜色传达信息时，为关键游戏元素提供玩家可选的颜色。
* **图像中不应含有文字。** 徽标除外——文字必须作为独立的 UI 元素，可被样式化并被屏幕阅读器读取。
* **徽标**没有最小对比度要求。
* **纯装饰性**元素没有对比度要求。
* **非激活状态的元素文本** 仍需满足 3:1 的最小要求（例如“仅限捆绑购买”的覆盖层、禁用的选项）。

## 潜在的玩家影响

| 玩家                               | 受影响 |
| -------------------------------- | :-: |
| 低视力玩家                            |  ✔  |
| 色觉极弱或无色觉的玩家                      |  ✔  |
| 完全失聪的玩家                          |  ✔  |
| 听力受限的玩家                          |  ✔  |
| 有认知或学习障碍的玩家                      |  ✔  |
| 在小屏 / 远距离 / 受眩光影响 / 低对比度显示上游玩的玩家 |  ✔  |

## 资源

* [Provide high contrast between text/UI and background](http://gameaccessibilityguidelines.com/provide-high-contrast-between-text-and-background/)
* [Provide an option to adjust contrast](http://gameaccessibilityguidelines.com/provide-an-option-to-adjust-contrast)
* [Provide a choice of text colour, low/high contrast choice as a minimum](http://gameaccessibilityguidelines.com/provide-a-choice-of-text-colour-lowhigh-contrast-choice-as-a-minimum)
* [Accessibility Insights For Windows](https://accessibilityinsights.io/)
* [Colour Contrast Analyser (CCA)](https://developer.paciellogroup.com/resources/contrastanalyser/)
* [Color Oracle](https://colororacle.org/)
* [Contrast ratio tool](https://contrast-ratio.com/)
* API：[XHighContrastGetMode](https://developer.microsoft.com/games/xbox/docs/gdk/XHighContrastGetMode) *(NDA)*


## Related topics

- [XAG 101：文本显示](/zh-CN/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display.md)
- [XAG 123：心理健康最佳实践](/zh-CN/build/game-principles/accessibility/xag-deep-dives/xag-123-mental-health-best-practices.md)
- [XBOX Accessibility Guidelines（XAG）](/zh-CN/build/game-principles/accessibility/xbox-accessibility-guidelines.md)
- [无障碍元数据](/zh-CN/publishing/game-publishing/concepts/metadata-accessibility.md)
- [XAG 118：光敏感性](/zh-CN/build/game-principles/accessibility/xag-deep-dives/xag-118-photosensitivity.md)