テストディスクの作成

これらの手順はテスト目的のみのものです。小売シナリオでは、このデータは Partner Center のメタデータに従って自動構成されます。コンパイルディスクを作成するフローで選択されるオプションは、インストール順序、autoplay などを制御するために使用されます。取り込み用にゲームを提出する際、テストメタデータや JSON 構成ファイルを Microsoft に直接提出することはありません。

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

コンピレーション
マルチディスク

コンピレーション

コンピレーションテストディスクの作成

コンピレーションディスクを作成してテストするには、以下で説明するように 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 が有効であることを保証するには、テキストエディターにコピーし、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 パッケージがインストールを完了したときにトリガーされます。特定の種類のゲームディスクでは、これは望ましくない場合があります。非常に短い時間で大量の通知が生成されるためです。たとえば、Game of the Year エディションには、ディスク上に多数の小さな DLC パッケージが含まれる場合があります。この状況に対処するために、DLC の通知は、それが適用されるゲームが既にインストールされている場合にのみトリガーされます。小さな DLC パッケージが多数あるゲームの場合は、DLC がゲームより前にインストールされるように、ディスク上のパッケージを並べ替えることをお勧めします。これにより、DLC パッケージがインストールされるときにユーザーが通知で溢れかえるのを防ぎます。大きな DLC パッケージが少数あるゲームの場合は、すべての DLC パッケージがインストールされるまでゲームをプレイすることをブロックされないように、DLC をメインゲームの後にインストールすることをお勧めします。 DLC とゲームがインストールされる順序を制御するには、catalog.js の Packages JSON 配列内の順序を調整するだけです。この配列がインストールの既定順序を制御します。

デプロイ

コンピレーションディスクをデプロイするには、ディレクトリ構造をディスクに焼き付けます。ディスクを開発キットに挿入すると、小売コンソールのリリースバージョンと同じように起動します。

マルチディスク

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

XVC は、Layout.xml ファイルで定義されている個々のチャンク境界でのみ分割できます。非常に大きなチャンク (45 GB より大きい) を持つ XVC は、マルチディスク機能を使用して公開することができない可能性があります。一般に、タイトルのチャンクは 45 GB より小さく保つのが最善です。

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"
    }
  ]
}  

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

コンピレーション

コンピレーションテストディスクの作成

ディスクレイアウトの作成

Catalog.js

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

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

インストール順序と通知

デプロイ

マルチディスク

Catalog.js

マルチディスク用 Catalog.js の例

関連項目

​コンピレーション

​コンピレーションテストディスクの作成

​ディスクレイアウトの作成

​Catalog.js

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

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

​インストール順序と通知

​デプロイ

​マルチディスク

​Catalog.js

​マルチディスク用 Catalog.js の例

​関連項目

コンピレーション

コンピレーションテストディスクの作成

ディスクレイアウトの作成

Catalog.js

インストール順序と通知

デプロイ

マルチディスク

Catalog.js

マルチディスク用 Catalog.js の例

関連項目