テストディスクの作成

[アーティクル]
11/11/2023

注意

これらの手順は、テストのみを目的としています。リテールシナリオでは、このデータはパートナーセンターメタデータに従って自動構成されます。オムニバス形式ディスクを作成するためのフローで選択されたオプションは、インストール順序、自動スタートなどを制御するために使用されます。ゲームをインジェストのために提出する場合は、テストメタデータや JSON config ファイルをマイクロソフトに直接提出することはしません。

このトピックでは、テストディスクを作成する方法について説明します。次の種類のテストディスクを作成できます。

オムニバス形式
複数のディスク

オムニバス形式

テスト用のオムニバス形式ディスクを作成する

オムニバス形式ディスクを作成およびテストするには、以下の説明に従って catalog.js メタデータファイルおよびディスクレイアウトを作成する必要があります。

ディスクレイアウトを作成する
catalog.js
インストールの順序付けと通知
配置

ディスクレイアウトを作成する

次の例のようなディスクレイアウトを作成します。

- Disc Root
    - Licenses (folder) - (Not needed for Xbox One ERA Development Kits - make sure to use XVCs created with /LT flag)
        License0.xml (file) - (Not needed for Xbox One ERA dev kits - make sure to use XVCs created with /LT flag)
    - MSXC (folder)
        - Package1.xvc (file)
        - Package2.xvc (file)
        - Metadata (folder)
            - catalog.js (file)
            - Bundle (folder)
                - Bundle images (files)
            - Package1.xvc (folder)
                - Package 1 images (files)
            - Package2.xvc (folder)
                - Package 2 images (files)

ディレクトリの内容は次のようになります。

Licenses には、ゲームのライセンスファイルが格納されます。この情報は、Xbox One ERA 開発キットには必要ありません。必ず /LT フラグを使用して作成された XVC を使用してください。以降、これは省略できます。
MSXC には、パッケージ化されたゲームと、Xbox シェルによって使用されるメタデータが格納されます。
Metadata には、シェルがディスク上のゲームおよびゲームパッケージに対して使用するメタデータが格納されます。
Bundle には、シェルによって使用されるイメージが格納されます。
Package1.XVC には、最初のゲームに対してシェルが使用するイメージが格納されます。名前は MSXC 内のゲームパッケージファイルの名前と一致する必要があります。
Package2.XVC には、2 番目のゲームに対してシェルが使用するイメージが格納されます。名前は MSXC 内のゲームパッケージファイルの名前と一致する必要があります。

catalog.js

Metadata フォルダーには、catalog.js という名前のファイルを作成します。このファイルを編集し、他のフォルダーにあるパッケージおよびイメージの名前を反映させます。このファイルは UTF-16 LE でエンコードする必要があります。 Web 上の JSON バリデーターを使用することを推奨します。 JSON が有効であることを確認するには、その JSON をテキストエディターにコピーしてから、ファイルを UTF-16 LE 形式で保存します。

マルチゲームシナリオ用 catalog.js ファイルの例 (コメント付き)

