Skip to main content

XPackageChunkSelector

청크 집합을 선택하는 기준을 정의합니다.

구문

멤버

type
형식: XPackageChunkSelectorType
선택자의 형식입니다. language
형식: const char*
“en-US”(영어(미국)) 또는 “fr-FR”(프랑스어(프랑스))와 같이 일치시킬 언어 특성입니다. tag
형식: const char*
BigMap 또는 SmallMap과 같이 일치시킬 태그 특성입니다. feature
형식: const char*
“BigMaps”와 같이 일치시킬 기능입니다. chunkId
형식: uint32_t
일치시킬 청크 번호입니다.

설명

XPackageChunkSelector 개체의 배열은 설치 API의 여러 작업에서 청크 집합을 선택하는 데 사용됩니다. 이 섹션에서는 XPackageChunkSelector 개체 배열을 청크 ID 집합으로 변환하는 데 사용되는 규칙을 설명합니다. 각 XPackageChunkSelector에는 선택자 형식과 선택자 값이 있습니다. 청크에 정의된 모든 청크 지정자가 모든 설치 선택자와 일치하는 경우 해당 청크가 포함됩니다. 패키지에는 게임을 구성하는 모든 파일이 포함되어 있습니다. 파일은 청크라는 논리 단위로 그룹화할 수 있습니다. 청크에는 숫자 ID가 있으며, 언어나 사용자 정의 태그와 같은 텍스트 특성을 0개 이상 가질 수도 있습니다. 많은 XPackage API는 청크 그룹에 대해 작동합니다. 이러한 API는 XPackageChunkSelectors 배열을 사용하여 API가 사용할 청크를 설명합니다. 이 섹션에서는 XPackageChunkSelector 개체 배열을 청크 ID 배열로 변환하는 데 사용되는 규칙을 설명합니다. 각 XPackageChunkSelector에는 선택자 형식과 선택자 값이 있습니다. 청크에 정의된 모든 특성이 모든 청크 선택자와 일치하는 경우 해당 청크가 포함됩니다. 다음 표에서 청크 선택자 배열에는 언어와 태그의 두 가지 선택자가 있습니다. 다음 표는 다양한 특성을 가진 청크 집합을 정의하는 예제입니다. 앞의 표를 참조할 때 청크 선택자 배열에 의해 선택된 청크는 청크 특성 1, 2, 5를 사용합니다. 청크 선택자에 의해 선택되지 않은 청크는 청크 특성 3, 4, 6을 사용합니다. 이 청크 배열 예제를 이해하는 데 도움이 되는 몇 가지 관점:
  • 청크 선택자 형식은 해당 지정자가 청크에 정의된 경우에만 청크 특성과 일치됩니다. 청크 1 - 3에는 태그가 정의되어 있지 않으므로 이러한 청크에 대해서는 태그 형식을 가진 청크 선택자가 무시됩니다.
  • 청크는 세미콜론으로 여러 값을 구분하여 특성에 대한 여러 값을 정의할 수 있습니다. 하나의 값만 일치하면 됩니다.
  • 청크 선택자 형식이 하나라도 거부되면 다른 선택자가 얼마나 많이 일치하든 관계없이 청크가 거부됩니다. 청크 6은 SmallMap이 BigMap과 일치하지 않기 때문에 거부되지만 언어는 일치합니다.
청크 선택자 값은 청크의 레이아웃 파일에서와 마찬가지로 세미콜론으로 구분된 여러 값을 포함할 수 있습니다. 또한 동일한 청크 선택자 형식을 두 번 이상 정의하는 배열도 유효합니다. 다음 코드 예제와 같이 이러한 표현은 서로 동일합니다.
플랫폼은 일치하는 지역 집합을 추가로 필터링할 수 있습니다. 예를 들어, 특정 콘솔 집합에서만 청크를 사용할 수 있도록 청크에 Devices 특성을 추가할 수 있습니다. 선택한 청크는 시스템 특성과도 일치하는 경우에만 포함됩니다. 독일어를 설치하려는데 패키지에 XBOX One X 콘솔에서만 사용할 수 있는 독일어 청크가 있는 경우, XBOX One 콘솔에서는 설치 모니터가 이 청크를 모니터링에 포함하지 않습니다. 그렇게 되면 독일어 설치가 완료되지 않기 때문입니다. XBOX One 타이틀에 사용되는 패키징 기술에 대한 자세한 내용은 패키징 개요를 참조하세요. XVC 패키지를 만드는 단계에 대한 자세한 내용은 XBOX 콘솔용 타이틀 패키징 시작을 참조하세요.

요구 사항

헤더: XPackage.h 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

스트리밍 설치 및 Intelligent Delivery
XPackage
마지막 수정일 2026년 8월 24일