Services facultatifs

Une fois votre titre GDK pour PC fonctionnel, ajoutez des services XBOX facultatifs et des fonctionnalités Microsoft Azure PlayFab selon les besoins de votre conception. Aucun de ces éléments n’est requis pour publier dans le Microsoft Store; choisissez ce qui convient à votre titre.

​

Ordre d’adoption suggéré

1. Connexion et identité : XUser et connexion PlayFab.
2. Succès et statistiques : succès XSAPI et statistiques des joueurs.
3. Sauvegardes infonuagiques : XGameSave.
4. Fonctionnalités sociales : amis et joueurs récents et présence enrichie.
5. Multijoueur : salons, mise en correspondance, multijoueur, invitations et clavardage.
6. Commerce : XStore, achats en jeu et DLC.
7. Intégrations côté serveur : authentification S2S, contenu généré par les utilisateurs et opérations en direct.

​

Rubriques sur les services facultatifs

Chaque ligne ci-dessous correspond à une rubrique traitée dans le guide de bout en bout pour PC source. Les directives d’intégration détaillées se trouvent dans la documentation des fonctionnalités liée.

​

Clavardage

Utilisez PlayFab Party pour le clavardage vocal et textuel synchrone sur PC et XBOX. Étapes clés :

1. Configurez le SDK PlayFab Party.
2. Authentifiez le joueur auprès des services XBOX et de PlayFab.
3. Créez un réseau Party ou joignez-vous à un réseau existant avec PartyManager::CreateNewNetwork().
4. Créez un PartyLocalChatControl par utilisateur local et connectez-le avec PartyNetwork::ConnectChatControl().
5. Choisissez les périphériques d’entrée/sortie audio au moyen de PartyLocalChatControl::SetAudioInput/Output et d’un PartyAudioDeviceSelectionType.
6. Configurez les autorisations de clavardage et l’état de mise en sourdine entre les paires de contrôles de clavardage.
7. Ajoutez le clavardage textuel au moyen de SendText, éventuellement avec traduction au moyen de SetTextChatOptions.
8. Ajoutez des fonctionnalités d’accessibilité : transcription de la parole en texte et synthèse de texte en parole au moyen d’Azure Speech Services.
9. Activez la suppression du bruit sur l’audio capté par le microphone.

Si vous publiez également sur XBOX, utilisez la bibliothèque d’assistance Party XBOX Live pour satisfaire aux exigences des services XBOX.

​

Achats en jeu

Utilisez XStore (au moyen de XGameRuntime.h) pour les parcours d’achat en jeu dans le Microsoft Store :

• Interrogez le catalogue du magasin, les produits associés (extensions, consommables, biens durables) et la collection de droits d’utilisation de l’utilisateur.
• Affichez l’interface utilisateur d’achat au moyen de XStoreShowPurchaseUIAsync.
• Consommez les consommables au moyen de XStoreReportConsumableFulfillmentAsync.
• Actualisez les licences avec XStoreQueryProductForCurrentSkuAsync après des changements de droits d’utilisation.

Pour les économies virtuelles gérées par PlayFab (monnaies, inventaire, ensembles), associez les achats XStore à PlayFab Economy v2.

​

Invitations

Utilisez PlayFab Lobby pour les invitations et les participations sur PC/XBOX :

1. Intégrez le SDK PlayFab Lobby et Matchmaking.
2. Authentifiez-vous auprès des services XBOX et de PlayFab.
3. Choisissez le type de propriété du salon : appartenant à un joueur (PFMultiplayerCreateAndJoinLobby), appartenant à un serveur (PFMultiplayerCreateAndClaimServerLobby) ou créé par la mise en correspondance.
4. Écoutez les invitations au moyen de PFMultiplayerStartListeningForLobbyInvites.
5. Envoyez les invitations au moyen de l’interface utilisateur d’invitation de la plateforme afin que le destinataire voie une notification XBOX/Store native.

Le salon sert également de session de jeu à laquelle les joueurs se joignent après avoir accepté une invitation.

​

Classements

Utilisez les classements gérés par le titre XSAPI pour les classements sociaux et mondiaux des services XBOX :

1. Définissez les classements dans Partner Center sous Services XBOX → Données des joueurs.
2. Émettez des événements de statistiques liés au classement à l’aide du Stats Manager.
3. Interrogez les classements au moyen de XblLeaderboardGetLeaderboardAsync (mondial) ou de XblLeaderboardGetLeaderboardForSocialGroupAsync (amis).

Consultez Classements.

​

Salons

Utilisez PlayFab Lobby pour l’état de session partagé (liste des membres, propriétés arbitraires, propriété) :

• Créez, joignez, trouvez et quittez des salons avec le SDK C PlayFab Multiplayer.
• Stockez les métadonnées de jeu sous forme de propriétés du salon (mode de jeu, carte, état prêt).
• Combinez avec PlayFab Matchmaking pour former des salons à partir d’un groupe mis en correspondance.
• Combinez avec PlayFab Party pour ajouter la réseautique et la voix en plus de l’appartenance au salon.

