Jeu de démonstration : Winter Starfall
Winter Starfall est un jeu développé par PlayFab pour présenter nos différentes fonctionnalités et offrir un moyen d’explorer leur implémentation dans un jeu en direct. Le jeu est jouable sur WinterStarfall.com. Si vous disposez déjà d’un compte de développeur PlayFab, vous pouvez également y accéder via le portail des développeurs, sur la page My Studios and Titles.
- Economy V2 (catalogue, monnaie, bundles, boutiques)
- Données de titre, données des joueurs et autres fonctions principales de PlayFab
- Actualités du titre pour communiquer avec les joueurs
- Cloud Script avec Azure Functions
Fonctionnalités de démonstration supplémentaires
Winter Starfall comprend des fonctionnalités qui permettent de voir plus facilement ce qui se passe « sous le capot » avec PlayFab. Le jeu est jouable par tous, mais pour profiter pleinement de ces fonctionnalités, vous devez vous inscrire pour obtenir un compte de développeur gratuit. À côté de l’icône de profil en haut à droite se trouve une icône PlayFab qui, lorsqu’elle est sélectionnée, ouvre la barre latérale d’activité PlayFab.
- La barre latérale d’activité affiche une liste d’appels d’API qui se met à jour pendant que vous jouez. Chaque appel d’API est étiqueté et codé par couleur pour indiquer le SDK PlayFab auquel il se rapporte.
- Vous pouvez sélectionner l’un des appels d’API de la liste pour afficher la requête et la réponse complètes de l’API.
- La sélection de View title F8941 ouvre le titre dans Game Manager, où vous pouvez voir comment les différentes fonctionnalités sont configurées. C’est à cette étape que vous êtes invité à vous connecter avec un compte de développeur PlayFab.
- Clear supprime toutes les notifications actuelles de la barre d’activité.
Vous pouvez jouer au jeu de démonstration à tout moment, mais pour accéder à Game Manager, vous devez vous inscrire pour obtenir un compte de développeur gratuit.
Fonctionnalités PlayFab incluses
La section suivante détaille les différentes fonctionnalités PlayFab utilisées dans le jeu.Authentification
La première chose qui se produit dans tout jeu PlayFab est la connexion d’un joueur, qui renvoie un jeton d’authentification requis pour tous les appels d’API suivants. Winter Starfall prend en charge plusieurs formes de connexion récupérable : e-mail, Microsoft (via OpenID), Google et Facebook. Le tutoriel sur le code source et les scénarios présente en détail le flux de connexion et les bonnes pratiques d’authentification des joueurs. En savoir plus sur l’authentification PlayFabÉconomie
En tant que jeu de rôle (RPG) de fantasy, Winter Starfall comprend un système économique permettant au joueur de visiter des boutiques, d’acheter des objets et de gagner de la monnaie au fil des combats. Le tout dernier service d’économie de PlayFab gère tout ce qui concerne l’inventaire et le commerce dans le jeu. Le tutoriel sur le code source et les scénarios présente en détail le flux d’achat du jeu. En savoir plus sur Economy V2Données des joueurs
Les joueurs dans PlayFab disposent de données associées, stockées dans le service par différentes fonctionnalités. La fonctionnalité de données des joueurs vous permet de stocker des informations relatives aux joueurs sous forme de paires clé/valeur, ou d’objets et de fichiers pouvant être partagés entre plusieurs jeux et appareils. Dans Winter Starfall, les données des joueurs servent à stocker l’état du jeu et des informations telles que les personnages ayant rejoint le groupe du joueur. Lorsque le joueur progresse dans l’histoire, sa position est enregistrée dans son profil de joueur par un appel à l’API UpdateUserData. Ces données sont ensuite récupérées avecGetUserData lors de sa connexion, afin de replacer le joueur au bon endroit de l’histoire avec toute sa progression passée.
GetUserData pendant le flux de connexion.
GetUserData - Requête
Données de titre
Les données de titre sont semblables aux données des joueurs en ce qu’elles stockent des paires clé-valeur, à la différence que les données concernent le titre du jeu plutôt qu’un joueur spécifique. Winter Starfall utilise les données de titre avec le système Economy pour calculer le prix de vente d’un objet, en stockant la valeurmultipliers avec la valeur sell, 0.5. Pour plus d’informations sur le fonctionnement du flux de vente, consultez le tutoriel sur le code source et les scénarios.
CloudScript avec Azure Functions
CloudScript est une fonctionnalité flexible qui vous permet d’implémenter des fonctionnalités personnalisées côté serveur, offrant des solutions quasiment illimitées lorsqu’elle est associée à d’autres fonctionnalités PlayFab. Le jeu utilise cette fonctionnalité pour répondre à de nombreux scénarios :- CombatVictory - Après la victoire du joueur dans un combat, exécute une série d’actions pour accorder de l’expérience et des objets, et ajouter des membres au groupe.
- PlayerCreated - Équipe un nouveau joueur avec des objets et des statistiques de départ.
- ProgressCheckpoint - Effectue des actions pour débloquer des objets et des personnages après avoir atteint des points clés de l’histoire.
- ResetPlayer - Efface les données utilisateur, les objets et les statistiques pour une réinitialisation complète.
- SellItem - Permet de vendre des objets avec une décote, ce qui n’est pas une fonctionnalité native du système économique. Le flux d’achat/vente est décrit plus en détail dans le tutoriel sur le code source et les scénarios.
Les fonctions CloudScript de Winter Starfall sont écrites en C#, mais vous pouvez utiliser n’importe quel langage pris en charge par Azure Functions.
Actualités du titre
Les actualités du titre permettent de communiquer avec tous les joueurs d’un titre. Winter Starfall les implémente sous la forme d’un système de notifications affichant des conseils de jeu et des avis.
Limitations de la démonstration
Comme Winter Starfall s’appuie sur de vraies données de joueurs, certaines fonctionnalités ont une portée limitée dans la vue Game Manager. Cette section donne un aperçu de ce à quoi ressembleraient les fonctionnalités limitées dans Game Manager. Pour explorer ces pages plus en détail, vous pouvez télécharger le code source et exécuter une instance locale du jeu, ou créer votre propre titre à partir de zéro.Pour un guide complet des fonctionnalités du portail des développeurs, consultez la documentation de Game Manager
Joueurs
La section Players de Game Manager est masquée dans le titre Winter Starfall afin de protéger les informations des joueurs. Normalement, vous pourriez interroger la liste complète des joueurs de votre jeu et sélectionner un compte individuel pour mettre à jour ses données via Game Manager. Depuis la page de vue d’ensemble d’un joueur, vous pouvez afficher toutes les informations relatives au joueur, notamment les objets d’inventaire, un historique de toutes les connexions, les données du joueur, et plus encore.
Données et analytique
Certaines des fonctionnalités de la section Analyze sont également limitées pour protéger les informations du titre et des joueurs. Cette limitation concerne les sections Data et Audit History. La section Data contient des fonctionnalités comme Data Explorer, qui vous permet d’interroger et d’afficher un enregistrement d’événements PlayFab, présentant des événements (appels d’API) tels que le moment où un joueur spécifique s’est connecté.
Autres
Dans les paramètres du titre, l’onglet Secret keys est masqué. Consultez la documentation sur la gestion des clés secrètes.
Étapes suivantes
Après avoir essayé la démonstration, nous vous recommandons de commencer par ces articles pour en savoir plus sur le fonctionnement de PlayFab :- En savoir plus sur Game Manager
- En savoir plus sur le modèle d’entité
- En savoir plus sur le SDK PlayFab Services