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

# Système de bannissement des joueurs

> Appliquez des bannissements de joueurs PlayFab pour invalider les jetons d'authentification des contrevenants aux règles à l'aide de Game Manager, de ReportPlayer et des appels de gestion des bannissements de l'API serveur.

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](/fr-CA/services/playfab/live-service-management/game-configuration/entities).

<Note>
  Pour les nouvelles intégrations, nous recommandons d'utiliser le [système de bannissement d'adresses IP](/fr-CA/services/playfab/player-progression/player-data/ip-bans) dédié plutôt que de spécifier des adresses IP dans les bannissements de joueurs.
</Note>

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.

```csharp theme={null}
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é.

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/player-progression/player-data/tutorials/game-manager-event-history-player-reported-as-abusive.png?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=2d2e5165fee8b1923bd8e693be322296" alt="Game Manager - Analytics - Historique des événements" width="2560" height="1039" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-event-history-player-reported-as-abusive.png" />

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

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

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/player-progression/player-data/tutorials/game-manager-players-add-ban.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=c281ac3e7daaf347d81fde5681c3af87" alt="Game Manager - Joueurs - Ajouter un bannissement" width="1280" height="900" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-players-add-ban.png" />

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

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/player-progression/player-data/tutorials/game-manager-players-bans-revoke-ban.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=7ce3408617095f8f4a7434e5048e4c7d" alt="Game Manager - Joueurs - Bannissements - Révoquer un bannissement" width="860" height="450" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-players-bans-revoke-ban.png" />

### Création d'un bannissement depuis un serveur ou un service

Vous pouvez également utiliser le [SDK Services](/fr-CA/services/playfab/sdks/playfab-sdk-intro) pour appliquer un bannissement dans le code à l'aide de l'extrait fourni ci-dessous.

```csharp theme={null}
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.

<Note>
  Les méthodes du SDK serveur PlayFab offrent davantage d'options, comme les bannissements par adresse **IP**.
</Note>

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 :

* [GetUserBans](xref:titleid.playfabapi.com.server.accountmanagement.getuserbans)
* [RevokeAllBansForUser](xref:titleid.playfabapi.com.server.accountmanagement.revokeallbansforuser)
* [RevokeBans](xref:titleid.playfabapi.com.server.accountmanagement.revokebans)
* [UpdateBans](xref:titleid.playfabapi.com.server.accountmanagement.updatebans)

<Note>
  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é](/fr-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript).
</Note>

## Voir aussi

[BanUsers](xref:titleid.playfabapi.com.server.accountmanagement.banusers)


## Related topics

- [Système de bannissement d'adresses IP](/fr-CA/services/playfab/player-progression/player-data/ip-bans.md)
- [Paramètres des fonctionnalités d'API dans PlayFab Game Manager](/fr-CA/services/playfab/live-service-management/gamemanager/api-feature-settings-in-the-playfab-game-manager.md)
- [Services de chiffrement des joueurs](/fr-CA/services/playfab/identity/player-identity/encryption/player-encryption-services.md)
- [Vue d'ensemble des données de joueur XBOX](/fr-CA/services/xbox-services/player-data/live-playerdata-overview.md)
- [Envoi de commentaires de réputation depuis un titre](/fr-CA/services/xbox-services/community/reputation/concepts/live-sending-reputation-feedback.md)