Partie 2 - Utilisation de Game Manager

Avant de commencer à coder, nous devons comprendre Game Manager et configurer quelques éléments.

Prérequis

Partie 1 - Configuration de l’environnement
Un compte de développeur PlayFab. L’inscription est gratuite.

Étape 1 - Créer votre studio

Après vous être connecté (ou inscrit), vous pouvez créer votre tout nouveau studio de jeu ! Pour ce faire, dès que vous vous connectez à Game Manager, un bouton New Studio s’affiche. Une fois que vous avez cliqué dessus, vous êtes invité à nommer votre studio. Vous pouvez lui donner le nom de votre choix. Pour cet exemple, nous l’avons nommé « New Game Studio ».

Une fois votre studio créé, il est visible sur votre écran My Studios and Titles, ou en accédant à Game Manager et en vous connectant.

Étape 2 - Créer votre titre

Pour créer un titre, procédez comme suit :

Sur votre page My Studios and Titles dans Game Manager, repérez les trois points à droite du bouton Upgrade account (si vous avez déjà acheté un plan lié au compte connecté, vous ne verrez que les trois points) et sélectionnez-les.
Un menu proposant différentes options s’ouvre ; choisissez New title.

Saisissez les informations de votre titre, telles que le nom, l’URL du site web et le logo du jeu, si vous en disposez déjà. Si ce n’est pas le cas, pas d’inquiétude : vous pourrez toujours les ajouter plus tard.

Sélectionnez Create title
Une fois créé, votre titre apparaît sous le studio créé précédemment. Il s’affiche sous forme de « carte » sur laquelle figurent le logo, le nom, le plan et l’ID de votre titre, ainsi qu’un bouton en forme d’engrenage ⚙️ qui vous mène à d’autres paramètres du titre.

Étape 3 - Obtenir votre ID de titre et votre clé secrète

Maintenant que votre studio et votre titre sont créés, il est temps d’obtenir votre ID de titre et votre clé secrète de développeur. Ces deux éléments seront utilisés lorsque vous commencerez à coder et serviront de points de liaison dans votre environnement de développement vers le titre spécifique sur lequel l’authentification et les transactions sont exécutées. Le moyen le plus simple d’obtenir l’ID de titre consiste à regarder votre titre sur l’écran de votre studio, dans la carte correspondant à votre titre. En bas à droite de cette carte, vous verrez la mention « ID » suivie d’un code alphanumérique à 5 caractères : il s’agit de votre ID.

Passons maintenant à l’obtention de votre clé secrète de développeur :

Connectez-vous à Game Manager.
Sélectionnez la carte de votre titre sur l’écran du studio. La page de vue d’ensemble du titre s’ouvre.
Dans le coin supérieur gauche, à côté du nom du titre, sélectionnez l’icône d’engrenage ⚙️.
Choisissez l’option Title settings.

Sélectionnez l’option Secret Keys dans la barre de navigation en haut de l’écran.

Option Secret Keys de la barre de navigation

Vous verrez que nous en avons généré une automatiquement pour vous, appelée Default Key. Il s’agit de votre clé secrète de développeur, que nous utiliserons dans la partie suivante de ce tutoriel pour configurer les paramètres de l’environnement de codage.

Félicitations d’être arrivé jusqu’ici ! Votre studio et votre titre devraient maintenant être créés et correctement configurés, et vous devriez avoir à portée de main votre ID de titre et votre clé secrète de développeur (ou au moins savoir où les obtenir si nécessaire).

Étape 4 - Créer votre premier objet

Comme nous créons un jeu d’artisanat, nous devons créer nos objets dans Game Manager afin qu’ils soient disponibles pour les joueurs dès le début de la partie (et pour vous, afin de commencer à coder).

Game Manager

Connectez-vous à Game Manager.
Accédez à la page My Studios and Titles et sélectionnez votre titre de jeu pour afficher le tableau de bord.
Dans le menu de navigation de gauche, sélectionnez Engage > Economy.

Sur la page Economy, sélectionnez l’onglet Items, puis New Item. Vous y trouverez également d’autres onglets, tels que Currency, UGC, Bundles et Stores.

Après l’avoir sélectionné, vous êtes redirigé vers un formulaire dans lequel vous êtes invité à ajouter les détails de votre nouvel objet. Sur cet écran, vous pouvez également définir certaines propriétés de l’objet, telles que les prix, les fichiers, les images et les plateformes sur lesquelles l’objet sera disponible.

