タッチ アダプテーション キット コマンドライン ツール (tak.exe)

このトピックでは、タッチ アダプテーション キット (TAK) を使って、タッチ コントロール レイアウトを作成して検証します。

takxconfig.json および .takx ファイル

tak.exe コマンド ライン ツールが動作する主なファイルの種類は、パック解除されたバンドル構成ファイル (takxconfig.json) またはパッケージ化されたバンドル (.takx) ファイルです。 実行されるコマンドに応じて、これらのファイルの種類のいずれかが常に使用可能であり、タッチ バンドル全体を表します。 下位互換性のため、および一部の内部ループ シナリオをより簡単にするために、--layout-path などの従来の引数は引き続きサポートされており、takxconfig.json から内容を上書きします

プロパティ

$schema - 文字列。 タッチ バンドル構成ファイルの JSON スキーマ。 選択したスキーマ バージョンによっては、これは https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json に似ているはずです。

version - 文字列。 バンドルの 4 つの部分 (例: 1.0.0.0) のバージョン番号。

versionName - 文字列、省略可能。 バンドルのバージョンのわかりやすい名前。

layouts - オブジェクト。 バンドルのレイアウト オプションを定義するオブジェクト。 この中の path プロパティは、レイアウトが配置されている相対パスを指定します。

assets - オブジェクト、省略可能。 バンドルのアセット オプションを定義するオブジェクト。 この中の path プロパティは、アセットが配置されている相対パスを指定します。

context - オブジェクト、省略可能。 バンドルのコンテキスト オプションを定義するオブジェクト。 この中の path プロパティは、コンテキスト ファイルが配置されている相対パスを指定します。

languages - オブジェクト、省略可能。 バンドルのコンテキスト オプションを定義するオブジェクト。 この中の items プロパティは、バンドルがサポートする言語を指定する配列です。

サンプル

{
  "$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 を参照してください。

要件

ファイルのバージョンは、json ファイルの $schema 属性によって指定されます。 これにより、使用可能な特定のプロパティ セットが指定され、一部のエディターで IntelliSense が有効になります。

上記のプロパティは、サポートされている最新のスキーマ バージョンに対して有効です。 古いスキーマ プロパティについては、GitHub を参照してください。

コマンド

次の表に示すコマンドを使用して、Xbox ゲーム ストリーミングを使用してタイトルをプレイするときに、タッチ コントロールが意図したとおりに動作することを確認します。

コマンド	説明
create	タッチ アダプテーション バンドルのソース コンテンツを作成するか、既存のレイアウトにレイアウトを追加します。
変換	従来のレイアウト セット ファイルを、サービスでサポートされている最新の形式標準に合わせたレイアウト ファイルに変換します。
ライセンス が適用されることに注意してください。	タッチ アダプテーション キット コマンド ライン ツールのエンド ユーザー使用許諾契約 (EULA) を表示または承諾します。
通知	このソフトウェアに組み込まれているサード パーティの資料に関する情報を表示します。
pack	一連のソース コンテンツからタッチ アダプテーション バンドルを作成します。
serve	クライアント アプリケーションがダウンロードして使用できるように、タッチ アダプテーション バンドルを提供します。
settings	アプリケーションの設定を表示および設定します。
takx-version	含まれているレイアウトのタッチ アダプテーション バンドルとスキーマ バージョンの両方のバージョンを確認します。
unpack	既存のタッチ アダプテーション バンドルをそのコンポーネント ファイルに展開します。
verify	タッチ アダプテーション バンドルのコンテンツが有効であることを確認します。
バージョン	タッチ アダプテーション キット コマンド ライン ツールのバージョン情報を表示します。

オプション

次の表の情報を使用して、すべてのコマンドに適切なフラグを適用します。

オプション	説明
-v, --verbosity	コマンドの出力の詳細レベルを設定します。 これらのフラグの有効な値は、Critical、Debug、Error、Information、None、Trace、および Warning です。 既定の詳細情報は Information です。
--version	バージョン情報を示します。
--accept-license	コマンドを実行する前に、アプリケーションの使用許諾契約に同意します。 自動化に役立ちます。
--reset-appId	コンピューターに関連付けられているアプリケーション ID をリセットします。
-?, -h, --help	ヘルプと使用方法の情報を表示します。

関連項目

タッチの概要
Android コンテンツ テスト アプリケーション (CTA)
Windows PC コンテンツ テスト アプリケーション (CTA)