Pacotes de conteúdo para download (DLC) do GDK

​

Configurar a identidade do pacote principal

1. Procure a Store ID (cadeia alfanumérica de 12 caracteres) do pacote do seu aplicativo principal na página Game Setup do produto do seu jogo principal. (Exemplo: 9PNX12345AAA)
2. Adicione o elemento StoreId ao arquivo MicrosoftGame.config do pacote principal.

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

​

Criar um pacote de DLC

1. Crie o complemento do pacote de DLC no Partner Center pelo menu Add-Ons do seu produto principal.
2. Coloque todo o conteúdo do pacote de DLC em um único diretório.
3. Crie um arquivo MicrosoftGame.config no mesmo diretório do conteúdo do pacote de DLC usando os dados de exemplo a seguir.
4. Especifique no campo TargetDeviceFamilyForDLC a Target Device Family para a qual esse pacote de DLC está sendo criado. Os valores permitidos são XBOX One, XBOX Series X|S ou PC. É obrigatório especificá-lo para XBOX One e XBOX Series X|S, e é opcional no PC, desde que o sinalizador /pc seja usado ao gerar o arquivo .MSIXVC da DLC com o makepkg.exe.
5. Procure o campo Package/Identity/Name do pacote do seu aplicativo principal na página Game Setup do Partner Center e coloque o Identity Name no campo MainPackageDependency. Por exemplo, MyPackageName
6. Procure a Store ID (cadeia alfanumérica de 12 caracteres) do seu pacote de complemento/DLC no Partner Center e coloque-a no campo StoreId, conforme mostrado a seguir.
7. Procure a Store ID (cadeia alfanumérica de 12 caracteres) do pacote do seu aplicativo principal na página Game Setup do produto do seu jogo principal. Coloque-a no campo AllowedProduct, conforme mostrado a seguir. Por exemplo, 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>

8. Abra um prompt de comando do Microsoft Game Development Kit (GDK) na pasta que contém uma única pasta com todo o conteúdo do seu jogo e execute o comando a seguir.

9. Se você estiver criando DLC para PC, use o comando a seguir.

10. Se você estiver criando DLC para console, use o comando a seguir.

​

Acessando pacotes de DLC em runtime a partir do jogo

1. Enumere os pacotes
2. Verifique se há uma licença de usuário válida para o pacote de destino
3. Obtenha o packageIdentifier dos resultados da enumeração e passe-o para a API XPackageMount.

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

​

Implantando e testando um pacote de DLC

​

Documentação de referência da API

• XPackage (conteúdo da API)
  • Funções
    • xpackageenumeratepackages
    • XPackageMount