​

Mise en correspondance

Utilisez PlayFab Matchmaking pour une mise en correspondance basée sur les compétences ou les attributs qui produit un salon partagé :

• Définissez des files d’attente de mise en correspondance dans le Game Manager de PlayFab avec des règles portant sur les attributs des joueurs.
• Soumettez des tickets au moyen de PFMatchmakingCreateMatchmakingTicket.
• Lorsqu’une correspondance est trouvée, les joueurs sont placés dans un salon partagé qui vous appartient.

Pour les titres uniquement XBOX Live, SmartMatch au moyen de MPSD est également pris en charge, mais PlayFab Matchmaking est la voie recommandée pour les nouveaux titres.

​

Multijoueur

Deux piles multijoueurs prises en charge sur PC/XBOX :

• PlayFab Multiplayer : multiplateforme, utilise PlayFab Lobby pour les sessions et PlayFab Party pour le transport. Recommandé pour les nouveaux titres.
• Multijoueur des services XBOX : sessions MPSD + Multiplayer Manager (MPM). Toujours pris en charge pour les titres exclusifs à XBOX.

Les deux voies sont décrites dans la vue d’ensemble du multijoueur.

​

Réseautique

Utilisez PlayFab Party comme transport réseau pour le trafic de jeu en temps réel :

• Envoyez des messages fiables/non fiables entre les points de terminaison connectés.
• Superposez la voix, le texte et les données de jeu sur le même réseau Party.
• Sur XBOX, Party s’intègre automatiquement au chemin réseau de la plateforme; sur PC, il utilise UDP avec une solution de repli.

​

Statistiques des joueurs

Utilisez le XSAPI Stats Manager pour les statistiques des joueurs gérées par le titre :

1. Définissez les statistiques dans Partner Center sous Services XBOX → Données des joueurs.
2. Ajoutez la statistique au joueur avec XblStatsManagerSetStatAsNumber / SetStatAsString.
3. Incrémentez ou remplacez les statistiques en réponse au jeu.
4. Videz les mises à jour en attente avec XblStatsManagerDoWork à chaque image.

Les statistiques alimentent les classements et sont affichées dans le profil du joueur.

​

Présence enrichie

Utilisez XSAPI Presence pour diffuser ce que fait le joueur :

1. Définissez les énumérations de présence et les ensembles de chaînes dans Partner Center.
2. Mettez à jour la présence avec XblPresenceSetPresenceAsync lorsque le joueur passe à un nouvel état (menu, niveau, partie).
3. Interrogez les autres joueurs avec XblPresenceGetPresenceAsync ou XblPresenceGetPresenceForMultipleUsersAsync.

Consultez Présence enrichie.

​

Authentification S2S

Utilisez Microsoft Entra ID + ID User Store pour l’authentification de service à service lorsque votre serveur principal doit appeler les API du Microsoft Store au nom d’un joueur :

• Deux types d’ID User Store :
  • UserCollectionsID : s’authentifie auprès du service Collections du Microsoft Store (inventaire des droits d’utilisation).
  • UserPurchaseID : s’authentifie auprès du service Purchase du Microsoft Store (vérification des transactions).
• Votre service obtient un jeton d’accès Entra ID et l’utilise, avec l’ID User Store provenant du client du jeu, pour appeler les API REST du Store.
• Recommandé pour les nouveaux titres; l’authentification basée sur les jetons X est une méthode héritée.

​

Contenu généré par les utilisateurs

Utilisez PlayFab Economy v2 pour les catalogues de contenu généré par les utilisateurs, en complément d’un pipeline de ressources interne ou tiers :

1. Authentifiez le joueur auprès de PlayFab.
2. Générez des URL de téléversement signées avec CreateUploadUrls.
3. Créez un élément brouillon avec CreateDraftItem (Type:ugc).
4. Énumérez les éléments brouillons au moyen de GetEntityDraftItems.
5. Publiez avec PublishDraftItem : les éléments publiés apparaissent dans le catalogue public.
6. Vérifiez l’état avec GetItemPublishStatus.
7. Interrogez le catalogue avec SearchItems (OData Filter, OrderBy, Select).

L’examen et la modération facultatifs sont assurés par les réviseurs de catalogue dans le Game Manager de PlayFab.

​

Contenu connexe

• Vue d’ensemble de bout en bout pour PC
• Vue d’ensemble des services XBOX
• Vue d’ensemble de PlayFab

​

Documentation d’API connexe

• Vue d’ensemble de XSAPI : identité, présence, fonctionnalités sociales, succès, classements
• Référence de l’API XStore : commerce du Microsoft Store
• Vue d’ensemble de PlayFab : REST + SDK de PlayFab