> ## 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 101：文字顯示

> 透過最小預設大小、可設定的樣式與色彩以及適當的間距來最佳化文字可讀性，讓低視能玩家能夠閱讀所有內容。

## 目標

藉由以最小預設大小與間距顯示文字，並提供可設定的樣式與色彩選項，確保所有玩家 (包括低視能玩家) 都能獲得最佳的文字可讀性。

## 概觀

大約有 **29 億人**有某種程度的低視能，例如眼鏡無法完全矯正的模糊、霧狀或部分視力喪失。情境性障礙 (螢幕距離遠、行動裝置螢幕小、電視靜音、房間吵雜) 也會讓文字難以閱讀。

如果玩家無法閱讀功能表文字，可能在遊戲開始之前就會受阻。文字也承載了 HUD、目標、提示、NPC 台詞與玩家聊天，失去文字就等於失去遊戲。

## 範圍問題

您的遊戲是否需要閱讀？

* 可瀏覽的功能表是否以文字為主？
* 遊戲過程中是否會在螢幕上顯示文字 (HUD、目標、路徑點、NPC 台詞)？
* 玩家是否可以透過文字聊天、聊天輪盤、STT/TTS 進行溝通？

## 「文字顯示」涵蓋的範圍

* **大小**：文字可以多大或多小
* **字樣**：粗體、斜體、細體
* **粗細**：筆畫粗細
* **樣式**：字型家族
* **間距**：字母、文字、行之間的距離
* **對齊**：水平對齊方式
* **大小寫**：句首大寫、全部大寫
* **色彩**：相對於背景的可見度 (請參閱 [XAG 102：對比](/zh-TW/build/game-principles/accessibility/xag-deep-dives/xag-102-contrast))

<Tip>
  最佳做法是**讓玩家自行選擇**。提供設定選項，讓每位玩家都能依自己的需求調整文字。
</Tip>

## 測量文字大小

XAG 中的字型大小指的是**字身高度**，也就是從最低的下伸部到最高的上伸部之間的像素距離。

<Steps>
  <Step title="擷取文字">
    在遊戲中擷取文字的螢幕擷取畫面，並在 Microsoft 小畫家中開啟。
  </Step>

  <Step title="找出最高的上伸部與最低的下伸部">
    找出一個含有 `g`、`y`、`h`、`b` 等字母的單字，以確定完整的字身高度。
  </Step>

  <Step title="處理外框">
    只有當彩色外框像素與背景的對比超過 **2:1** 時，才將其計入。較柔和的反鋸齒像素不予計算。
  </Step>

  <Step title="繪製選取範圍">
    從最高的上伸部到最低的下伸部繪製一個矩形選取範圍。小畫家會在左下角顯示像素高度，該數字即為字型大小。
  </Step>
</Steps>

## 必須具備無障礙性的重點區域

* **功能表畫面**：標籤、子標籤、描述文字、互動提示
* **遊戲環境**：HUD 量表、教學提示、物品欄按鍵
* **聊天輸入欄位**：預留位置文字與輸入的訊息
* **聊天視窗**：傳送與接收的訊息
* **聊天輪盤**：預先撰寫的通訊輪盤選項
* **字幕與隱藏式字幕**
* **錯誤訊息、快顯通知與通知**
* 含有實用提示的**載入畫面**

## 實作指南

### 最小預設文字大小

以字身高度 (下伸部 + x 高度 + 上伸部) 測量。

<Note>
  這些是**發行時的最小預設值**。請提供選項，讓玩家可自行決定放大或縮小。
</Note>

| 平台 | 解析度 / DPI | 最小字身高度 |
| - | - | - |
| **主機** | 1080p | 26 px |
| **主機** | 4K | 52 px |
| **PC / VR** | 1080p | 18 px |
| **PC / VR** | 4K | 36 px |
| **行動裝置 / XBOX Game Streaming** | 100 DPI | 18 px |
| **行動裝置 / XBOX Game Streaming** | 200 DPI | 36 px |
| **行動裝置 / XBOX Game Streaming** | 400 DPI | 72 px |