Une fois que vous avez ajouté toutes les informations requises et toute information supplémentaire souhaitée, vous disposez, en bas de l’écran New Item, de deux options distinctes pour continuer : 1. Save as draft : crée un brouillon d’objet, qui ne sera pas disponible dans votre jeu (ni via la recherche, ni à l’achat, etc.). 2. Save and publish : enregistre et publie immédiatement votre objet dans votre jeu, ce qui signifie qu’il peut être recherché, qu’il est actif et qu’il peut être acheté.

Options d'enregistrement d'un nouvel objet

Dès que vous avez enregistré vos modifications, l’objet est soit à l’état de brouillon, soit publié, selon votre choix.

API

Pour créer un objet à l’aide de l’API PlayFab, vous devez utiliser l’appel CreateDraftItem, sous catalog/createDraftitem. Cela fonctionne de la même manière que les autres exemples de création d’objets, à la différence près que, par défaut, l’objet créé sera un brouillon, sauf indication contraire. Il existe un booléen Publish qui, s’il est défini sur true, publie directement l’objet sans l’enregistrer comme brouillon. Le JSON suivant est un exemple de corps de requête CreateDraftItem. Tous les champs ne sont pas obligatoires ; n’hésitez donc pas à adapter ce JSON à vos besoins. Pour plus d’informations, consultez CreateDraftItem.

{
  "Item": {
    "Type": "ugc",
    "Title": {
      "NEUTRAL": "Neutral title",
      "en-US": "US English title"
    },
    "Description": {
      "NEUTRAL": "Neutral description",
      "en-US": "US English description"
    },
    "Keywords": {
      "NEUTRAL": {
        "Values": [
          "Keyword_1",
          "Keyword_2"
        ]
      }
    },
    "ContentType": "example item",
    "CreatorEntity": {
      "Id": "someId",
      "Type": "title_player_account",
      "TypeString": "title_player_account"
    },
    "IsHidden": false,
    "Tags": [
      "pirates",
      "holiday"
    ],
    "DisplayVersion": "1.0.0",
    "CreationDate": "2018-08-17T22:32:10.472Z",
    "Contents": [
      {
        "Id": "00000000-0000-0000-0000-000000000001",
        "Url": "https://endpoint.blob.core.windows.net/some-identifier-private/00000000-0000-0000-0000-000000000001/textures.zip",
        "MaxClientVersion": "2.4.1",
        "MinClientVersion": "2.0.0"
      }
    ],
    "Images": [
      {
        "Id": "00000000-0000-0000-0000-000000000003",
        "Type": "Thumbnail",
        "Url": "https://endpoint.blob.core.windows.net/some-identifier-private/00000000-0000-0000-0000-000000000003/splashscreen_thumb.jpg"
      }
    ],
    "DisplayProperties": {
      "mapDetails": {
        "mapType": "desertIsland",
        "gameMode": "capture",
        "maxPlayers": 16
      },
      "averageMatchLengthInSeconds": 947
    },
    "DefaultStackId": "Static_Default_Stack_Id"
  },
  "Publish": false
}

Pour plus d’informations sur les objets, les inventaires et les autres fonctions et termes d’Economy, consultez notre documentation Economy V2.

Étape 5 - Utiliser le catalogue pour afficher et modifier vos objets

Si vous revenez à Engage > Economy dans la barre de navigation de gauche (comme à l’étape 4), vous verrez la même liste d’options/onglets que celle mentionnée ci-dessus. La page affiche par défaut l’onglet Items, dans lequel vous disposez d’une autre option pour filtrer les objets selon leur état (Published ou Draft) ; tous vos objets de la catégorie sélectionnée y sont affichés.

Maintenant que vous pouvez afficher/lister tous vos objets publiés ou brouillons au même endroit, vous pouvez les modifier individuellement ou les supprimer en bloc. Pour les supprimer, sélectionnez ceux que vous souhaitez supprimer et appuyez sur le bouton Delete.

Pour modifier un objet, sélectionnez son titre : vous accédez à un écran identique à l’écran New Item mentionné précédemment, avec toutes les propriétés et tous les champs personnalisés que vous avez pu ajouter à l’objet lors de sa création (ou depuis sa dernière mise à jour). Vous pouvez les personnaliser et les enregistrer en faisant défiler jusqu’en bas de la page et en sélectionnant le bouton Edit draft item (juste à côté du bouton Edit draft item se trouve également un bouton Delete, qui constitue un autre moyen de supprimer un objet).

Étape 6 - (Astuce) Rendre un objet gratuit à l’achat

Cette étape est facultative, car elle présente l’une des méthodes que nous recommandons pour rendre un objet gratuit à l’achat. La méthode utilisée consiste à créer un nouvel objet « Free Item » à utiliser comme prix, avec une quantité de 0, dans l’objet que vous souhaitez rendre gratuit.

