クロスジェネレーションのテスト ディスクの概要
このトピックを使用して、クロスジェネレーション テスト ディスクを作成して、Xbox Oneファミリー 本体と Xbox Series 本体間でタイトルをテストできるようにします。
注意
これらの手順は、テストのみを目的としています。 リテール シナリオでは、このデータはパートナー センターにあるメタデータに従って自動構成されます。 コンパイル ディスクを作成するためのフローで選択されたオプションは、インストール順序や自動スタートなどの設定を制御するために使用されます。 取り込みのためにゲームを送信するときに、テスト メタデータまたは JSON 構成ファイルを Microsoft に送信しません。
次の種類のテスト ディスクを作成できます。
スマート配信ディスクを作成する
スマート配信ディスクには、Xbox One ファミリー 本体と Xbox Series 本体用のパッケージが含まれています。 パッケージには、両方のパッケージで機能するライセンスがあります。 これらは、パートナー センターの同じ製品の一部です。 コンソールに挿入すると、コンソール タイプに適したパッケージがインストールされます。 可能な場合は、インストールに該当するコンテンツの更新の開始が含まれます。
注意
本体の世代ごとに、ディスク上の別のパートナー センター製品を使用してゲームのパッケージを作成する場合、これはマルチ製品ディスクと呼ばれます。詳細については、このトピックの 「複数製品ディスク 」セクションを参照してください。
スマート配信ディスクを作成してテストする
スマート配信ディスクを作成してテストするには、このトピックの次のセクションで説明するように、catalog.js メタデータ ファイルとディスク レイアウトを作成します。
ディスク レイアウトを作成する
次の例のようなディスク レイアウトを作成します。
- Disc Root
- Licenses (folder) - (Not needed for Xbox One ERA Development Kits. Use XVCs that are created with the /LT flag or /LK flag.)
License0.xml (file) - (Not needed for Xbox One ERA dev kits. Use XVCs that are created with the /LT or /LK flag.)
- MSXC (folder)
- Package_x.xvc (file)
- Package_xs.xvc (file)
- Metadata (folder)
- catalog.js (file)
- Package_x.xvc (folder)
- Package images (files)
Package_x.xvc と Package_xs.xvc は、本体世代ごとのパッケージです。 MakePkg ツールは、Xbox One パッケージの場合は _x、Xbox Series X|S 世代のパッケージの場合は _xs のサフィックスをパッケージに付けます。 これらのパッケージの 1 つは、catalog.js ファイルで他のパッケージの "バリアント" として宣言されています。 前回の例では Package_xs.xvc は Package_x.xvc のバリアントです。
ディレクトリの内容は次のようになります。
- Licenses には、ゲームのライセンス ファイルが格納されます。 この情報は、Xbox One ERA 開発キットには必要ありません。 フラグ
/LTまたは/LKフラグを使用して作成された XBC を使用します。 以降、これは省略できます。
Important
フラグで /LK 作成されたパッケージを使用している場合は、 xbapp installkey を使用して CEKB ファイルをターゲット コンソールにインストールする必要があります。 これにより、ディスク上の /LK パッケージの復号化が可能になります。詳細については、「 xbapp.exe (NDA トピック)」認可が必須です を参照してください。
MSXC には、パッケージ化されたゲームと、Xbox シェルによって使用されるメタデータが格納されます。
Metadata には、シェルがディスク上のゲームおよびゲーム パッケージに対して使用するメタデータが格納されます。
Package_x.xvc には、ゲームに対してシェルが使用するイメージが格納されます。 名前は MSXC 内のゲーム パッケージ ファイルの名前と一致する必要があります。 他のパッケージのバリアントであるパッケージのイメージを指定する必要はありません。
catalog.js
Metadata フォルダーには、catalog.js という名前のファイルを作成します。 このファイルを編集して、他のフォルダーにあるパッケージと画像の名前を反映させます。
注意
このファイルは UTF-8 でエンコードされている必要があります。 Web 上の JSON バリデーターを使用することを推奨します。 JSON が有効化されていることを確認するには、その JSON をテキスト エディターにコピーしてから、ファイルを UTF-8 形式で保存します。
スマート デリバリー製品の例
以下は、インライン コメント付きのスマート配信を使用する catalog.js ファイルの単一製品の例です。
{
"version": "4.0", // Don't adjust this value.
"packages": [ // This is an array of packages.
{
"packageName": "Package_x.xvc", // Match your package name in MSXC\<package name> to the package name in MSXC\Metadata\<package name>.
"generation": "8", // Enter "8" for Xbox One packages, or enter "9" for Xbox Series X|S generation packages.
"oneStoreProductId": "BX38WRFV50MJ", // Partner Center Product ID for the package.
"contentId": "2b05043b-4043-4ba0-80ed-fd4811c4b333", // Content ID for your package. Match this to the Content ID of the package file.
"titleId": "037C3A1D", // Title ID for your package.
"variants" : [
{
"generation": "9", // The console generation for this variant of the package. Enter "8" for Xbox One packages, or enter "9" for Xbox Series X|S generation packages.
"packageName": "Package_xs.xvc" // The package name for this variant. All packages must have the same Content ID or Product ID.
}
],
"titles": [
{
"locale": "default",
"title": "Killer Instinct" // Package title.
}
],
"images": [
{
"size": "100x100",
"image": "100x100_1.png" // Match the file names to MSXC\Metadata\<Package_x>\.
},
{
"size": "208x208",
"image": "208x208_1.png"
},
{
"size": "480x480",
"image": "480x480_1.png"
}
],
"ratings": [ // This ratings information is only for example purposes.
{ // This is automatically generated for your discs
"system": "OFLC", // by using the information that's published in Partner Center.
"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"
}
]
}
マルチ製品ディスク
複数製品のディスクには、Xbox Oneおよび Xbox Series X|S 本体用のパッケージが含まれています。 ディスクには、各パッケージのライセンスが含まれています。 これらのパッケージは、パートナー センターにある個別の製品から提供されます。 それらには、パートナー センターで構成された明示的な世代間の関係があります。 デジタル バンドルとして販売されている場合、またはディスクを使用してコンソールにインストールされている場合、既定でインストールされるパッケージは 1 つだけです。 ディスクがコンソールに挿入されると、コンソール タイプに適したパッケージがインストールされます。 可能な場合は、これに該当するコンテンツの更新の開始が含まれます。
注意
1 つのパートナー センター製品を使用して、本体の世代ごとにパッケージを作成する場合、これはクロスジェネレーション スマート配信ディスクと呼ばれます。詳細については、このトピックの 「スマート配信 」セクションを参照してください。
マルチプロダクト ディスクの例
以下は、インライン コメント付きの catalog.js ファイルの複数製品ディスクの例です。
{
"version": "4.0", // Don't change this value.
"bundle": {
"oneStoreProductId": "9P436MXJ71GV", // Replace with the game bundle Product ID.
"launchPackage": "Package1_x.xvc", // This is the package that is launched when the game disc is inserted into the console.
"titles": [
{
"locale": "default",
"title": "Game Title" // Replace with the game bundle name.
}
],
"images": [
{
"size": "100x100",
"image": "100x100_1.png" // Match this to the image file names that are in MSXC\Metadata\Bundle\.
},
{
"size": "208x208",
"image": "208x208_1.png"
},
{
"size": "480x480",
"image": "480x480_1.png"
}
]
},
"siblings": [ // The sibling entry that sets these two packages as
[ // related. The correct package for the console
"Package1_x.xvc", // type is chosen.
"Package2_xs.xvc" // Note: the sibling relationships are an array
] // of arrays.
],
"packages": [
{
"packageName": "Package1_x.xvc", // Match this to the folder name that's in MSXC\Metadata\<folder name>.
"generation": "8", // Xbox One family generation that's used for Xbox One and Xbox Series X|S consoles.
"oneStoreProductId": "BX38WRFV50MJ", // Replace with Package 1 Product ID.
"contentId": "ace6ef3b-0c5b-4f17-a651-390e75169d5c", // Replace with Package 1 Content ID. Match the ID to the Content ID of the package file.
"titles": [
{
"locale": "default",
"title": "Game Title Xbox One Edition"
}
],
"images": [
{
"size": "100x100",
"image": "100x100_1.png" // Match file names that are in MSXC\Metadata\Package1_x.xvc\.
},
{
"size": "208x208",
"image": "208x208_1.png"
},
{
"size": "480x480",
"image": "480x480_1.png"
}
],
"ratings": [
{
"system": "ESRB",
"value": "E"
}
],
"type": "Game"
},
{
"packageName": "Package2_xs.xvc",
"generation": "9",
"oneStoreProductId": "BVC818MXZ6KG",
"contentId": "5519355c-bff9-40b4-92bb-b5473fd9c577",
"titleId": "35c8f637",
"titles": [
{
"locale": "default",
"title": "Game Title Xbox Series generation edition"
}
],
"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"
}
]
}