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

# 觸控調整套件命令列工具 (tak.exe)

> 觸控調整套件命令列工具 (tak.exe)

使用本文，透過觸控調整套件 (TAK) 建立及驗證觸控控制配置。

## takxconfig.json 和 .takx 檔案

tak.exe 命令列工具操作的主要檔案類型是未封裝組合設定檔 (`takxconfig.json`) 或已封裝組合 (`.takx`) 檔案。
視所執行的命令而定，這些檔案類型之一一律可以使用，且代表整個觸控組合。為了回溯相容性，以及讓某些內部迴圈案例更容易進行，仍支援 `--layout-path` 等舊版引數，且這些引數會覆寫 `takxconfig.json` 中的內容。

### 屬性

`$schema` - *string*。觸控組合設定檔的 JSON 結構描述。視所選取的結構描述版本而定，此值應類似 `https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json`。

`version` - *string*。組合的四段式 (例如 1.0.0.0) 版本號碼。

`versionName` - *string*、*optional*。組合版本的描述性名稱。

`layouts` - *object*。定義組合之配置選項的物件。其中的 `path` 屬性會指定配置所在的相對路徑。

`assets` - *object*、*optional*。定義組合之資產選項的物件。其中的 `path` 屬性會指定資產所在的相對路徑。

`context` - *object*、*optional*。定義組合之內容選項的物件。其中的 `path` 屬性會指定內容檔案所在的相對路徑。

`languages` - *object*、*optional*。定義組合之語言選項的物件。其中的 `items` 屬性是一個陣列，指定組合所支援的語言。

### 範例

```json theme={null}
{
  "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json",
  "layouts": {
    "path": "./layouts"
  },
  "assets": {
    "path": "./assets"
  },
  "context": {
    "path": "./context.json"
  },
  "languages": [
    "en",
    "en-US"
  ],
  "version": "2.0.0.0"
}
```

如需使用 `takxconfig.json` 檔案的完整範例，請參閱[我們的 GitHub](https://github.com/microsoft/xbox-game-streaming-tools/tree/main/touch-adaptation-kit/samples)。

### 需求

檔案的版本是由 .json 檔案中的 `$schema` 屬性所指定。此屬性會指定可用的特定屬性集，並在某些編輯器中啟用 IntelliSense。

上述屬性適用於最新支援的結構描述版本。如需較舊的結構描述屬性，請參閱[我們的 GitHub](https://github.com/microsoft/xbox-game-streaming-tools/tree/main/touch-adaptation-kit/schemas)。

## 命令

使用下表所示的命令，確保在使用 XBOX Game Streaming 遊玩您的作品時，觸控控制項能如預期般運作。

| 命令 | 描述 |
| - | - |
| [create](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-create-command) | 建立觸控調整組合的來源內容，或將配置新增至現有的組合。 |
| [convert](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-convert-command) | 將舊版配置集檔案轉換為符合我們服務所支援之最新格式標準的配置檔案。 |
| [license](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-license-command) | 顯示或接受觸控調整套件命令列工具的使用者授權合約 (EULA)。 |
| [notice](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-notice-command) | 顯示此軟體所包含之第三方資料的相關資訊。 |
| [pack](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-pack-command) | 從一組來源內容建置觸控調整組合。 |
| [serve](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command) | 提供觸控調整組合，讓用戶端應用程式可以下載並使用。 |
| [settings](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-settings-command) | 檢視及設定應用程式設定。 |
| [takx-version](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-takx-version-command) | 判斷觸控調整組合的版本，以及所包含配置的最高結構描述版本。 |
| [unpack](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-unpack-command) | 將現有的觸控調整組合解壓縮為其元件檔案。 |
| [verify](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-verify-command) | 驗證觸控調整組合的內容是否有效。 |
| [version](/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-version-command) | 顯示觸控調整套件命令列工具的版本資訊。 |

## 選項

使用下表中的資訊，將適當的旗標套用至所有命令。

| 選項 | 描述 |
| - | - |
| `-v`, `--verbosity` | 設定命令的輸出詳細程度。這些旗標的有效值為 `Critical`、`Debug`、`Error`、`Information`、`None`、`Trace` 和 `Warning`。預設詳細程度為 `Information`。 |
| `--version` | 顯示版本資訊。 |
| `--accept-license` | 在執行命令之前接受應用程式的授權合約。適用於自動化。 |
| `--reset-appId` | 重設與您電腦相關聯的應用程式識別碼。 |
| `-?`, `-h`, `--help` | 顯示說明和使用方式資訊。 |

## 另請參閱

[開始使用觸控](/zh-TW/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch)
[Web 內容測試應用程式 (CTA)](/zh-TW/build/core-features/common/game-streaming/game-streaming-web-content-test-application)
[如何取得 TAK CLI](https://aka.ms/get-takcli)


## Related topics

- [Touch Adaptation Kit (TAK) 命令行工具参考](/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/index.md)
- [Touch Adaptation Kit 命令行工具 (tak.exe)](/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line.md)
- [GDK 名詞與縮寫詞彙表](/zh-TW/home/glossary.md)
- [Unpack 命令](/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-unpack-command.md)
- [Verify 命令](/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-verify-command.md)