Tableau des leaders
Le tableau de classement est un module qui fournit des fonctions pour enregistrer et gérer les classements et les meilleurs scores de chaque joueur.
Pour créer un tableau de classement, sélectionnez le bouton [Obtenir les informations du tableau de classement] dans le menu Paramètres du projet → Zepeto → ZepetoLeaderboard.
Sélectionnez [Ajouter un tableau de classement] pour ajouter un nouveau tableau de classement.
S'il existe déjà un tableau de classement, celui-ci apparaîtra à l'écran des paramètres.
La fenêtre contextuelle montrée ci-dessous apparaîtra lorsque le bouton [Ajouter un Classement] sera sélectionné. Vous pourrez ajuster les valeurs de chaque paramètre.
Paramètre | Description |
|---|---|
Nom | Nom du classement |
Règle de mise à jour | Règles de mise à jour des scores |
Score max | Enregistrer le score le plus élevé de l'utilisateur |
Score min | Enregistrer le score le plus bas de l'utilisateur |
Accumuler le score | Ajouter les scores de l'utilisateur et les enregistrer comme un enregistrement |
ResetInfo(s) | Vous pouvez définir une période pour la réinitialisation des scores. - Cela est utile si le classement doit être mis à jour chaque saison. - Les scores ne seront pas réinitialisés par défaut, mais vous pouvez faire des ajustements en définissant des périodes de réinitialisation (mensuelles, hebdomadaires, quotidiennes). |
Les règles de réinitialisation des scores sont les suivantes :
Période | Description |
|---|---|
Aucun | Les scores ne seront pas réinitialisés |
Jour | Les scores seront réinitialisés quotidiennement à l'heure fixée (ex. classement quotidien) |
Semaine | Les scores seront réinitialisés hebdomadairement à la date et à l'heure fixées (ex : classement hebdomadaire) |
Mois | Les scores seront réinitialisés mensuellement à la date et à l'heure fixées (ex : classement mensuel ; la valeur maximale du jour est 31, mais si le mois n'a pas 31 jours, elle s'ajustera automatiquement au dernier jour du mois) |
Pour utiliser ZEPETOScript et le tableau de classement, vous devez avoir les informations de l'ID du tableau de classement.
Pour accéder aux informations du tableau de classement, vous pouvez aller dans Paramètres (sous Modifier dans le menu Paramètres du projet, allez à Zepeto → Tableau de classement Zepeto → Modifier), ou charger depuis l'API ZEPETOScript.
📘 Veuillez vous référer au guide suivant. [Recherche des détails du tableau de classement]
- Une fois la règle de réinitialisation définie, le tableau de classement ne peut pas être modifié.
- Pour changer la règle de réinitialisation, vous devez créer un nouveau tableau de classement.
- Le temps de réinitialisation est basé sur UTC+0. Un décalage sera fourni afin que le fuseau horaire puisse être modifié à l'avenir.
LeaderboardAPI.SetScore() est une API qui enregistre le score de l'utilisateur sur le tableau des scores. L'ID du tableau des scores, la valeur du score, le point d'achèvement et le point d'erreur sont passés en tant qu'argument.
Les informations de l'utilisateur pour le score seront automatiquement enregistrées.
Voici un exemple pour charger la fonction LeaderboardAPI.SetScore.
Voici le modèle de code pour récupérer le score de l'utilisateur sur le tableau des scores.
Utilisez la fonction LeaderboardAPI.GetRangeRank() pour charger une plage spécifique de détails de classement.
La valeur booléenne pour récupérer l'ID du tableau des leaders, le classement de départ, le dernier classement, la règle de réinitialisation et les informations de classement de la dernière saison, et la fonction de rappel depuis le moment d'achèvement et le moment de l'occurrence d'erreur est passée comme argument.
Les informations utilisateur qui demandent des informations de classement sont automatiquement saisies, et jusqu'à 100 informations de classement peuvent être traitées par demande (ex : pagination en 1100, 101format 200 pour mise en œuvre)
❗️ Attention Si plus de 100 données sont chargées à la fois, cela peut ne pas fonctionner correctement en raison de problèmes de charge API et de limites de taux.
Un exemple d'appel de la fonction LeaderboardAPI.GetRangeRank() est le suivant :
Le code suivant est un exemple pour charger une plage spécifique d'informations de classement. Vous pouvez utiliser la valeur Membre de OnResult pour charger la photo de profil.
📘 Veuillez vous référer au guide suivant. [Informations utilisateur]
Utilisez la fonction LeaderboardAPI.GetAllLeaderboards pour charger toutes les informations de classement dans le Monde spécifié. La fonction de rappel du moment de l'achèvement au moment de l'occurrence d'une erreur est passée en tant qu'argument.
Un exemple de chargement de la fonction LeaderboardAPI.GetAllLeaderboards est le suivant :
Ce qui suit est un exemple pour charger toutes les informations du tableau des leaders.
Utilisez la fonction LeaderboardAPI.GetLeaderboards pour charger des informations spécifiques sur le tableau des leaders. La fonction de rappel pour l'ID du tableau des leaders, le temps d'achèvement, le temps d'occurrence d'erreur sont passés en tant qu'argument.
Un exemple de chargement de la fonction LeaderboardAPI.GetLeaderboard est le suivant :
Ce qui suit est un exemple de chargement de certaines informations de classement.
- Ce qui suit est un exemple d'un classement appliqué à la fête de slime officielle de ZEPETO World.
- En définissant, lisant et utilisant des appels API pour récupérer des classements dans une plage spécifique, vous pouvez le structurer comme suit dans l'interface utilisateur.
