​

Packages Publisher Content

​

Quand utiliser Publisher Content

• Distribuer de petites mises à jour de service en direct (données de configuration, tables de réglage, petits packs de ressources) sans passer par l’ingestion du Store.
• Fournir du contenu de module complémentaire à la marque 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 du calendrier de déploiement, du ciblage régional ou des tests A/B au niveau de la couche 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 incorpore 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 manière 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 requis.
  • 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 à tout moment.
2. Vous créez un package Publisher Content qui référence le jeu de base par son ID Store.
3. Vous signez le package Publisher Content avec votre matériel de signature d’éditeur. Le jeu de base incorpore 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 manière 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. Chargez le fichier XVC Publisher Content empaqueté sur votre CDN, à l’URL que vous avez référencée dans votre manifeste.
2. Chargez votre manifeste JSON à l’URL que vous avez déclarée dans l’élément ManifestUrl du jeu de base.
3. Soumettez et distribuez le jeu de base via Partner Center comme d’habitude.

1. Chargez 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 du manifeste pour qu’elle pointe vers le nouveau package.
3. Chargez 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