Pack コマンド
pack コマンドは、タッチ アダプテーション バンドル (takx) にレイアウトをパッケージ化するために使用されます。
このバンドルは、serve コマンドを介してローカル テストで利用できます。または、ユーザーが Xbox ゲーム ストリーミング経由で利用できるように Microsoft アカウント担当者によって提出されます。
次の表に、pack コマンドで使用できるさまざまなオプションを示します。
| オプション | 説明 |
|---|---|
--layout-path <layout-path> |
バンドルに含めるルート レイアウト ディレクトリのパス。 このパラメーターは必須です。 |
--out--output-path <output-path> |
パッケージ化されたタッチ アダプテーション バンドルの出力ファイルを指定します。 通常は .takx ファイルです。 このパラメーターは必須です。 |
--asset-path <asset-path> |
バンドルに含めるルート アセット ディレクトリのパス。 バンドルにアセットがない場合、このパラメーターは必須ではありません。 |
--context file <context-file> |
バンドルに含めるコンテキスト ファイルのパス。 バンドルにコンテキストがない場合、このパラメーターは必須ではありません。 |
--default-layout <default-layout> |
既定のレイアウトの名前。 これは、レイアウト パスのひとつのファイルの名前と一致する必要があります。 |
--version <version> |
タッチ アダプテーション バンドルのコンテンツ バージョン (1.0.0.0 など)。 タイトルのために Microsoft に提出される各タッチ アダプテーション バンドルには、送信済みの以前のタッチ アダプテーション バンドルよりも、意味的に大きいバージョン番号が必要です。 takx-version コマンドを使用して、既存のバンドルのバージョンを調べることができます。 ゲームのストリーミング中に使用されているタッチ アダプテーション バンドルのバージョン番号は、XGameStreamingGetTouchBundleVersion を呼び出すことによって取得できます。 |
--version-name <version-name> |
タッチ アダプテーション バンドルのコンテンツ バージョンの名前 ("DLC 1" など)。 バージョン番号とは異なり、バージョン名は省略可能であり、その形式に要件はありません。 takx-version コマンドを使用して、既存のバンドルのバージョンを調べることができます。 ゲームのストリーミング中に使用されているタッチ アダプテーション バンドルのバージョン名は、XGameStreamingGetTouchBundleVersion を呼び出すことによって取得できます。 |
--no-asset-optimization |
効率的な記憶域と通信のためにアセットを最適化していないことを確認します。 セットされている場合、アセットは変更されません。 |
--no-verify |
生成されたタッチ アダプテーション バンドルが有効で確認されていないことを確認します。 |
--language <language> |
生成されたバンドルに含める言語の IETF 言語タグ。 このパラメーターを複数回指定した場合、提供されるすべての言語が含まれます。 パラメーターを指定しない場合、ソース ディレクトリに見つかったすべてのレイアウトとアセットがバンドルに含まれます。 |
例
次のコード例を使って、レイアウトをタッチ アダプテーション バンドルにパッケージします。
レイアウト パス内のすべてのレイアウトを、バージョン 1.0.0.0 の単一のタッチ アダプテーション バンドルにパックします。
C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --version 1.0.0.0
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.
レイアウト パス内のすべてのレイアウトを単一のタッチ アダプテーション バンドルにパックします。 ゲームによって特定のレイアウト要求が行われる前にユーザーに提示されるレイアウト introLayout を設定します。
C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --default-layout introLayout
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.
アセットの最適化を行わずに、レイアウト パス内の en-us レイアウトのみを単一のタッチ アダプテーション バンドルにパックします
C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --language en-us --no-asset-optimization
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.
レイアウト パス内の en-us および es-us レイアウトのみを単一のタッチ アダプテーション バンドルにパックします。
C:\>tak pack --layout-path C:\tmp\layouts --out C:\tmp\MyGameLayouts.takx --language en-us --language es-us
Building touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'
Verifying touch adaptation bundle 'C:\tmp\MyGameLayouts.takx'.
Verification complete. 0 error(s) and 0 warning(s) found.