{
  "version": "4.1",                                        // Don't adjust this value.
  "bundle": {
    "oneStoreProductId": "9P436MXJ71GV",                   // Replace with your bundle product id.
    "titles": [
      {
        "locale": "default",
        "title": "Bundle Title"                            // Replace with bundle title.
      }
    ],
    "images": [
      {
        "size": "100x100",                                 // Don't change the size values.
        "image": "100x100_1.png"                           // Must match the image file names in MSXC\Metadata\Bundle\
      },
      {
        "size": "208x208",
        "image": "208x208_1.png"
      },
      {
        "size": "480x480",
        "image": "480x480_1.png"
      }
    ]
  },
  "packages": [                                             // This is an array of packages.
    {
      "packageName": "Package1.xvc",                        // Match your package name in MSXC\<package name> and MSXC\Metdata\<package name>
      "oneStoreProductId": "BX38WRFV50MJ",                  // Product id for package 1.
      "contentId": "2b05043b-4043-4ba0-80ed-fd4811c4b333",  // Content id for package 1.  Must match the content id of the package file.
      "franchiseGameHubId": "47445142-3636-3036-C048-464D4E574000", // Optional; Replace with the FranchiseGameHubId. This marks the package as a game hub
      "titleId": "037C3A1D",                                // Title id for package 1.
      "titles": [
        {
          "locale": "default",
          "title": "Killer Instinct"                        // Package 1 title.
        }
      ],
      "images": [
        {
          "size": "100x100",
          "image": "100x100_1.png"                          // Match file names in MSXC\Metadata\<Package1>\
        },
        {
          "size": "208x208",
          "image": "208x208_1.png"
        },
        {
          "size": "480x480",
          "image": "480x480_1.png"
        }
      ],
      "ratings": [
        {
          "system": "OFLC",
          "value": "M"
        },
        {
          "system": "DJCTQ",
          "value": "14"
        },
        {
          "system": "PCBP",
          "value": "Unrated"
        },
        {
          "system": "USK",
          "value": "16"
        },
        {
          "system": "ESRB",
          "value": "T"
        },
        {
          "system": "CERO",
          "value": "Unrated"
        },
        {
          "system": "CSRR",
          "value": "Unrated"
        },
        {
          "system": "COB",
          "value": "M"
        },
        {
          "system": "GRB",
          "value": "Unrated"
        },
        {
          "system": "PEGI",
          "value": "16"
        },
        {
          "system": "PEGIPortugal",
          "value": "Unrated"
        }
      ],
      "type": "Game"
  },
  {
    "packageName": "Package2.xvc",
    "oneStoreProductId": "BVC818MXZ6KG",
    "contentId": "4a6cb1d0-5ad3-47b7-9583-7480098b4a26",
    "associatedFranchiseGameHubId": "47445142-3636-3036-C048-464D4E574000", // Replace with the FranchiseGameHubId of the corresponding franchise game hub that this package is launched with. Optional;
    "titleId": "669E1864",
    "titles": [
      {
        "locale": "default",
        "title": "LocoCycle"
      }
    ],
    "images": [
      {
        "size": "100x100",
        "image": "100x100_1.png"
      },
      {
        "size": "208x208",
        "image": "208x208_1.png"
      },
      {
        "size": "480x480",
        "image": "480x480_1.png"
      }
    ],
    "ratings": [
      {
        "system": "OFLC",
        "value": "PG"
      },
      {
        "system": "DJCTQ",
        "value": "10"
      },
      {
        "system": "USK",
        "value": "12"
      },
      {
        "system": "ESRB",
        "value": "T"
      },
      {
        "system": "PEGI",
        "value": "12"
      },
      {
        "system": "COB",
        "value": "PG"
      }
    ],
    "type": "Game"
    }
  ]
}

ゲーム + 非消耗品ダウンロードコンテンツ (DLC) シナリオ用 catalog.js の例

