> ## 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 115:錯誤訊息與破壞性動作

> 偵測並描述輸入錯誤、在破壞性動作前警告玩家,並讓玩家在選擇確定之前檢閱、復原或重設。

## 目標

確保玩家在永久性或破壞性動作發生之前,能夠識別並更正玩家輸入錯誤。

## 概述

輸入錯誤 (打字錯誤、不小心啟動按鈕) 很常見。使用語音輸入、自適應硬體,或有運動或學習障礙的玩家可能會更常遇到。在建立帳戶、購買、存檔或破壞性遊戲決策 (拆解稀有物品、解散 NPC 同伴) 期間發生的錯誤,可能造成永久性的後果,提供檢閱/還原選項有助於每個人避免這些錯誤。

## 範圍問題

* 您的遊戲是否需要玩家輸入使用者名稱、密碼或其他以準則為基礎的資訊?
* 您的遊戲是否提供儲存資訊 (遊戲進度、設定) 的功能?
* 您的遊戲是否提供遊戲內購買的機會?
* 您的遊戲是否包含文字輸入表單方塊 (角色名稱、密碼)?
* 您的遊戲是否允許若意外執行可能損害體驗的不可逆決策?

## 實作指南

### 清楚描述錯誤

* 如果自動偵測到輸入錯誤 (例如密碼不正確),請以多種方式 (文字與語音朗讀) 描述錯誤及其更正方式。

<Note>
  會危及內容安全性或用途的資訊不在此限,例如不要透露正確的密碼。一般的密碼準則提示則沒有問題。
</Note>

**範例:** *Gears 5* 的配對錯誤會說明失敗的情況及其根本原因 (「Your squad size exceeds the maximum limit…」),讓玩家可以更正。

### 讓錯誤在視覺上明顯不同

* 錯誤與警告訊息在視覺上應容易與畫面上的其他文字區分。範例:Forza Horizon 4 的「Unsaved Changes」警告會模糊背景,並使用紅色焦點指示器、大型文字及驚嘆號圖示。

### 強調發生錯誤的位置

* 在錯誤與警告發生的位置以視覺方式強調。範例:PuzzleBlaster 的密碼表單會在未通過的準則下方加上底線、加上星號,並為朗讀使用者加入「not met」文字。

### 檢閱與復原

* 如果任何動作會刪除或修改已儲存的資料,請在確定之前讓玩家有機會檢閱、更正或完全還原該動作。
* 範例:*Grounded* 在未套用就結束設定時會提示「Unapplied Changes Detected」,並為所有設定提供「Factory Default」重設。
* 提供機制來檢閱、確認及復原永久性或破壞性動作 (遊戲內購買、出售物品、覆寫存檔)。
  * 範例:*Fallout 76* 對商人購買使用兩步驟確認。
  * 範例:*Cyberpunk 2077* 在角色建立過程中,如果玩家嘗試在還有未使用的屬性點數時繼續,會發出警告,因為這些點數將會遺失。

### 避免以長按按鈕確認

* 不要求以長按按鈕來確認破壞性動作。請提供替代選項。

## 對玩家的潛在影響

| 玩家 | 受影響 |
| :- | :-: |
| 無視力的玩家 | ✓ |
| 低視能的玩家 | ✓ |
| 有認知或學習障礙的玩家 | ✓ |
| 伸展範圍與力氣受限的玩家 | ✓ |
| 手部靈巧度受限的玩家 | ✓ |
| 想避免非預期購買的玩家 | ✓ |

## 資源

* [Nielsen Norman Group: Preventing User Errors — Avoiding Conscious Mistakes](https://www.nngroup.com/articles/user-mistakes/)


## Related topics

- [XtfGetErrorText](/zh-TW/reference/tools/xtf/xtfconsolecontrol/functions/xtfgeterrortext-xtfconsolecontrol-xbox-microsoft-m.md)
- [XtfGetErrorTextA](/zh-TW/reference/tools/xtf/xtfconsolecontrol/functions/xtfgeterrortexta.md)
- [XAG 101：文字顯示](/zh-TW/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display.md)
- [XAG 106:螢幕朗讀](/zh-TW/build/game-principles/accessibility/xag-deep-dives/xag-106-screen-narration.md)
- [處理 Lobby 和 Matchmaking C++ SDK 錯誤](/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-errors.md)