Chaînes
Pour vos chaînes de présence enrichie, vous devez définir les ensembles de chaînes. Nous vous recommandons d’attribuer à chaque ensemble de chaînes un nom convivial à utiliser comme identificateur. Chaque ensemble de chaînes que vous créez doit contenir un groupe de chaînes localisées de manière appropriée pour les paramètres régionaux dans lesquels le jeu sera publié. En plus des chaînes localisées, vous devez également fournir une chaîne indépendante de la culture. Cette chaîne est utilisée si une requête porte sur des paramètres régionaux qui ne sont pas présents. Chaque ensemble de chaînes peut également utiliser des données du jeu en paramétrant les chaînes afin de les enrichir davantage. Un ensemble de chaînes peut comporter autant de paramètres que vous le souhaitez, tant que les chaînes obtenues ne dépassent pas les limites de caractères. Pour plus d’informations, consultez Stratégies et limites des chaînes de présence enrichie.Énumérations
Les énumérations décrites ci-dessous sont définies au moyen des événements des données de joueur XBOX.Statistiques
Vous pouvez utiliser des valeurs de statistiques numériques basées sur les événements dans vos chaînes de présence enrichie. Par exemple, dans un jeu de tir, vous pourriez souhaiter que la chaîne de présence enrichie indique le nombre actuel d’éliminations du joueur. La configuration doit indiquer que le paramètre est remplacé par la statistique « Kill Count ». Celle-ci a été créée au moyen du système d’événements Common Schema et est transmise ou relayée au service XBOX Player Stats pour être convertie en données de joueur. La statistique doit être définie à l’aide de la configuration des statistiques. Lorsque la chaîne est lue par un autre joueur, le service de présence enrichie récupère la valeur la plus récente de la statistique « Kill Count ». La chaîne est ainsi toujours à jour. Les chaînes de présence enrichie contenant des variables sont compatibles uniquement avec les statistiques numériques basées sur les événements, et non avec les statistiques gérées par le titre.État
Vous pouvez également choisir d’utiliser dans vos chaînes de présence enrichie des statistiques qui représentent des valeurs d’état réelles. Par exemple, dans un jeu de course, vous pourriez utiliser une chaîne de présence enrichie pour indiquer la voiture que conduit actuellement le joueur ou la carte ou le circuit sur lequel il court. Pour configurer les informations d’état- Définissez des énumérations pour toutes les chaînes du jeu. Par exemple, si votre jeu comporte cinq cartes et que vous souhaitez qu’elles fassent partie de vos chaînes de présence enrichie, ces cinq cartes doivent également être énumérées sous forme de chaînes localisées.
- Liez les énumérations aux statistiques. Le service de présence enrichie récupère là encore la valeur la plus récente dans les données de joueur en consultant la valeur de la statistique. Le service détermine ensuite à quelle valeur d’énumération correspond la statistique.
Exemple de jeu
Pour la suite de l’exemple, supposons que vous travaillez sur le tout dernier jeu de coups de pied dans des seaux. Vous souhaitez créer une statistique pour chaque type de seau frappé, puis afficher les statistiques à l’aide de chaînes de présence enrichie. Supposons que les règles du jeu soient les suivantes :- Les types de seaux sont en bois, en argent et en or.
- Les lieux sont les montagnes, le désert et la plage.
- Lorsqu’un seau est frappé, il se brise. Le joueur doit toujours chercher d’autres seaux.
- Certains seaux nécessitent un équipement spécial pour être frappés avec succès. Par exemple, une botte doit être suffisamment solide pour résister à un coup de pied.
- Le jeu propose un mode multijoueur. Si suffisamment de joueurs tentent de frapper un seau en même temps, une botte particulière n’est pas nécessaire.
Configuration des statistiques pour la présence enrichie
Pour utiliser dans vos chaînes de présence enrichie une statistique générée par les données de joueur XBOX, fournissez les noms au service de présence enrichie.Exemple de configuration d’énumérations
Voici un exemple de définition de quelques énumérations.- Créez une énumération pour les cartes du jeu. Le jeu comporte trois cartes. Chacune reçoit un nom convivial afin de pouvoir y faire facilement référence.
- Pour chaque paramètre régional, créez une chaîne localisée pour le nom de cette carte. Notez qu’il existe une localisation par défaut globale et une localisation indépendante de la culture.
- Prenons les trois armes du jeu. Elles disposent de noms conviviaux et de chaînes localisées. Cela vaut pour toutes les énumérations.
Exemple de configuration de chaînes
Maintenant que les énumérations et les statistiques ont été définies, créez vos chaînes. Dans l’exemple de tableau suivant, la première colonne est un nom convivial qui permet de distinguer un ensemble de chaînes d’un autre. Dans cet exemple, la chaîne « playingMap » est utilisée pour le premier ensemble de chaînes, « totalKicked » pour le deuxième et « multiplayer » pour le troisième.Paires paramètres régionaux-chaîne
Les deux colonnes suivantes vont ensemble. Il s’agit des paires paramètres régionaux-chaîne de la chaîne de présence enrichie. Dans le premier exemple, la chaîne anglaise « Playing on » est utilisée. Le jeton est remplacé par une valeur. La chaîne est ensuite localisée pour les autres paramètres régionaux. Comme pour les énumérations, il doit exister une chaîne par défaut et des chaînes indépendantes de la culture. Elles sont utilisées lorsqu’un joueur utilise des paramètres régionaux pour lesquels vous n’avez pas spécifié de paire paramètres régionaux-chaîne. Les paramètres régionaux utilisés pour les énumérations doivent correspondre à ceux de vos chaînes.Paramètres permettant de construire une chaîne
La dernière colonne contient les paramètres utilisés pour compléter les champs de la chaîne de présence enrichie. Si vous souhaitez que le service Presence recherche la valeur du paramètre dans le service Statistics, vous devez utiliser ici le nom de la statistique pour faire référence au paramètre. L’utilisation de statistiques dans vos chaînes vous permet de les définir une seule fois. Vous n’avez pas à les réécrire. Si votre chaîne contient le nom de la carte et que vous utilisez la statistiqueCurrentMap pour compléter le champ, le service de présence enrichie met à jour votre chaîne en conséquence lorsque vos joueurs passent d’une carte à l’autre dans le jeu.
Si vous n’utilisez pas de statistiques dans vos chaînes de présence enrichie, aucun paramètre ne peut être spécifié.
Dans l’exemple de tableau suivant, utilisez la carte actuelle générée par les statistiques dans la première chaîne. Utilisez la statistique BucketsKicked dans la deuxième chaîne.
Le troisième exemple ne comporte pas de paramètres.
La chaîne est définie seule; elle ne fait pas référence à des statistiques.
Le nombre de chaînes que vous pouvez créer n’est pas limité, mais votre jeu doit comporter au moins une chaîne.
BucketsKicked est simplement un nombre qui est remplacé dans votre chaîne.
CurrentMap est un exemple de statistique dont la chaîne provient de l’énumération.
Lorsque votre jeu définit la présence enrichie sur l’une de ces chaînes, utilisez la configuration pour savoir quels paramètres sont nécessaires.