Système de bannissement des joueurs - XBOX Game Development Documentation

La fonctionnalité de bannissement des joueurs vous permet de restreindre l’accès au jeu pour certains joueurs qui enfreignent les règles. Lorsqu’un bannissement est appliqué à un joueur, tous les jetons d’authentification existants du joueur sont invalidés et ses tentatives d’authentification ultérieures sont rejetées. Les bannissements de joueurs peuvent être permanents ou temporaires pour une durée spécifiée, et peuvent s’appliquer à un ID de joueur ou à une adresse IP. Un bannissement est limité à un titre et ne s’applique à aucun autre titre de votre espace de noms.

Pour les nouvelles intégrations, nous recommandons d’utiliser le système de bannissement d’adresses IP dédié plutôt que de spécifier des adresses IP dans les bannissements de joueurs.

Le tutoriel suivant vous montre comment utiliser le système de bannissement à l’aide de l’API PlayFab et de Game Manager.

Identifier

Bien que votre jeu puisse disposer d’un système personnalisé pour identifier les tricheurs et les contrevenants aux règles, PlayFab offre un mécanisme de signalement entre joueurs. En substance, vous comptez sur vos joueurs pour signaler les autres joueurs problématiques. Pour permettre au client de signaler un joueur spécifique, utilisez l’extrait suivant dans votre code client.

public void ReportPlayer(string problematicPlayerId, string reason) {
    PlayFabClientAPI.ReportPlayer(new ReportPlayerClientRequest() {
        ReporteeId = problematicPlayerId,
        Comment = reason
    }, result => {
        //... Handle success
    }, error => {
        Debug.Log(error.GenerateErrorReport());
    });
}

Cet appel d’API produit :

Un événement de signalement, que vous pouvez retrouver au moyen de l’outil Analytics (1).
Sélectionnez le type d’événement player_reported_as_abusive (2).
Vous voyez alors :
- Le nom de l’événement (3).
- L’ID du joueur (4) signalé.

Game Manager - Analytics - Historique des événements

Application des bannissements

Une fois le joueur problématique identifié, vous pouvez appliquer un bannissement. Il existe deux façons d’appliquer des bannissements : manuellement au moyen de Game Manager, ou par programmation dans le code.

Création d’un bannissement depuis Game Manager

Votre responsable de la gestion de la communauté peut souhaiter appliquer un bannissement à l’aide de Game Manager.

Accédez à la section Players.
Recherchez et sélectionnez le joueur problématique.
Accédez à l’onglet Bans.
Sélectionnez Add Ban pour afficher le formulaire Add Ban.
Saisissez le motif (Reason) du bannissement et la durée souhaitée. Vous pouvez éventuellement bannir une ADRESSE IP (4) spécifique.
Enfin, sélectionnez le bouton ADD BAN.

Game Manager - Joueurs - Ajouter un bannissement

Si tout est correctement défini, un nouveau bannissement apparaît dans le tableau. Vous pouvez éventuellement supprimer manuellement un bannissement en le sélectionnant dans le champ REVOKE BANS.

Game Manager - Joueurs - Bannissements - Révoquer un bannissement

Création d’un bannissement depuis un serveur ou un service

Vous pouvez également utiliser le SDK Services pour appliquer un bannissement dans le code à l’aide de l’extrait fourni ci-dessous.

public void AddBan(string playerId, uint hours) {
    PlayFabServerAPI.BanUsers(new BanUsersRequest() {
        Bans = new List<BanRequest>() {
            new BanRequest() {
                DurationInHours = hours,
                PlayFabId = playerId,
                Reason = "Automatic ban for WH",
            }
        }
    }, result => {
        //... Handle success
    }, error => {
        Debug.Log(error.GenerateErrorReport());
    });
}

Les bannissements appliqués dans le code s’affichent également dans le tableau des bannissements du joueur ciblé dans Game Manager.

Les méthodes du SDK serveur PlayFab offrent davantage d’options, comme les bannissements par adresse IP.

Chaque bannissement que vous appliquez reçoit un ID. Tenez compte des méthodes d’API du SDK serveur suivantes pour une gestion précise des bannissements :

Vous pouvez utiliser des fonctions CloudScript dans le cadre d’un système automatisé susceptible de bannir un joueur. Pour en savoir plus sur CloudScript, consultez notre tutoriel Écrire du CloudScript personnalisé.

Voir aussi

BanUsers

​Identifier

​Application des bannissements

​Création d’un bannissement depuis Game Manager

​Création d’un bannissement depuis un serveur ou un service

​Voir aussi

Identifier

Application des bannissements

Création d’un bannissement depuis Game Manager

Création d’un bannissement depuis un serveur ou un service

Voir aussi