玩家封禁系统 - XBOX Game Development Documentation

玩家封禁功能允许你限制某些违反规则的玩家访问游戏。当对玩家应用封禁时,任何现有的玩家身份验证令牌都会失效,该玩家未来的身份验证尝试也会被拒绝。玩家封禁可以是永久性的,也可以是指定时间范围内的临时封禁,且可以针对玩家 ID 或 IP 地址应用。封禁的范围仅限于一个游戏,不适用于你命名空间中的其他任何游戏。

对于新集成,我们建议使用专用的 IP 封禁系统,而不是在玩家封禁中指定 IP 地址。

以下教程向你展示如何通过 PlayFab API 和 Game Manager 使用封禁系统。

识别

虽然你的游戏可能有自定义系统来识别作弊者和违规者,但 PlayFab 提供了玩家对玩家的举报机制。本质上,你依靠玩家来举报其他有问题的玩家。若要让客户端举报特定玩家,请在客户端代码中使用以下代码片段。

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

此 API 调用会生成:

一个举报事件,你可以通过分析工具 (1) 定位它。
选择 player_reported_as_abusive 事件类型 (2)。
这将显示:
- 事件名称 (3)。
- 被举报的玩家 ID (4)。

应用封禁

一旦识别出有问题的玩家,你可能会应用封禁。有两种方法可以应用封禁:通过 Game Manager 手动应用,或通过代码以编程方式应用。

从 Game Manager 创建封禁

社区管理代表可能希望使用 Game Manager 应用封禁。

导航到 Players 部分。
找到并选择有问题的玩家。
导航到 Bans 选项卡。
选择 Add Ban 以显示 Add Ban 表单。
输入封禁原因和期望的持续时间。可选地,你可以按特定 IP ADDRESS (4) 进行封禁。
最后,选择 ADD BAN 按钮。

如果一切设置正确,你会在表格中看到一个新的封禁。你也可以选择在 REVOKE BANS 字段中选择手动移除一个封禁。

从服务器或服务创建封禁

或者,你可以使用服务 SDK通过下面提供的代码片段以代码方式应用封禁。

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());
    });
}

通过代码应用的封禁也会显示在 Game Manager 中目标玩家的封禁表格中。

PlayFab 服务器 SDK 方法提供了更多选项,例如 IP 地址封禁。

每个应用的封禁都会获得一个分配的 ID。请考虑以下服务器 SDK API 方法以进行精确的封禁管理:

你可以使用 CloudScript 函数作为可能封禁玩家的自动化系统的一部分。要了解有关 CloudScript 的更多信息,请参阅我们的教程编写自定义 CloudScript。

另请参阅

BanUsers

​识别

​应用封禁

​从 Game Manager 创建封禁

​从服务器或服务创建封禁

​另请参阅

识别

应用封禁

从 Game Manager 创建封禁

从服务器或服务创建封禁

另请参阅