{
  "version": "4.0",                                        // Don't adjust this value.
  "bundle": {
    "oneStoreProductId": "9P436MXJ71GV",                   // Replace with bundle product id.
    "launchPackage": "Package3.xvc",                       // Should be the package name of the game package.  This is the package that is launched when the game disc is inserted.
    "titles": [
      {
        "locale": "default",                                        
        "title": "Game + DLC Bundle Title"                 // Replace with bundle name.
      }
    ],
    "images": [
      {
        "size": "100x100",
        "image": "100x100_1.png"                           // Must match the image file names in MSXC\Metadata\Bundle\
      },
      {
        "size": "208x208",
        "image": "208x208_1.png"
      },
      {
        "size": "480x480",
        "image": "480x480_1.png"
      }
    ]
  },
  "packages": [
    {
      "packageName": "Package1.xvc",                       // Match folder name in MSXC\Metadata\<folder name>
      "oneStoreProductId": "BX38WRFV50MJ",                 // Replace with DLC 1 product id.
      "contentId": "ace6ef3b-0c5b-4f17-a651-390e75169d5c", // Replace with DLC 1 content id. This must match the content id of the package file.
      "allowedOneStoreProductIds": [
        "BVC818MXZ6KG"                                     // Should match the product id of the game that will load this DLC.
      ],
      "titles": [
        {
          "locale": "default",
          "title": "DLC Title 1"
        }
      ],
      "images": [
        {
          "size": "100x100",
          "image": "100x100_1.png"                         // Match file names in MSXC\Metadata\Package1.xvc\
        },
        {
          "size": "208x208",
          "image": "208x208_1.png"
        },
        {
          "size": "480x480",
          "image": "480x480_1.png"
        }
      ],
      "ratings": [
        {
          "system": "ESRB",
          "value": "E"
        }
      ],
      "type": "Durable"                                    // Indicates that this is a DLC package.
    },
    {
      "packageName": "Package2.xvc",
      "oneStoreProductId": "9P436MXJ71GV",
      "contentId": "b0f77189-d74c-4005-b351-955d380cb875",
      "allowedOneStoreProductIds": [
        "BVC818MXZ6KG"
      ],
      "titles": [
        {
          "locale": "en-US",
          "title": "DLC Title 2"
        }
      ],
      "images": [
        {
          "size": "100x100",
          "image": "100x100_1.png"
        },
        {
          "size": "208x208",
          "image": "208x208_1.png"
        },
        {
          "size": "480x480",
          "image": "480x480_1.png"
        }
      ],
      "ratings": [
        {
          "system": "ESRB",
          "value": "E"
        }
      ],
      "type": "Durable"
    },
    {
      "packageName": "Package3.xvc",
      "oneStoreProductId": "BVC818MXZ6KG",
      "contentId": "5519355c-bff9-40b4-92bb-b5473fd9c577",
      "titleId": "35c8f637",
      "titles": [
        {
          "locale": "default",
          "title": "Game Title"
        }
      ],
      "images": [
        {
          "size": "100x100",
          "image": "100x100_1.png"
        },
        {
          "size": "208x208",
          "image": "208x208_1.png"
        },
        {
          "size": "480x480",
          "image": "480x480_1.png"
        }
      ],
      "ratings": [
        {
          "system": "ESRB",
          "value": "E"
        }
      ],
      "type": "Game"                                       // Indicates main game package.
    }
  ]
}

インストールの順序付けと通知

DLC のインストール通知は、通常、DLC パッケージがインストールを完了したときにトリガーされます。ゲームディスクのタイプによっては、非常に短い時間の間に大量の通知が作成されることがあるため、この動作が望ましくない場合があります。たとえば、ゲームオブザイヤーエディションで、ディスクに大量の小さな DLC パッケージが含まれている場合があります。このような状況に対処するため、DLC の通知は、適用対象のゲームがインストール済みの場合にのみトリガーされます。

大量の小さな DLC パッケージが含まれるゲームの場合、ゲームの前に DLC がインストールされるようにディスク上のパッケージに順序付けすることをお勧めします。これで、DLC パッケージがインストールされるときの通知がユーザーに大量に送信されなくなります。

少量の大きな DLC パッケージが含まれるゲームの場合、すべての DLC パッケージがインストールされまでユーザーのゲームプレイがブロックされることがないように、メインのゲームの後に DLC をインストールすることをお勧めします。

DLC とゲームがインストールされる順序を制御するには、catalog.js 内の Packages JSON 配列で、それらの順序を単純に調整します。この配列によって、インストールの既定の順序が制御されます。

配置

オムニバス形式ディスクを配置するには、ディレクトリ構造をディスクに書き込みます。ディスクを開発キットに挿入すると、リテール版本体上でリリースバージョンが起動するのと同じように起動します。

複数のディスク

複数のディスクをテスト用に作成するには、既存の XVC を 2 つのファイルに分割します。

注意

XVC は、Layout.xml ファイルで定義されているように、個々のチャンク境界でのみ分割できます。チャンクが非常に大きい (45 GB 以上の) XVC は、複数ディスク機能を使用して公開できない可能性があります。一般に、タイトルのチャンクは 45GB 未満とすることをお勧めします。

XVC を 2 つのディスクに分割するには、次のような DiscLayout.xml ファイルを作成します。

<Packages>
  <Package Name="MultiDisc" Description="Package published on 2 discs" MaxDiscs="2">
  </Package>
</Packages>

次に、SplitPkg を呼び出してディスクに書き込む個別のファイルを生成します。これで、オリジナルの XVC ファイル名の末尾に「MultiDisc.1」と「MultiDisc.2」がついた 2 つのファイルが生成されます。

SplitPkg /f DiscLayout.xml /p sourceXVC /s Multidisc /pd outputDir

