Démarrage rapide du Content Delivery Network - XBOX Game Development Documentation

PlayFab CDN est une fonctionnalité héritée prise en charge pour les comptes disposant d’au moins un titre ayant déjà configuré le CDN. Pour les nouveaux développeurs PlayFab à la recherche d’une solution de gestion de contenu, nous recommandons d’utiliser Azure CDN. Pour commencer, consultez la documentation Azure CDN.

Le Content Delivery Network (CDN) de PlayFab stocke des ressources individuelles sous forme de fichiers identifiés de manière unique par leur nom de fichier (également appelé clé). Cela implique que vous ajoutez, mettez à jour, supprimez et récupérez les ressources par clé. PlayFab CDN permet de séparer les ressources par dossiers. Le chemin du dossier de la ressource fait partie de la clé de ressource. L’exemple suivant est une clé de ressource valide stockée dans le dossier nommé Android. Android/Image.png. Lorsque l’utilisateur récupère des ressources, ses requêtes sont automatiquement acheminées vers l’emplacement de périphérie le plus proche, de sorte que le contenu est distribué avec les meilleures performances possibles. Cela peut toutefois introduire des délais dans les actions de gestion des fichiers, comme dans les exemples suivants :

Chargement de fichier : votre fichier est disponible immédiatement.
Remplacement de fichier : l’ancien fichier reste visible par les utilisateurs pendant 24 heures au maximum, jusqu’à ce qu’il soit remplacé par le nouveau fichier.
Suppression de fichier : le fichier continue d’exister pendant 24 heures au maximum, le temps que la commande de suppression le retire de tous les emplacements de périphérie.

Chargement de ressources

Avant que vos utilisateurs puissent récupérer une ressource, celle-ci doit être chargée sur le CDN. Vous pouvez le faire dans Game Manager :

Sélectionnez Content dans le menu de gauche.
Choisissez l’onglet File Management.
Sélectionnez ensuite Upload Files.

Game Manager - Content - File Management - Upload Files

Vous pouvez :

Sélectionner plusieurs Files (1).
Chaque fichier sélectionné apparaît dans la liste (2).
Envoyer vos fichiers en sélectionnant le bouton Upload Files (3).

Game Manager - Choisir et charger des fichiers

Les fichiers chargés apparaissent dans la liste (1).
N’oubliez pas que vous pouvez également gérer des dossiers.
- Pour créer un dossier, sélectionnez le bouton New Folder (2).
Renseignez le champ Folder name (1).
Sélectionnez le bouton Create Folder (2).

Cela crée un nouveau dossier dans l’arborescence. Vous pouvez ensuite sélectionner ce dossier et y charger des fichiers normalement. Vous pouvez également charger des ressources par code à l’aide du SDK d’administration. Il s’agit d’un processus en deux étapes :

Tout d’abord, appelez GetContentUploadUrl et obtenez l’URL présignée qui autorise votre chargement.
Ensuite, utilisez l’URL pour effectuer une requête HTTP PUT, en fournissant vos données et (facultativement) le type de contenu.

Vous pouvez utiliser l’extrait ci-dessous, qui montre comment obtenir une URL présignée.

public void UploadFileToCDN(string key, byte[] content, string contentType = "binary/octet-stream") {
    GetUploadUrl(key, contentType, presignedUrl => {
        PutFile(presignedUrl, content, contentType);
    });
}

void GetUploadUrl(string key, string contentType, Action<string> onComplete) {
    PlayFabAdminAPI.GetContentUploadUrl(new GetContentUploadUrlRequest() {
        ContentType = contentType,
        Key = key
    }, result => onComplete(result.URL),
    error => Debug.LogError(error.GenerateErrorReport()));
}

void PutFile(string presignedUrl, byte[] content, string contentType = "binary/octet-stream") {
    // Implement your own PUT HTTP request here.
    // - Must use PUT method
    // - Must set content type Header
}

Vous pouvez ensuite vérifier le résultat dans PlayFab Game Manager. Assurez-vous que le fichier figure dans la liste.

Récupération de ressources

Le téléchargement de la ressource par code est identique à son chargement. Comme indiqué précédemment, il s’agit d’un processus en deux étapes.

Tout d’abord, appelez GetContentDownloadUrl et obtenez une URL présignée qui autorise votre téléchargement.
Utilisez ensuite l’URL présignée pour effectuer une requête HTTP GET et récupérer les données.

Vous pouvez utiliser l’extrait ci-dessous, qui montre l’essentiel du processus.

public void DownloadFileFromCDN(string key) {
    GetDownloadUrl(key, presignedUrl =>
    {
        GetFile(presignedUrl);
    });
}

void GetDownloadUrl(string key, Action<string> onComplete) {
    PlayFabClientAPI.GetContentDownloadUrl(new GetContentDownloadUrlRequest() {
        Key = key,
        ThruCDN = true
    }, result => onComplete(result.URL),
    error => Debug.LogError(error.GenerateErrorReport()));
}

void GetFile(string preauthorizedUrl) {
    // Implement your own GET HTTP request here.
}

Comme indiqué précédemment, le CDN peut introduire une latence lors des mises à jour de fichiers. Pendant le développement, il est parfois utile de forcer la récupération des fichiers les plus récents. L’appel GetContentDownloadUrl vous permet de définir le paramètre ThruCDN sur False. L’URL renvoyée pointe vers des fichiers récents non mis en cache.

Le client de votre jeu publié ne doit jamais utiliser cette option !

​Chargement de ressources

​Récupération de ressources

Chargement de ressources

Récupération de ressources