Les API Economy v1 sont en mode maintenance et ne recevront aucune nouvelle fonctionnalité, seulement des correctifs de bogues. Les API v1 seront maintenues dans un avenir prévisible. Consultez la vue d’ensemble d’Economy v2 pour en savoir plus sur la prochaine version de PlayFab Economy!
Qu’est-ce qu’un catalogue?
Un catalogue sert à définir les objets qu’un joueur peut acheter ou que vous pouvez lui décerner. De nombreux jeux proposent au joueur des objets à acheter, comme un bouclier, le déverrouillage d’un niveau ou un bonus. Ces objets sont précisés dans un catalogue et souvent vendus contre de la monnaie virtuelle ou de l’argent réel. Le catalogue de PlayFab offre une façon simple de gérer les objets virtuels de votre jeu et peut contenir tous les objets offerts dans votre jeu.Références des champs d’objet
Cette section décrit chaque champ de la section Catalog V2 de la zone Economy dans Game Manager. Lorsque vous créez un titre pour la première fois, votre catalogue est vide. Vous ne verrez aucun objet dans la section Catalog tant que vous n’en aurez pas créé. Les onglets suivants existent dans la section Catalog v2 :
Chacun d’eux est un type d’objet qui peut être utilisé dans votre catalogue.
Champs d’objet de Catalog V2
Lorsque vous sélectionnez Catalog V2, puis l’onglet Items, et choisissez NEW ITEM, la page suivante s’affiche :
- PROPERTIES
- Creator Entity Type : Un champ créé par le système qui indique le type d’entité créatrice.
- Creator Entity ID : Un ID unique pour l’entité créatrice. Dans Game Manager, cet ID est défini sur la valeur du titre.
- Friendly ID : Un champ qui peut être utilisé pour faciliter la référence dans le code. Les ID conviviaux sont facultatifs pour tous les objets et doivent être uniques dans le catalogue.
- Title : Un champ obligatoire pour le nom commun de l’objet, normalement affiché au joueur. Une localisation simple de Title est prise en charge au moyen de clés de paramètres régionaux. Pour plus d’informations, consultez Localisation d’Economy V2.
- Default Stack ID : Les objets peuvent être stockés dans l’inventaire sous forme de piles, chacune ayant sa propre quantité et étant différenciée par StackId. S’il n’est pas défini, les actions d’inventaire utiliseront default comme StackId. Pour plus d’informations, consultez Piles d’Economy.
- Keywords : Les mots-clés peuvent servir au filtrage de recherche de base. Il s’agit d’un dictionnaire de mots-clés localisés au format JSON. Pour un exemple, consultez Localisation d’Economy V2.
- Description : Un dictionnaire de descriptions d’objet localisées au format JSON.
- Content Type : Vous pouvez sélectionner un type de contenu pour l’objet dans cette liste déroulante. Les types de contenu sont définis dans les paramètres du catalogue (Title Settings > Economy).
- Display Properties : Un blob JSON que vous pouvez utiliser pour des propriétés d’objet personnalisées.
- Display Version : Un champ que vous pouvez utiliser pour gérer les versions de vos Display Properties.
- Tags : Ce champ contient des étiquettes que vous pouvez utiliser pour organiser les objets de votre catalogue en vue de la recherche. Les étiquettes peuvent être saisies sous forme de chaînes de texte séparées par des virgules. Ces chaînes sont prédéfinies dans les paramètres du catalogue (Title Settings > Economy).
- Available Tags Liste déroulante pratique pour sélectionner les étiquettes d’objet déjà définies dans la configuration du catalogue.
- OPTIONS
- Hidden : Une seule option est actuellement offerte pour les objets répertoriés dans cette section. Cette option, Hidden, empêche l’objet d’être exposé dans la recherche.
- Start Date : Un champ de date obligatoire indiquant quand l’objet doit être rendu disponible dans la recherche.
- End Date : Un champ de date permettant d’indiquer quand l’objet doit être rendu indisponible dans la recherche.
- PRICES
- Add New Price : Vous pouvez utiliser cette section pour préciser un ou plusieurs prix d’achat pour l’objet.
- FILES
- Upload : Ici, vous pouvez téléverser du contenu à stocker dans le catalogue public, qui peut être associé à cet objet.
- IMAGES
- Upload : Ici, vous pouvez téléverser diverses images, y compris des miniatures et des captures d’écran, pour l’affichage des objets dans votre catalogue en jeu.
- PLATFORMS
- Manage : Vous pouvez préciser les plateformes auxquelles cet objet est destiné. La liste des plateformes est définie dans les paramètres du catalogue (Title Settings > Economy).
Enregistrement de vos objets à l’état de brouillon ou publié
Le catalogue Economy V2 prend en charge un état d’objet Draft (brouillon). Lorsque vous choisissez Save as Draft, les métadonnées de l’objet sont accessibles par appel direct, mais ne sont pas exposées à la recherche publique. Lorsque vous êtes prêt à rendre votre objet public, vous le placez à l’état Published. Pour en savoir plus à ce sujet, consultez notre page État des objets.Exemple de création d’objet
Pour créer un Item :- Ouvrez Game Manager et sélectionnez Economy dans la barre latérale de gauche.
- Sélectionnez l’onglet Catalogs V2.
- Sélectionnez le bouton NEW ITEM.
- Remplissez les champs obligatoires de l’objet :
- Title (JSON, p. ex. {“NEUTRAL”:“My New Amazing Item”}).
- Start Date (sélectionnez la date d’aujourd’hui).
- Remplissez les champs obligatoires de l’objet :
- Sélectionnez le bouton SAVE AND PUBLISH, ce qui vous ramène à la page Items.
- Pour ajouter d’autres objets, sélectionnez NEW ITEM et répétez les étapes 3 à 5.
Champs de monnaie de Catalog V2
Lorsque vous sélectionnez Catalog V2, ouvrez l’onglet Currency et choisissez NEW CURRENCY, la page New Currency s’ouvre. Les monnaies contiennent tous les mêmes champs que les champs d’objet de Catalog V2.Champs UGC de Catalog V2
Lorsque vous sélectionnez Catalog V2, ouvrez l’onglet UGC et choisissez NEW ITEM, la page New User Generated Content s’ouvre. Le contenu généré par les utilisateurs contient tous les mêmes champs que les champs d’objet de Catalog V2, en plus de ce champ :- MODERATION STATE
- Moderation State : Une façon simple de marquer un objet comme Approved (approuvé), Awaiting Moderation (en attente de modération) ou Rejected (rejeté). L’état de modération ne peut être modifié que sur un objet publié.
Champs d’ensemble de Catalog V2
Lorsque vous sélectionnez Catalog V2, ouvrez l’onglet Bundles et choisissez NEW BUNDLE, la page New Bundle s’ouvre. Cette page contient tous les champs des champs d’objet de Catalog V2, en plus des champs suivants :-
ITEMS
- Add : Les ensembles vous permettent de regrouper plusieurs objets en un seul objet. Vous pouvez créer des ensembles d’objets souvent achetés ensemble, ou d’objets offerts seulement pour une durée limitée. Pour plus d’informations, consultez notre documentation sur les ensembles d’Economy V2.
-
MARKETPLACE MAPPING
- Marketplace, Marketplace ID : Vous pouvez lier votre objet en jeu à un ou plusieurs objets de marketplace pour des scénarios d’échange. Pour plus d’informations, consultez notre documentation sur les achats intégrés d’Economy V2.
Champs de boutique de Catalog V2
Lorsque vous sélectionnez Catalog V2, ouvrez l’onglet Stores et choisissez NEW STORE, la page New Store s’ouvre. Les boutiques contiennent tous les mêmes champs que les champs d’objet de Catalog V2, en plus de ce champ :- ITEMS
- Add : Les boutiques peuvent contenir n’importe quel autre type d’objet du catalogue. Tout le contenu du catalogue conserve son coût de base ou peut être acheté dans cette boutique aux prix indiqués ici. Pour plus d’informations, consultez notre documentation sur les boutiques d’Economy V2.