複数のディスクからのインストールをシミュレートするには、ディスク 1 の xbapp install とディスク 2 の xbapp install を使用します。ディスク 1 のコンテンツがインストールされると、本体からディスク 2 を挿入するように求められます。

catalog.js

これらのテストディスクを書き込むには、新しい discNumber、discCount、および discSetId フィールドで Catalog.js ファイルを作成します。 すべてのディスクにこれらすべてのメタデータが必要であることに注意してください。各ディスクの Catalog.js ファイルの唯一の違いは、discNumber フィールドの値だけです。たとえば、ディスク 1 に 1 の値を持たせ、ディスク 2 に 2 の値を持たせるといった要領になります。ゼロ (0) は予備の値です。使用しないでください。

複数ディスク用の Catalog.js の例

{
  "version": "4.0",                                         // Don't adjust this value.
  "discNumber": 1,                                          // 1 for disc 1, 2 for disc 2.
  "discCount": 2,                                           // Same on all discs.
  "discSetId": "00000001",                                  // For test purposes, this can be 00000001. On retail discs, this value is unique for each published disc set. 
                                                            // Don't mix installations of test discs from different sets if they share this value. Cancel your installation before starting a new one.
  "packages": [                                             // This is an array of packages.
    {
      "packageName": "Package1.xvc",                        // Match your package name in MSXC\package-name and MSXC\Metdata\package-name
      "oneStoreProductId": "BX38WRFV50MJ",                  // Product id for package 1.
      "contentId": "2b05043b-4043-4ba0-80ed-fd4811c4b333",  // Content id for package 1. Must match the content id of the package file.
      "titleId": "037C3A1D",                                // Title id for package 1.
      "titles": [
      {
        "locale": "default",
        "title": "Killer Instinct"                          // Package 1 title.
      }
    ],
    "images": [
      {
        "size": "100x100",
        "image": "100x100_1.png"                            // Match file names in MSXC\Metadata\Package1\
      },
      {
        "size": "208x208",
        "image": "208x208_1.png"
      },
      {
        "size": "480x480",
        "image": "480x480_1.png"
      }
    ],
    "ratings": [
      {
        "system": "OFLC",
        "value": "M"
      },
      {
        "system": "DJCTQ",
        "value": "14"
      },
      {
        "system": "PCBP",
        "value": "Unrated"
      },
      {
        "system": "USK",
        "value": "16"
      },
      {
        "system": "ESRB",
        "value": "T"
      },
      {
        "system": "CERO",
        "value": "Unrated"
      },
      {
        "system": "CSRR",
        "value": "Unrated"
      },
      {
        "system": "COB",
        "value": "M"
      },
      {
        "system": "GRB",
        "value": "Unrated"
      },
        {
        "system": "PEGI",
        "value": "16"
      },
      {
        "system": "PEGIPortugal",
        "value": "Unrated"
      }
    ],
      "type": "Game"
    }
  ]
}

次の方法で共有

テストディスクの作成

オムニバス形式

テスト用のオムニバス形式ディスクを作成する

ディスクレイアウトを作成する

catalog.js

マルチゲームシナリオ用 catalog.js ファイルの例 (コメント付き)

ゲーム + 非消耗品ダウンロードコンテンツ (DLC) シナリオ用 catalog.js の例

インストールの順序付けと通知

配置

複数のディスク

catalog.js

複数ディスク用の Catalog.js の例

関連項目

その他のリソース

次の方法で共有

テスト ディスクの作成

オムニバス形式

テスト用のオムニバス形式ディスクを作成する

ディスク レイアウトを作成する

catalog.js

マルチゲーム シナリオ用 catalog.js ファイルの例 (コメント付き)

ゲーム + 非消耗品ダウンロード コンテンツ (DLC) シナリオ用 catalog.js の例

インストールの順序付けと通知

配置

複数のディスク

catalog.js

複数ディスク用の Catalog.js の例

関連項目

その他のリソース

テストディスクの作成

ディスクレイアウトを作成する

マルチゲームシナリオ用 catalog.js ファイルの例 (コメント付き)

ゲーム + 非消耗品ダウンロードコンテンツ (DLC) シナリオ用 catalog.js の例