行動裝置的 DPI 比電視或 PC 顯示器高得多，因此相同視覺大小的文字需要更多像素。5.5 吋 1080p 螢幕大約為 400 DPI。請隨 DPI 增加而線性縮放。

<Warning>
  平台提供的放大鏡**不能**取代達到最小文字大小的要求。
</Warning>

### 圖示與字符大小

* 圖示與字符**內部**的文字 (例如 X 按鈕字符中的 `X`) 須符合上述相同的最小大小。
* 圖示與字符會隨文字縮放而縮放，最高可達最小預設值的 **200%**。
* 為了讓字符保持在文字容器內，您可能需要放大周圍的文字，使整個字符能放入該行。

### 文字縮放

* 玩家可以將文字調整至最小值的 **200%**，而不會遺失內容、功能或意義。
* 縮放後，大型標題文字在視覺上仍與內文有所區別。
* 縮放後超出螢幕的文字仍有辦法閱讀 (捲動文字、快顯視窗或適當的縮寫)。
* 縮放絕不會導致在單一 UI 中需要雙向捲動。單向捲動則沒有問題。
* 當使用者選擇加入時，允許文字**小於**預設值是可接受的。

### 字型樣式

* 至少包含一種**無襯線**字體選項。
* 如果使用風格化字型 (滴血字、哥德字體等)，請提供非風格化的替代字型。
* 所有字型都包含每種支援語言的完整字元集。

### 文字間距

較大的間距可提升清晰度，尤其是在大字體時。對於以標準字型大小顯示超過兩行的文字區塊：

* 最好讓玩家自行設定行寬、行距、段落間距、字母間距與字距。
* 如果未提供設定，請符合下列最小值：

| 屬性 | 最小值 |
| - | - |
| **行寬** | ≤ 80 個字元 (CJK 為 40 個)，以 100% 縮放測量，不含空格 |
| **行距 (行間距)** | 段落內 ≥ 1.5 倍，以上伸部到上伸部測量 |
| **段落間距** | ≥ 行距的 2 倍 |
| **字母間距** | ≥ 字型大小的 0.12 倍 |
| **字距** | ≥ 字型大小的 0.16 倍 |

### 大小寫與對齊

* **大小寫**：提供以句首大寫顯示文字的功能，而非全部大寫或全部小寫。一或兩個字的標籤不在此限。
* **對齊**：文字會依照玩家的語言偏好靠左或靠右對齊 (而非置中或左右對齊)，或玩家可以自行調整。

## 對玩家的潛在影響

| 玩家 | 受影響 |
| - | :-: |
| 低視能玩家 | ✔ |
| 色彩感知能力低或無色彩感知能力的玩家 | ✔ |
| 無聽力的玩家 | ✔ |
| 聽力受限的玩家 | ✔ |
| 有認知或學習障礙的玩家 | ✔ |
| 在小型 / 遠距離 / 有眩光 / 低對比顯示器上閱讀的玩家 | ✔ |

## 資源

* [Clear Text (accessible.games)](https://accessible.games/accessible-player-experiences/access-patterns/clear-text/)
* [Distinguish This From That (accessible.games)](https://accessible.games/accessible-player-experiences/access-patterns/distinguish-this-from-that/)
* [Allow the font size to be adjusted (Game Accessibility Guidelines)](http://gameaccessibilityguidelines.com/allow-the-font-size-to-be-adjusted/)
* [Provide a choice of text colour, low/high contrast as a minimum](http://gameaccessibilityguidelines.com/provide-a-choice-of-text-colour-lowhigh-contrast-choice-as-a-minimum)
* [Use simple clear text formatting](http://gameaccessibilityguidelines.com/use-simple-clear-text-formatting/)
* API：[XGameStreamingGetStreamPhysicalDimensions](https://developer.microsoft.com/games/xbox/docs/gdk/Xgamestreaminggetstreamphysicaldimensions) *(NDA)*


## Related topics

- [XAG 101：文本显示](/zh-CN/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display.md)
- [GDK 無障礙概覽](/zh-TW/build/game-principles/accessibility/accessibility-overview.md)
- [XAG 101: テキスト表示](/ja-jp/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display.md)
- [XAG 101: Text display](/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display.md)
- [XAG 101: Visualización de texto](/es/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display.md)