GDK 可下載內容 (DLC) 套件

Microsoft Game Development Kit (GDK) 的可下載內容 (DLC) 套件，是與您的主要遊戲分開的套件。DLC 套件會獨立於遊戲的其餘部分販售和下載，或作為購買組合的一部分。建立、發佈和取用 DLC 套件的程序在概念上與 XBOX One 主機遊戲相同，但部分封裝檔案格式和執行階段 API 已經更新，而且更易於使用。 PC 上使用相同的封裝結構來支援 DLC 套件，並在主機和 PC 上使用相同的執行階段 API 存取。使用 XBOX Series X|S 和 XBOX One 主機時，可以產生一個 DLC 套件虛設常式檔案，並用於這兩個平台。如果 DLC 套件包含實際的內容差異，請使用 TargetDeviceFamilyForDLC 元素產生平台專屬的 DLC 套件。

設定您的主要套件身分識別

在主要遊戲產品的 Game Setup 頁面中，查詢主要應用程式套件的 Store ID (12 個字元的英數字串)。(範例：9PNX12345AAA)
將 StoreId 元素新增至主要套件的 MicrosoftGame.config 檔案。

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    <!-- Content omitted for brevity. -->
    <StoreId>**REPLACE WITH STOREID**</StoreId>
</Game>

建立 DLC 套件

在 Partner Center 中，從主要產品下的 Add-Ons 功能表建立您的 DLC 套件附加元件。
將所有 DLC 套件內容放入單一目錄中。
使用下列範例資料，在與 DLC 套件內容相同的目錄中建立 MicrosoftGame.config 檔案。
在 TargetDeviceFamilyForDLC 欄位中，指定要為其建立此 DLC 套件的目標裝置系列。允許的值為 XBOX One、XBOX Series X|S 或 PC。針對 XBOX One 和 XBOX Series X|S 必須指定此值；針對 PC 則為選擇性，只要在使用 makepkg.exe 產生 DLC .MSIXVC 檔案時使用 /pc 旗標即可。
在 Partner Center 的 Game Setup 頁面中，查詢主要應用程式套件的 Package/Identity/Name 欄位，然後將身分識別名稱放入 MainPackageDependency 欄位中。例如，MyPackageName
從 Partner Center 查詢附加元件/DLC 套件的 Store ID (12 個字元的英數字串)，然後將其放入 StoreId 欄位中，如下所示。
在主要遊戲產品的 Game Setup 頁面中，查詢主要應用程式套件的 Store ID (12 個字元的英數字串)。將其放入 AllowedProduct 欄位中，如下所示。例如，9PNX12345AAA

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    <Identity Name="**REPLACE**"
        Publisher="**REPLACE**"
        Version="1.0.0.0"/>
    <ShellVisuals DefaultDisplayName="**REPLACE**"
                  PublisherDisplayName="**REPLACE**"
                  StoreLogo="Storelogo.png"
                  Square150x150Logo="Logo.png"
                  Square44x44Logo="SmallLog.png"
                  Description="**REPLACE**"
                  BackgroundColor="#000040"
                  SplashScreenImage="SplashScreen.png"/>
    <StoreId>**REPLACE WITH STOREID OF ADD-ON / DLC**</StoreId>
    <TargetDeviceFamilyForDLC>**REPLACE**</TargetDeviceFamilyForDLC>
    <AllowedProducts>
      <AllowedProduct>**REPLACE WITH STOREID OF BASE GAME**</AllowedProduct>
    </AllowedProducts>

<!-- The Desktop Registration section is for PC only. -->
    <DesktopRegistration>
      <MainPackageDependency Name="**REPLACE_WITH_IDENTITY_OF_PARENT_PRODUCT**" />
      <ProcessorArchitecture>x64</ProcessorArchitecture>
    </DesktopRegistration>
</Game>

在包含單一資料夾 (其中有您所有遊戲內容) 的資料夾中開啟 Microsoft Game Development Kit (GDK) 命令提示字元，然後執行下列命令。

MakePkg genmap /f layout.xml /d <Your_dlc_folder>

如果您要為 PC 建立 DLC，請使用下列命令。

MakePkg pack /f layout.xml /lt /d <Your_dlc_folder_name> /pc /pd <Output_Folder_Name>

如果您要為主機建立 DLC，請使用下列命令。

MakePkg pack /f layout.xml /lt /d <Your_dlc_folder_name> /pd <Output_Folder_Name> 在先前的 SDK 中，您會在命令列上使用 /ProductID 旗標傳遞主要遊戲的產品 ID GUID。使用 MicrosoftGame.Config 模型設定 DLC 套件關聯性時，請勿使用 /ProductID 參數。MakePkg 會根據 MicrosoftGame.config 檔案中列出的 StoreID，自動將適當的資訊放入您的套件中。

在執行階段從遊戲存取 DLC 套件

取用 DLC 套件內容的基本步驟如下。

列舉套件
檢查目標套件是否有有效的使用者授權
從列舉結果中取得 packageIdentifier，並將其傳遞給 XPackageMount API。

在 XBOX Series X|S 主機上，您只能取用 TargetDeviceFamilyForDLC 為 XBOX Series X|S 的 DLC 套件，除非您在 MicrosoftGame.config 中為 DlcCompatibility 欄位指定 XboxOne：

    <VirtualMachine>
        <DlcCompatibility>XboxOne</DlcCompatibility>
    </VirtualMachine>

XBOX Series X|S DLC 只能安裝在快速儲存體上，而 XBOX One DLC 則沒有此限制，因此在讓您的遊戲選擇加入之前，請務必將此列入考量。

部署和測試 DLC 套件

請確保在安裝 DLC 套件之前先安裝主要遊戲套件。對於 XBOX 主機，請使用下列命令安裝 DLC 套件。 xbapp install <Your_DLC_Package.xvc> 對於 PC，請使用下列命令安裝 DLC 套件。 wdapp install <Your_DLC_Package.msixvc> DLC 內容也可以從包含鬆散檔案的目錄註冊，而且也可以使用從 Microsoft Store 下載的套件進行測試。如需詳細資訊，請參閱管理可下載內容及授權。

參考 API 文件

XPackage (API 內容)
- 函式
  - xpackageenumeratepackages
  - XPackageMount

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

設定您的主要套件身分識別

建立 DLC 套件

在執行階段從遊戲存取 DLC 套件

部署和測試 DLC 套件

參考 API 文件

​設定您的主要套件身分識別

​建立 DLC 套件

​在執行階段從遊戲存取 DLC 套件

​部署和測試 DLC 套件

​參考 API 文件

設定您的主要套件身分識別

建立 DLC 套件

在執行階段從遊戲存取 DLC 套件

部署和測試 DLC 套件

參考 API 文件