> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPackage (API 콘텐츠)

> XPackage

# XPackage

XPackage API에 대한 참조 자료입니다.

## 함수

| 함수 | 설명 |
| - | - |
| [XPackageChangeChunkInstallOrder](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagechangechunkinstallorder.md) | 선택한 청크를 먼저 설치하도록 설정합니다. |
| [XPackageChunkAvailabilityCallback](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagechunkavailabilitycallback.md) | [XPackageEnumerateChunkAvailability](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageenumeratechunkavailability.md)에서 사용하는 사용자 정의 콜백입니다. |
| [XPackageCloseInstallationMonitorHandle](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagecloseinstallationmonitorhandle.md) | 지정된 설치 모니터를 닫습니다. |
| [XPackageCloseMountHandle](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageclosemounthandle.md) | 지정된 탑재 핸들을 닫습니다. |
| [XPackageCreateInstallationMonitor](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagecreateinstallationmonitor.md) | 설치 상태를 모니터링하는 모니터를 만듭니다. |
| [XPackageEnumerateChunkAvailability](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageenumeratechunkavailability.md) | 설치 패키지를 조사하고 지정된 선택자와 일치하는 모든 청크의 가용성을 열거합니다. |
| [XPackageEnumerateFeatures](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageenumeratefeatures.md) | 패키지의 레이아웃 파일에 정의된 기능을 열거합니다. |
| [XPackageEnumeratePackages](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageenumeratepackages.md) | 호출 프로세스와 관련된 설치된 패키지 또는 설치 중인 패키지를 찾습니다. |
| [XPackageEnumerationCallback](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageenumerationcallback.md) | [XPackageEnumeratePackages](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageenumeratepackages.md)에서 사용하는 콜백입니다. |
| [XPackageEstimateDownloadSize](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageestimatedownloadsize.md) | 지정된 설치 선택자와 일치하는 청크의 다운로드 크기를 계산합니다. |
| [XPackageFeatureEnumerationCallback](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagefeatureenumerationcallback.md) | XPackageEnumerateFeatures에서 각 기능을 열거하는 데 사용하는 콜백입니다. |
| [XPackageFindChunkAvailability](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagefindchunkavailability.md) | 지정된 선택자와 일치하는 청크 컬렉션의 최소 가용성을 반환합니다. |
| [XPackageGetCurrentProcessPackageIdentifier](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagegetcurrentprocesspackageidentifier.md) | 이 프로세스의 설치를 식별하는 설치 ID 문자열을 반환합니다. |
| [XPackageGetInstallationProgress](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagegetinstallationprogress.md) | 설치의 현재 진행률을 반환합니다. |
| [XPackageGetMountPath](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagegetmountpath.md) | 탑재된 설치의 경로를 가져옵니다. |
| [XPackageGetPackageKind](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagegetpackagekind.md) | 패키지의 [XPackageKind](https://docs.xbox.com/ko/reference/system/xpackage/enums/xpackagekind.md)를 반환합니다. |
| [XPackageGetMountPathSize](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagegetmountpathsize.md) | [XPackageGetMountPath](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagegetmountpath.md)에서 반환된 탑재 경로를 담을 배열에 필요한 크기를 가져옵니다. |
| [XPackageGetUserLocale](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagegetuserlocale.md) | 현재 사용자 로캘을 가져옵니다. |
| [XPackageGetWriteStats](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagegetwritestats.md) | 출력 쓰기 통계(writeStats)를 가져옵니다. |
| [XPackageInstallationProgressCallback](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageinstallationprogresscallback.md) | [XPackageRegisterInstallationProgressChanged](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged.md)에서 사용하는 콜백입니다. |
| [XPackageInstallChunks](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageinstallchunks.md) | 청크 설치를 시작합니다. |
| [XPackageInstallChunksAsync](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageinstallchunksasync.md) | 청크 설치를 시작합니다. |
| [XPackageInstallChunksResult](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageinstallchunksresult.md) | [XPackageInstallChunksAsync](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageinstallchunksasync.md) 호출의 결과를 검색합니다. |
| [XPackageInstalledCallback](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageinstalledcallback.md) | XPackageRegisterPackageInstalled 함수에서 사용하는 사용자 정의 콜백입니다. |
| [XPackageIsPackagedProcess](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageispackagedprocess.md) | 현재 프로세스에 설치 ID가 있는지 여부를 나타내는 부울을 반환합니다. |
| [XPackageMount](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagemount.md) | 이 함수는 이제 사용되지 않습니다. 대신 XPackageMountWithUiAsync를 사용하세요. |
| [XPackageMountWithUiAsync](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagemountwithuiasync.md) | 지정된 콘텐츠의 설치를 비동기적으로 탑재하고 이에 대한 탑재 핸들을 반환합니다. |
| [XPackageMountWithUiResult](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagemountwithuiresult.md) | XPackageMountWithUIAsync 호출의 결과를 가져옵니다. |
| [XPackageRegisterInstallationProgressChanged](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageregisterinstallationprogresschanged.md) | 설치 진행률이 변경될 때 호출할 콜백을 등록합니다. |
| [XPackageRegisterPackageInstalled](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md) | 설치가 완료될 때 호출할 콜백을 등록합니다. |
| [XPackageUninstallPackage](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageuninstallpackage.md) | 지정된 패키지를 제거합니다. |
| [XPackageUninstallChunks](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageuninstallchunks.md) | 지정된 선택자와 일치하는 청크를 제거합니다. |
| [XPackageUninstallUWPInstance](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageuninstalluwpinstance.md) | 현재 사용자에 대해 특정 패키지의 유니버설 Windows 플랫폼(UWP) 인스턴스가 현재 설치되어 있으면 이를 제거합니다. |
| [XPackageUnregisterInstallationProgressChanged](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageunregisterinstallationprogresschanged.md) | 이전에 등록된 설치 진행률 변경 콜백을 등록 취소합니다. |
| [XPackageUnregisterPackageInstalled](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageunregisterpackageinstalled.md) | 이전에 등록된 설치 완료 콜백을 등록 취소합니다. |
| [XPackageUpdateInstallationMonitor](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackageupdateinstallationmonitor.md) | [XPackageGetInstallationProgress](https://docs.xbox.com/ko/reference/system/xpackage/functions/xpackagegetinstallationprogress.md)에서 반환된 진행률을 새로 고칩니다. |

## 구조체

| 구조체 | 설명 |
| - | - |
| [XPackageChunkSelector](https://docs.xbox.com/ko/reference/system/xpackage/structs/xpackagechunkselector.md) | 청크 집합을 선택하는 기준을 정의합니다. |
| [XPackageDetails](https://docs.xbox.com/ko/reference/system/xpackage/structs/xpackagedetails.md) | 설치에 대한 세부 정보를 포함합니다. |
| [XPackageFeature](https://docs.xbox.com/ko/reference/system/xpackage/structs/xpackagefeature.md) | 기능을 설명합니다. |
| [XPackageInstallationProgress](https://docs.xbox.com/ko/reference/system/xpackage/structs/xpackageinstallationprogress.md) | 설치 진행률에 대한 정보를 포함합니다. |
| [XPackageWriteStats](https://docs.xbox.com/ko/reference/system/xpackage/structs/xpackagewritestats.md) | 출력 쓰기 통계(writeStats)를 포함합니다. |

## 열거형

| 열거형 | 설명 |
| - | - |
| [XPackageChunkAvailability](https://docs.xbox.com/ko/reference/system/xpackage/enums/xpackagechunkavailability.md) | 설치 청크의 가용성을 나타냅니다. |
| [XPackageChunkSelectorType](https://docs.xbox.com/ko/reference/system/xpackage/enums/xpackagechunkselectortype.md) | 선택자 형식을 나타냅니다. |
| [XPackageEnumerationScope](https://docs.xbox.com/ko/reference/system/xpackage/enums/xpackageenumerationscope.md) | 설치 패키지가 열거될 때 반환될 패키지의 범위를 나타냅니다. |
| [XPackageKind](https://docs.xbox.com/ko/reference/system/xpackage/enums/xpackagekind.md) | 설치 패키지의 유형을 나타냅니다. |

## 오류 코드

다음 오류 코드는 XPackage API에서 반환될 수 있습니다. 전체 목록은 [오류 코드](https://docs.xbox.com/ko/reference/errorcodes.md)를 참조하세요.

| 코드 | 값 | 설명 |
| - | - | - |
| E\_GAMEPACKAGE\_APP\_NOT\_PACKAGED | 0x89245200 | 게임이 컨테이너에 패키징되지 않았습니다. |
| E\_GAMEPACKAGE\_NO\_INSTALLED\_LANGUAGES | 0x89245201 | 게임은 Intelligent Delivery를 사용하여 언어를 선택적으로 설치하지만 설치된 언어가 없습니다. |
| E\_GAMEPACKAGE\_NO\_STORE\_ID | 0x89245202 | 애플리케이션의 게임 구성에 StoreId 특성을 설정해야 합니다. |
| E\_GAMEPACKAGE\_INVALID\_SELECTOR | 0x89245203 | 패키지의 청크로 확인되지 않는 청크 선택자가 제공되었습니다. |
| E\_GAMEPACKAGE\_DOWNLOAD\_REQUIRED | 0x89245204 | 이 디바이스에 패키지를 탑재하려면 하나 이상의 필수 청크를 다운로드해야 합니다. |
| E\_GAMEPACKAGE\_NO\_TAG\_CHANGE | 0x89245205 | 태그가 아닌 기능(Features)을 사용하여 이 패키지에 설치된 청크를 변경합니다. |
| E\_GAMEPACKAGE\_DLC\_NOT\_SUPPORTED | 0x89245206 | 게임이 DLC 패키지를 지원하지 않습니다. 게임 구성에서 올바른 DLC 호환성을 확인하세요. |
| E\_GAMEPACKAGE\_DUPLICATE\_ID\_VALUES | 0x89245207 | 패키지에 동일한 'ID' 특성에 매핑되는 실행 파일이 두 개 이상 포함되어 있습니다. 'Executable' 요소에서 중복된 'ID' 특성이 있는지 확인하세요. |
| E\_GAMEPACKAGE\_NO\_PACKAGE\_IDENTIFIER | 0x89245208 | 패키지에 대한 식별자를 확인할 수 없습니다. 패키지가 설치되지 않았을 수 있습니다. |

## 개념 문서

* [XStore 업데이트 확인](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-checking-updates.md)
* [XStore 콘텐츠 액세스 권한 부여](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-granting-access.md)
* [XStore 선택적 패키지 관리 및 라이선스](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-dlc.md)

## 함께 보기

[시스템 API 참조](https://docs.xbox.com/ko/reference/system/gc-reference-system-toc.md)\
[XStore API 참조](https://docs.xbox.com/ko/reference/system/xstore/xstore_members.md)


## Related topics

- [Intelligent Delivery: OnDemand 콘텐츠](https://docs.xbox.com/ko/build/core-features/common/packaging/intelligentdelivery-ondemand.md)
- [GDK 다운로드 가능 콘텐츠(DLC) 패키지](https://docs.xbox.com/ko/build/core-features/common/packaging/packaging-downloadable-content-dlc.md)
- [Games-as-a-Service(GaaS) 지원](https://docs.xbox.com/ko/build/core-features/common/packaging/supporting-games-as-a-service.md)
- [Unity 프로젝트에서 GDK API용 C# 래퍼 사용](https://docs.xbox.com/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [패키징](https://docs.xbox.com/ko/build/core-features/common/packaging/gc-packaging-toc.md)