> ## 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 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](https://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.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/demo-game/demo-games-overview.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=4312da1a7db281fb614184912df424b7" alt="Page d'accueil de Game Manager affichant les jeux de démonstration" width="1100" height="600" data-path="images/playfab/demo-game/demo-games-overview.png" />

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 implémenter des fonctionnalités personnalisées. Le jeu utilise actuellement les fonctionnalités PlayFab suivantes :

* 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](https://developer.playfab.com).

À 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.

<img src="https://mintcdn.com/microsoft-4404708b/21eXsQWfZsj4EYti/images/playfab/demo-game/winter-starfall-activity.webp?fit=max&auto=format&n=21eXsQWfZsj4EYti&q=85&s=054047b1d948df754d82778ae711bd27" alt="winter-starfall-profile" width="3211" height="1359" data-path="images/playfab/demo-game/winter-starfall-activity.webp" />

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 le SDK PlayFab auquel il se rapporte.
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 que vous êtes invité à vous connecter avec un compte de développeur PlayFab.
4. **Clear** supprime toutes les notifications actuelles de la barre d'activité.

<Note>
  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](https://developer.playfab.com).
</Note>

## 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](/fr/services/playfab/demo-game/source-code-and-best-practices) présente en détail le flux de connexion et les bonnes pratiques d'authentification des joueurs.

[En savoir plus sur l'authentification PlayFab](/fr/services/playfab/identity/player-identity/authentication)

### É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](/fr/services/playfab/demo-game/source-code-and-best-practices) présente en détail le flux d'achat du jeu.

[En savoir plus sur Economy V2](/fr/services/playfab/economy-monetization/economy-v2/overview)

### Donné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](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserdata). Ces données sont ensuite récupérées avec `GetUserData` lors de sa connexion, afin de replacer le joueur au bon endroit de l'histoire avec toute sa progression passée.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/demo-game/winterstarfall-player-data.jpg?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=49372a116bcafd08eb85bb8ae82bba41" alt="winter-starfall-player-data" width="1280" height="800" data-path="images/playfab/demo-game/winterstarfall-player-data.jpg" />

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 des joueurs](/fr/services/playfab/player-progression/player-data)

### 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 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/services/playfab/demo-game/source-code-and-best-practices).

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/demo-game/winterstarfall-title-data.jpg?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=c90a1a2de5f2b0cdefc3b93630023a1f" alt="Vue d'ensemble des données de titre de Winter Starfall dans Game Manager" width="1280" height="800" data-path="images/playfab/demo-game/winterstarfall-title-data.jpg" />

[En savoir plus sur les données de titre](/fr/services/playfab/live-service-management/game-configuration/titledata)

### 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](https://github.com/PlayFab/winter-starfall/blob/main/azure-functions/CombatVictory.cs) - 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](https://github.com/PlayFab/winter-starfall/blob/main/azure-functions/PlayerCreated.cs) - Équipe un nouveau joueur avec des objets et des statistiques de départ.
* [ProgressCheckpoint](https://github.com/PlayFab/winter-starfall/blob/main/azure-functions/ProgressCheckpoint.cs) - Effectue des actions pour débloquer des objets et des personnages après avoir atteint des 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 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](/fr/services/playfab/demo-game/source-code-and-best-practices).

[En savoir plus sur CloudScript avec Azure Functions](/fr/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)

<Note>
  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).
</Note>

### 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.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/demo-game/winterstarfall-title-news.jpg?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=dfa9a280fd3013c08a2e038f90f99f7e" alt="winter-starfall-title-news" width="3321" height="1930" data-path="images/playfab/demo-game/winterstarfall-title-news.jpg" />

Outre les actualités du titre, PlayFab propose d'autres fonctionnalités de communication, comme les modèles d'e-mails et les notifications Push.

[En savoir plus sur les méthodes de communication du titre](/fr/services/playfab/live-service-management/game-configuration/title-communications/overview)

## 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](https://github.com/PlayFab/winter-starfall) et exécuter une instance locale du jeu, ou créer votre propre titre à partir de zéro.

<Note>
  Pour un guide complet des fonctionnalités du portail des développeurs, consultez la [documentation de Game Manager](/fr/services/playfab/live-service-management/gamemanager)
</Note>

### 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.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/demo-game/player-overview.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=ab0d5defe256d9be89f5a8faac3b169c" alt="Vue d'ensemble du joueur" width="1280" height="1200" data-path="images/playfab/demo-game/player-overview.png" />

### 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](/fr/services/playfab/data-analytics/learn-data/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é.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/demo-game/demo-game-data.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=dd8dd0c11b6e7ed7208422e8a10d4b40" alt="Page Data" width="1280" height="1400" data-path="images/playfab/demo-game/demo-game-data.png" />

L'[historique d'audit](/fr/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 de la section **Data**, consultez la [documentation sur les données et l'analytique](/fr/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/services/playfab/live-service-management/gamemanager/secret-key-management).

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/demo-game/secret-keys.jpg?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=a152e4f9929b777d3e1767ec65e06bf6" alt="Interface de Game Manager affichant la page Secret Keys" width="1280" height="800" data-path="images/playfab/demo-game/secret-keys.jpg" />

## É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/services/playfab/live-service-management/gamemanager)
* En savoir plus sur le [modèle d'entité](/fr/services/playfab/live-service-management/game-configuration/entities)
* En savoir plus sur le [SDK PlayFab Services](/fr/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/services/playfab/demo-game/source-code-and-best-practices)


## Related topics

- [Vue d'ensemble de PlayFab Party](/fr/services/playfab/multiplayer/networking/index.md)
- [Vue d'ensemble du plug-in PlayFab Unreal GSDK](/fr/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Vue d'ensemble de PlayFab pour Unreal Engine](/fr/services/playfab/sdks/unified-unreal/overview.md)
- [Vanguard Outrider (hérité)](/fr/services/playfab/demo-game/legacy-vanguard-outrider.md)
- [Code source et bonnes pratiques - Winter Starfall](/fr/services/playfab/demo-game/source-code-and-best-practices.md)
