> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Vue d'ensemble du jeu de démonstration PlayFab Winter Starfall
> Découvrez Winter Starfall, le jeu de démonstration jouable de PlayFab qui présente de bout en bout des fonctionnalités de service en direct comme les comptes, l'économie, le matchmaking et l'analytique.
# 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](https://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.
Le jeu est conçu comme une application Web et utilise les API du SDK PlayFab ainsi que l'intégration Azure Functions de PlayFab pour mettre en œuvre des fonctionnalités personnalisées. Le jeu utilise actuellement les fonctionnalités PlayFab suivantes :
* 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](https://developer.playfab.com).
À 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.
1. 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é.
2. 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.
3. 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.
4. **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](https://developer.playfab.com).
## 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](/fr-CA/services/playfab/demo-game/source-code-and-best-practices) 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](/fr-CA/services/playfab/identity/player-identity/authentication)
### É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](/fr-CA/services/playfab/demo-game/source-code-and-best-practices) présente en détail le flux d'achat qui se produit dans le jeu.
[En savoir plus sur Economy V2](/fr-CA/services/playfab/economy-monetization/economy-v2/overview)
### Donné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](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserdata). Ces données sont ensuite récupérées avec `GetUserData` lors de la connexion, afin de charger le joueur au bon endroit dans l'histoire avec toute sa progression passée.
Par exemple, voici le corps de la requête et de la réponse de l'API lors de l'appel à `GetUserData` pendant le flux de connexion.
**GetUserData - Requête**
```json theme={null}
{
"Keys": [
"stats",
"location",
"party",
"notifications",
"cinematicProgression",
"enemyGroupProgression"
]
}
```
**GetUserData - Réponse**
```json theme={null}
{
"code": 200,
"status": "OK",
"data": {
"Data": {
"location": {
"Value": "{\"id\":\"intro\",\"map\":[\"intro\",\"intro-village\"]}",
"LastUpdated": "2024-09-20T18:16:13.68Z",
"Permission": "Private"
},
"party": {
"Value": "{\"characters\":[{\"id\":1,\"armor\":\"dfae3ef9-92a0-493b-9bb8-f88a09718d26\",\"weapon\":\"32e1f684-43b0-4fe6-982e-b0829ff0d6f3\",\"spells\":null}],\"guests\":[]}",
"LastUpdated": "2024-09-20T18:16:13.68Z",
"Permission": "Private"
}
},
"DataVersion": 20
},
"CallBackTimeMS": 97
}
```
[En savoir plus sur la fonctionnalité de données de joueur](/fr-CA/services/playfab/player-progression/player-data)
### 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 valeur `multipliers` 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](/fr-CA/services/playfab/demo-game/source-code-and-best-practices).
[En savoir plus sur les données de titre](/fr-CA/services/playfab/live-service-management/game-configuration/titledata)
### 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](https://github.com/PlayFab/winter-starfall/blob/main/azure-functions/CombatVictory.cs) - 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](https://github.com/PlayFab/winter-starfall/blob/main/azure-functions/PlayerCreated.cs) - Équipe un nouveau joueur d'objets et de statistiques de départ.
* [ProgressCheckpoint](https://github.com/PlayFab/winter-starfall/blob/main/azure-functions/ProgressCheckpoint.cs) - Effectue des actions pour déverrouiller des objets et des personnages après l'atteinte de points clés de l'histoire.
* [ResetPlayer](https://github.com/PlayFab/winter-starfall/blob/main/azure-functions/ResetPlayer.cs) - Efface les données utilisateur, les objets et les statistiques pour une réinitialisation complète.
* [SellItem](https://github.com/PlayFab/winter-starfall/blob/main/azure-functions/SellItem.cs) - 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](/fr-CA/services/playfab/demo-game/source-code-and-best-practices).
[En savoir plus sur CloudScript avec Azure Functions](/fr-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)
Les fonctions CloudScript de Winter Starfall sont écrites en C#, mais vous pouvez utiliser n'importe quel langage pris en charge par [Azure Functions](https://learn.microsoft.com/azure/azure-functions/supported-languages?tabs=isolated-process%2Cv4\&pivots=programming-language-csharp).
### 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.
En plus des nouvelles de titre, PlayFab offre d'autres fonctionnalités de communication, comme des modèles pour les courriels et les notifications Push.
[En savoir plus sur les méthodes de communication de titre](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/overview)
## 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](https://github.com/PlayFab/winter-starfall) 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](/fr-CA/services/playfab/live-service-management/gamemanager)
### 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](/fr-CA/services/playfab/data-analytics/learn-data/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é.
L'[historique d'audit](/fr-CA/services/playfab/live-service-management/gamemanager/audit-logs) offre une vue de l'historique des modifications apportées au titre par toute personne disposant d'un accès en modification.
Pour une vue complète des autres fonctionnalités qui font partie de la section **Data**, consultez la [documentation sur les données et l'analytique](/fr-CA/services/playfab/data-analytics).
### Autres
Dans les paramètres du titre, l'onglet **Secret keys** est masqué. Consultez la [documentation sur la gestion des clés secrètes](/fr-CA/services/playfab/live-service-management/gamemanager/secret-key-management).
## É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](/fr-CA/services/playfab/live-service-management/gamemanager)
* En savoir plus sur le [modèle d'entité](/fr-CA/services/playfab/live-service-management/game-configuration/entities)
* En savoir plus sur le [SDK PlayFab Services](/fr-CA/services/playfab/sdks/sdk-overview)
## Voir aussi
* [Jouer à Winter Starfall](https://winterstarfall.com/)
* [Tutoriel : Télécharger le code source et des exemples de flux](/fr-CA/services/playfab/demo-game/source-code-and-best-practices)
## Related topics
- [Vue d'ensemble de PlayFab Party](/fr-CA/services/playfab/multiplayer/networking/index.md)
- [Vue d'ensemble du plug-in PlayFab Unreal GSDK](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Vue d'ensemble de PlayFab pour Unreal Engine](/fr-CA/services/playfab/sdks/unified-unreal/overview.md)
- [Vanguard Outrider (hérité)](/fr-CA/services/playfab/demo-game/legacy-vanguard-outrider.md)
- [Code source et pratiques exemplaires - Winter Starfall](/fr-CA/services/playfab/demo-game/source-code-and-best-practices.md)