Vous pensez peut-être que pour rendre un objet gratuit, il suffit de ne pas lui attribuer de prix. Ce n’est actuellement pas le cas : si vous créez un objet sans prix, nous le considérerons comme impossible à acheter.

Pour créer un « Free Item » pouvant servir de prix à l’objet que vous souhaitez rendre gratuit, suivez les mêmes étapes qu’à l’étape 4 : c’est exactement comme créer un objet « normal ». Inutile de trop réfléchir aux propriétés ou aux valeurs que vous ajoutez à cet objet, car il ne doit pas être actif dans votre jeu ; son seul rôle est de servir de prix. Il n’est pas non plus nécessaire de lui attribuer un prix. Une fois les deux objets créés (le « Free Item » et l’objet que vous souhaitez rendre gratuit), vous devez modifier l’objet à rendre gratuit afin de lui attribuer un prix. Pour ce faire, dans votre liste d’objets, sélectionnez l’objet souhaité et cliquez sur son nom, comme nous l’avons vu à l’étape 5, pour accéder à l’écran de modification de l’objet. Si vous faites défiler jusqu’en bas et activez le mode Édition (Edit Mode), un bouton Add new price apparaît sous la section « Prices ».

Après avoir cliqué sur Add new price, une fenêtre s’ouvre avec la liste de tous vos objets actuels, dans laquelle vous pouvez en choisir un comme prix (vous pouvez également filtrer par « Items », « UGC Items » et « Currencies ») et rechercher un texte spécifique. Dans notre cas, un seul autre objet s’y trouve : le « Free Item » (à moins que vous n’ayez déjà créé plusieurs objets). Si vous sélectionnez l’option « Add » juste à côté de votre « Free Item », vous êtes ensuite invité à sélectionner la quantité de « Free Item » souhaitée comme prix. Pour rendre ce nouvel objet gratuit, vous devez remplacer cette valeur (1 par défaut) par zéro. Une fois le prix configuré, vous devez enregistrer et publier la modification, et le tour est joué ! Cet objet peut désormais être acheté gratuitement ! Nous verrons plus loin comment acheter un objet (même gratuit) en C# et par des appels d’API directs.

Étapes pour ajouter un objet gratuit comme prix

Étape 7 - Ajouter un FriendlyId

Cette étape est également facultative ; elle explique comment modifier un objet existant pour lui ajouter un FriendlyId. Vous pourrez ainsi rechercher l’objet à l’aide de ce FriendlyId au lieu du long ID alphanumérique attribué par défaut.

Pour ajouter un FriendlyId, accédez à Economy > Items et sélectionnez l’objet souhaité. Une fois l’objet sélectionné, activez le mode Édition (Edit mode) afin de pouvoir le modifier. Dans la capture d’écran suivante, vous pouvez voir le champ FriendlyId (surligné en rouge). C’est là que vous pouvez saisir un nom ou un ID plus convivial pour votre objet ; il sera instantanément lié à cet objet.

XBOX Services

PlayFab

Jeu d'artisanat, partie 2 - Game Manager

Partie 2 - Utilisation de Game Manager

Prérequis

Étape 1 - Créer votre studio

Étape 2 - Créer votre titre

Étape 3 - Obtenir votre ID de titre et votre clé secrète

Étape 4 - Créer votre premier objet

Game Manager

API

Étape 5 - Utiliser le catalogue pour afficher et modifier vos objets

Étape 6 - (Astuce) Rendre un objet gratuit à l’achat

Étape 7 - Ajouter un FriendlyId

​Partie 2 - Utilisation de Game Manager

​Prérequis

​Étape 1 - Créer votre studio

​Étape 2 - Créer votre titre

​Étape 3 - Obtenir votre ID de titre et votre clé secrète

​Étape 4 - Créer votre premier objet

​Game Manager

​API

​Étape 5 - Utiliser le catalogue pour afficher et modifier vos objets

​Étape 6 - (Astuce) Rendre un objet gratuit à l’achat

​Étape 7 - Ajouter un FriendlyId

Partie 2 - Utilisation de Game Manager

Prérequis

Étape 1 - Créer votre studio

Étape 2 - Créer votre titre

Étape 3 - Obtenir votre ID de titre et votre clé secrète

Étape 4 - Créer votre premier objet

Game Manager

API

Étape 5 - Utiliser le catalogue pour afficher et modifier vos objets

Étape 6 - (Astuce) Rendre un objet gratuit à l’achat

Étape 7 - Ajouter un FriendlyId