​

Packages de contenu d’éditeur (Publisher Content)

​

Quand utiliser Publisher Content

• Livrer de petites mises à jour de service en continu (données de configuration, tables d’ajustement, petits packs de ressources) sans passer par l’ingestion du Store.
• Distribuer du contenu complémentaire à l’image de l’éditeur que tous les joueurs du jeu de base reçoivent automatiquement.
• Réutiliser un CDN et un pipeline de contenu existants que vous exploitez déjà pour vos jeux sur d’autres plateformes.
• Garder le contrôle sur le calendrier de déploiement, le ciblage régional ou les tests A/B au niveau du CDN.

​

Exigences et contraintes

• Un seul package Publisher Content par jeu de base.
• Disponible pour tout joueur qui possède le jeu de base. Il n’y a aucune vérification de licence par utilisateur.
• Pris en charge sur les consoles de la famille XBOX One et sur les consoles XBOX Series X|S.
• Le jeu de base et le package Publisher Content doivent utiliser le même format de package. Par exemple, si le jeu de base est empaqueté au format MSIXVC2, le package Publisher Content doit également être au format MSIXVC2.
• Le package Publisher Content doit être petit, c’est-à-dire d’une taille inférieure à 1 Go.
• Le package Publisher Content est signé avec du matériel de signature fourni par l’éditeur, et le jeu de base intègre le matériel public correspondant afin que la plateforme puisse valider le Publisher Content qui prétend lui appartenir. Le jeu de base lui-même est signé de la même façon que n’importe quel autre titre. Le matériel de signature diffère selon le format de package :
  • XVC et MSIXVC — Une clé de signature CNG brute. RSA-4096 est obligatoire.
  • MSIXVC2 — Un certificat X.509 avec une clé RSA-4096. Le certificat doit être actuellement valide, disposer d’une clé privée RSA accessible et autoriser les signatures numériques.

​

Comment les éléments s’articulent

1. Vous déclarez une URL de manifeste pour votre jeu de base dans MicrosoftGame.config. Cette URL pointe vers un petit fichier JSON que vous hébergez sur votre CDN et que vous pouvez mettre à jour en tout temps.
2. Vous créez un package Publisher Content qui fait référence au jeu de base par son ID de Store.
3. Vous signez le package Publisher Content avec votre matériel de signature d’éditeur. Le jeu de base intègre le matériel public correspondant afin que la plateforme puisse valider tout Publisher Content qui prétend lui appartenir.
4. Lorsqu’un joueur installe le jeu de base, la plateforme récupère votre manifeste, lit l’URL CDN du package Publisher Content actuel et met son installation en file d’attente.
5. Au moment de l’exécution, votre jeu énumère les packages installés et monte le package Publisher Content de la même façon qu’il monterait un DLC.

​

Configurer votre jeu de base

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    <!-- Existing Identity, ShellVisuals, ExecutableList, StoreId, etc. -->

    <StoreId>9NZTKMP36L8J</StoreId>

    <PublisherContent>
        <ManifestUrl>https://example.com/space-raiders/pubxvc/console/manifest.json</ManifestUrl>
    </PublisherContent>
</Game>

​

Créer le package Publisher Content

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    <Identity Name="ContosoStudios.SpaceRaiders.PublisherContent"
              Publisher="CN=REPLACE_WITH_YOUR_PUBLISHER"
              Version="1.0.0.0"/>

    <ShellVisuals DefaultDisplayName="Space Raiders Publisher Content"
                  PublisherDisplayName="Contoso Studios"
                  StoreLogo="StoreLogo.png"
                  Square150x150Logo="Logo.png"
                  Square44x44Logo="SmallLogo.png"
                  Description="Publisher-hosted content for Space Raiders."
                  BackgroundColor="#000040"
                  SplashScreenImage="SplashScreen.png"/>

    <PublisherContentBaseProduct>9NZTKMP36L8J</PublisherContentBaseProduct>
</Game>

​

Créer le manifeste

{
    "url": "https://example.com/space-raiders/pubxvc/console/space-raiders-pubxvc-v2.30.1.xvc"
}

​

Générer le matériel de signature d’éditeur

​

Pour les packages XVC et MSIXVC

Add-Type -AssemblyName System.Security

