高對比模式

視遊戲的色彩配置而定，有時觸控配置可能因為與底層串流中執行的遊戲對比不佳而難以辨識。對於低視能、色盲或有其他視覺障礙的玩家來說，這個問題可能特別嚴重。高對比模式是一項用戶端設定，啟用後會為使用圖示設定樣式的按鈕加上額外的筆觸和按鈕背板，並修改系統色彩以提高對比。例如，以下是標準配置搭配純淺色背景，且高對比模式為停用時的樣子：

以下則是相同設定在高對比模式啟用時的樣子：

雖然您可以依賴系統預設值來設定高對比模式樣式，但您也可以加入自訂資產的高對比模式變體，並覆寫系統色彩，以符合遊戲的視覺美感。

高對比模式的自訂資產

在觸控調整套件組合中使用自訂資產時，您可以為每個標準對比資產加入高對比資產變體。只要啟用高對比模式，就會轉譯這些高對比資產變體。若要將資產標示為高對比變體，請在資產名稱之後、副檔名之前加上 .hc 尾碼。例如，請參考 myAsset.png (左) 及其高對比變體 myAsset.hc.png (右)：

在磁碟上配置資產時，標準對比和高對比資產都會照常依語言和資產縮放比例組織。以上述資產為例，檔案結構可能如下所示：

assets/
└───neutral/
    ├───@1.0x/
    │       myAsset.png
    │       myAsset.hc.png
    ├───@1.5x/
    │       myAsset.png
    │       myAsset.hc.png
    ├───@2.0x/
    │       myAsset.png
    │       myAsset.hc.png
    ├───@3.0x/
    │       myAsset.png
    │       myAsset.hc.png
    └───@4.0x/
            myAsset.png
            myAsset.hc.png

在配置中，參考資產時不包含副檔名，也不包含 .hc 尾碼。例如，使用上述資產設定樣式的按鈕可能會如下設定：

{
    "type": "button",
    "action": "gamepadA",
    "styles": {
        "idle": {
            "faceImage": {
                "type": "asset",
                "value": "myAsset"
            }
        }
    }
}

在此樣式下，觸控調整套件會根據高對比模式是停用或啟用，分別自動選取 myAsset.png 或 myAsset.hc.png。高對比模式停用時，此樣式會產生下列結果：

高對比模式啟用時則會產生下列結果：

覆寫高對比模式的系統色彩

觸控配置或內容檔案中的調色盤可用來覆寫系統色彩。控制項在設定樣式時會隱含地取樣系統色彩，這表示任何覆寫都會影響所有控制項的全域樣式 (除非控制項在自訂 styles 區塊中有自己的覆寫)。例如，下列配置會覆寫部分系統色彩，以在啟用高對比模式時達成自訂樣式：

{
  "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/layout/v4.0/layout.json",
  "styles": {
    "colors": {
      "highContrast": {
        "system_contentPrimary": "#ff00ffff",
        "system_contentSecondary": "#00ff00aa",
        "system_contrastPrimary": "#ff0000aa"
      }
    }
  },
  "content": {
    "left": {
      "inner": [
        {
          "type": "joystick",
          "axis": {
            "input": "axisXY",
            "output": "leftJoystick"
          }
        },
        {
          "type": "button",
          "action": "dPadRight",
          "styles": {
            "default": {
              "faceImage": {
                "type": "icon",
                "value": "map"
              }
            }
          }
        }
      ]
    },
    "right": {
      "inner": [
        {
          "type": "button",
          "action": "gamepadY"
        },
        {
          "type": "button",
          "action": "gamepadB"
        },
        {
          "type": "button",
          "action": "gamepadA"
        },
        {
          "type": "button",
          "action": "gamepadX"
        }
      ]
    }
  }
}