Jeu de démonstration : Winter Starfall
Winter Starfall est un jeu développé par PlayFab pour mettre en valeur nos différentes fonctionnalités et offrir un moyen d’explorer leur mise en œuvre dans un jeu en direct. Le jeu peut être joué sur WinterStarfall.com. Si vous avez déjà un compte de développeur PlayFab, vous pouvez aussi y accéder par le portail des développeurs, à la page My Studios and Titles.
- Economy V2 (catalogue, monnaie, ensembles, boutiques)
- Données de titre, données de joueur et autres fonctions de base de PlayFab
- Nouvelles de 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 peut être joué par tout le monde, 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, dans le coin supérieur droit, se trouve une icône PlayFab qui ouvre la barre latérale d’activité PlayFab lorsqu’on la sélectionne.
- 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 à quel SDK PlayFab il est lié.
- 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 qu’on vous invite à 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 en tout temps, 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écrit plus en détail 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 retourne un jeton d’authentification requis pour tous les appels d’API subséquents. Winter Starfall prend en charge plusieurs formes de connexion récupérable avec une adresse courriel, Microsoft (par 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 pratiques exemplaires pour l’authentification des joueurs. En savoir plus sur l’authentification PlayFabÉconomie
En tant que jeu de rôle (RPG) fantastique, Winter Starfall comprend un système économique qui permet au joueur de visiter des boutiques, d’acheter des objets et de gagner de la monnaie au moyen de combats. Le plus récent service d’économie de PlayFab gère tout ce qui touche 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 qui se produit dans le jeu. En savoir plus sur Economy V2Données de joueur
Les joueurs dans PlayFab ont des données associées qui sont stockées dans le service par différentes fonctionnalités. La fonctionnalité de données de joueur vous permet de stocker des informations liées au joueur 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 de joueur servent à stocker l’état du jeu et des informations comme les personnages qui se sont joints au groupe du joueur. Lorsque le joueur progresse dans l’histoire, sa position est enregistrée dans son profil de joueur au moyen d’un appel à l’API UpdateUserData. Ces données sont ensuite récupérées avecGetUserData lors de la connexion, afin de charger le joueur au bon endroit dans 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 ressemblent aux données de joueur en ce qu’elles stockent des paires clé-valeur, sauf que les données concernent le titre du jeu plutôt qu’un joueur précis. Winter Starfall utilise les données de titre avec le système Economy pour calculer le prix lors de la 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 de mettre en œuvre des fonctionnalités personnalisées côté serveur, ce qui offre des solutions presque illimitées lorsqu’elle est combinée à d’autres fonctionnalités PlayFab. Le jeu utilise cette fonctionnalité pour répondre à de nombreux scénarios :- CombatVictory - Après que le joueur a gagné 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 d’objets et de statistiques de départ.
- ProgressCheckpoint - Effectue des actions pour déverrouiller des objets et des personnages après l’atteinte de 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 à prix réduit, ce qui n’est pas une fonctionnalité inhérente du système économique. Le flux d’achat et de vente est abordé 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.
Nouvelles de titre
Les nouvelles de titre servent à communiquer avec tous les joueurs d’un titre. Winter Starfall les met en œuvre comme système de notifications pour afficher des conseils de jeu et des avis.
Limites de la démonstration
Comme Winter Starfall est alimenté par de vraies données de joueurs, la portée de certaines fonctionnalités est limitée dans la vue Game Manager. Cette section donne un aperçu de l’apparence qu’auraient 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. Habituellement, vous pourriez interroger la liste complète des joueurs de votre jeu et sélectionner un compte individuel pour mettre à jour ses données dans Game Manager. À partir de la page de vue d’ensemble du joueur, vous pouvez consulter toutes les informations liées au joueur, notamment les objets de l’inventaire, un registre de toutes les connexions, les données de joueur et plus encore.
Données et analytique
Certaines des fonctionnalités de la section Analyze sont également limitées afin de protéger les informations du titre et des joueurs. Cette limite s’applique notamment aux sections Data et Audit History. La section Data contient des fonctionnalités comme Data Explorer, qui vous permet d’interroger et de consulter un registre d’événements PlayFab, lequel montre des événements (appels d’API) comme le moment où un joueur précis 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