$keyName = "MyTestPubXvcSigningKey"
$providerName = "Microsoft Software Key Storage Provider"

$cngParams = [System.Security.Cryptography.CngKeyCreationParameters]::new()
$cngParams.Provider     = [System.Security.Cryptography.CngProvider]::new($providerName)
$cngParams.KeyUsage     = [System.Security.Cryptography.CngKeyUsages]::Signing
$cngParams.ExportPolicy = [System.Security.Cryptography.CngExportPolicies]::AllowExport

<# Use an RSA-4096 key. #>
$len = [System.Security.Cryptography.CngProperty]::new(
    "Length", [BitConverter]::GetBytes([int]4096),
    [System.Security.Cryptography.CngPropertyOptions]::None)
$cngParams.Parameters.Add($len)

$key = [System.Security.Cryptography.CngKey]::Create(
    [System.Security.Cryptography.CngAlgorithm]::Rsa, $keyName, $cngParams)

Write-Host "Created CNG key '$keyName' in the $providerName."

​

Pour les packages MSIXVC2

$subject = "CN=MyTestPubXvcSigningCertificate"
$certificatePath = Join-Path $PWD "MyTestPubXvcSigningCertificate.cer"

$certificate = New-SelfSignedCertificate `
    -Subject $subject `
    -CertStoreLocation "Cert:\CurrentUser\My" `
    -Provider "Microsoft Software Key Storage Provider" `
    -KeyAlgorithm RSA `
    -KeyLength 4096 `
    -HashAlgorithm SHA256 `
    -KeyUsage DigitalSignature `
    -NotAfter (Get-Date).AddYears(5)

Export-Certificate `
    -Cert $certificate `
    -FilePath $certificatePath `
    -Type CERT

​

Empaqueter le jeu de base et le Publisher Content

​

Pour les packages XVC et MSIXVC

makepkg pack /f layout.xml /d <base_game_folder> /pd <output_folder> /usepublisherkey <publisherkeyname>

makepkg pack /f layout.xml /d <publisher_content_folder> /pd <output_folder> /usepublisherkey <publisherkeyname>

​

Pour les packages MSIXVC2

makepkg pack /msixvc2 /d <base_game_folder> /pd <output_folder> /usepublishercert <thumbprint|certificate.cer>

makepkg pack /msixvc2 /d <publisher_content_folder> /pd <output_folder> /usepublishercert <thumbprint|certificate.cer>

​

Publier et mettre à jour

1. Téléversez le XVC Publisher Content empaqueté sur votre CDN à l’URL que vous avez référencée dans votre manifeste.
2. Téléversez votre manifeste JSON à l’URL que vous avez déclarée dans l’élément ManifestUrl du jeu de base.
3. Soumettez et livrez le jeu de base par l’intermédiaire de Partner Center comme d’habitude.

1. Téléversez le nouveau package Publisher Content sur votre CDN à une nouvelle URL. Ne remplacez pas l’ancien package Publisher Content.
2. Mettez à jour la valeur url dans le manifeste pour qu’elle pointe vers le nouveau package.
3. Téléversez le fichier JSON mis à jour à l’URL que vous avez déclarée dans l’élément ManifestUrl du jeu de base.

​

Accéder au Publisher Content au moment de l’exécution

HRESULT hr = XPackageEnumeratePackages(
    XPackageKind::PublisherContent,
    XPackageEnumerationScope::ThisOnly,
    nullptr,
    [](void*, const XPackageDetails* details) -> bool
    {
        // details->packageIdentifier can be passed to XPackageMountWithUiAsync.
        // details->kind is XPackageKind::PublisherContent.
        return true;
    });

XPackageKind kind;
HRESULT hr = XPackageGetPackageKind(packageIdentifier, &kind);
if (SUCCEEDED(hr) && kind == XPackageKind::PublisherContent)
{
    // Handle Publisher Content.
}

​

Comportement de désinstallation

​

Voir aussi

• Élément PublisherContent (MicrosoftGame.config)
• Élément ManifestUrl (MicrosoftGame.config)
• Élément PublisherContentBaseProduct (MicrosoftGame.config)
• Créer un package (makepkg.exe)
• XPackageKind
• XPackageGetPackageKind
• XPackageEnumeratePackages
• Packages de contenu téléchargeable (DLC) du GDK