跳到主要内容

玩家处惩罚

1. 概述​

玩家惩罚是指玩家在特定时间内被禁止使用某些功能。这是游戏为了惩戒作弊或言语辱骂等负面行为的玩家而实施的惩罚措施。游戏可以通过门户控制台或后端 HTTP API.来管理（添加/撤销）玩家惩罚。玩家惩罚具有截止时间，当到达截止时间时，处罚将自动解除。

2. 管理玩家惩罚​

要管理玩家惩罚，您需要登录 PGOS 网页控制台并前往玩家 > 查询：

image-20240914150918027

搜索您感兴趣的玩家,点击"玩家ID"查看玩家详情:

image-20240914151138689

点击"惩罚"选项卡来管理玩家惩罚：

image-20240914150403158

2.1 添加惩罚​

点击"添加新惩罚"按钮为玩家添加惩罚：

image-20240914151633222

字段说明：

  • 服务：选择您想要禁止玩家使用的服务。您可以同时选择多个服务。
  • 截止时间：选择何时解除此惩罚。
  • 原因：填写玩家受到惩罚的原因。当您调用相关服务的客户端 SDK API 时，会从错误信息中获取此字符串。
  • 额外数据：（可选）您想要存储的额外数据。当您调用后端 HTTP API QueryPlayersPunishItems. 时会获取此数据。

点击"提交"按钮使惩罚生效。

2.2 撤销惩罚​

如果您想提前结束对玩家的惩罚，可以在惩罚列表中点击"撤销"按钮：

image-20240914153649287

3. 在门户网站上查看日志​

如果您想查看玩家的惩罚日志，请如下图点击"日志"选项卡：

image-20240914154000403

4. 玩家的客户端SDK​

如果玩家在服务X中受到处罚，当玩家客户端调用服务X的客户端SDK接口时，将会收到服务错误kBackendPlayerIsPunished = 5000，错误信息将是一个包含处罚详情的json字符串，例如：

{
    "punished_reason": "verbally abusing others",
    "punished_deadline": "1726761600"
}

字段 punished_deadline 是以秒为单位的 Unix 时间戳。