교차 생성 테스트 디스크 개요
이 항목을 사용하여 세대 간 테스트 디스크를 만들어 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(으)로 패키지 접미사를 붙입니다. 이러한 패키지 중 하나는 catalog.js 파일의 다른 패키지의 "변형"으로 선언됩니다. 이전 예에서 Package_xs.xvc는 Package_x.xvc의 변형입니다.
디렉토리에는 다음과 같은 내용이 있습니다.
- 라이선스에는 게임에 대한 라이선스 파일이 포함되어 있습니다. 이 정보는 Xbox One ERA 개발 키트에 필요하지 않습니다.
/LT또는/LK플래그를 사용하여 만든 XVC를 사용합니다. 이 작업은 나중에 생략할 수 있습니다.
Important
플래그로 /LK 만든 패키지를 사용하는 경우 xbapp installkey 를 사용하여 CEKB 파일을 대상 콘솔에 설치해야 합니다. 이렇게 하면 디스크에서 /LK 패키지를 해독할 수 있습니다. 자세한 내용은 xbapp.exe(NDA 항목)권한 부여 필요 를 참조하세요.
MSXC에는 패키징된 게임과 Xbox 셸이 사용하는 메타데이터가 포함되어 있습니다.
Metadata에는 셸이 디스크의 게임 및 게임 패키지에 사용하는 메타데이터가 포함되어 있습니다.
Package_x.xvc에는 셸이 게임에 사용하는 이미지가 포함되어 있습니다. 이름은 MSXC에 있는 게임 패키지 파일과 일치해야 합니다. 다른 패키지의 변형인 패키지에 대해 이미지를 제공할 필요가 없습니다.
Catalog.js
메타데이터 폴더에 catalog.js라는 파일을 만듭니다. 이 파일을 편집하여 다른 폴더에 있는 패키지와 이미지의 이름을 반영합니다.
참고 항목
이 파일은 UTF-8로 인코딩되어야 합니다. 웹에서 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 콘솔용 패키지가 포함되어 있습니다. 디스크에는 각 패키지에 대한 라이선스가 포함되어 있습니다. 이러한 패키지는 파트너 센터에 있는 개별 제품에서 제공됩니다. 이들은 파트너 세트에 구성된 명확한 세대 관계를 갖고 있습니다. 패키지 중 하나만 디지털 번들로 판매되거나 디스크를 사용하여 콘솔에 설치할 때 기본적으로 설치됩니다. 디스크가 콘솔에 삽입되면 콘솔 유형에 적합한 패키지가 설치됩니다. 여기에는 해당되는 모든 콘텐츠 업데이트(사용 가능한 경우) 개시 작업이 포함됩니다.
참고 항목
단일 파트너 센터 제품을 사용하여 콘솔 세대당 패키지를 만들려는 경우 이를 세대 간 스마트 배달 디스크라고 합니다. 자세한 내용은 이 항목의 스마트 배달 섹션을 참조하세요.
다중 제품 디스크 예제
다음은 인라인 설명이 포함된 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"
}
]
}