反作弊功能接入检查清单

产品上线前,请确保产品能够参照此检查清单正确运行反作弊接口。

阅读时间3分钟

反作弊接口 要求SDK为1.12或更高版本。反作弊接口客户端接口支持Windows、Mac和Linux平台,并且需要64位操作系统。

你应该使用这些核对清单来验证反作弊接口的集成以及你的游戏在发布之前可以正常工作。

服务安装程序(Windows)

1. 通过完全清除全部现有的轻松反作弊(Easy Anti-Cheat)安装,重置测试系统的环境。使用命令行参数 qa-factory-reset 来运行 EasyAntiCheat_EOS_Setup.exe 即可完成此清除。

如果玩家从未在系统上玩过任何受轻松反作弊保护的游戏,这可以确保你的测试系统与玩家的系统具有相同的状态。如果安装了其他受轻松反作弊保护的游戏,那么在完成此操作后,需要修复或重新安装这些游戏。

成功条件:

  • 命令 sc query EasyAntiCheat_EOS 报告指定的服务不再作为已安装的服务存在。
  • 以下位置不存在注册表键:HKLM\Software\Wow6432Node\EasyAntiCheat_EOS\

2. 像玩家那样安装游戏,例如使用Epic Games商店、Steam等。

成功条件:

  • 使用管理员权限执行 EasyAntiCheat_EOS_Setup,该命令将以 0 状态关闭并退出。
  • 命令 sc query EasyAntiCheat_EOS 报告服务存在并在游戏未运行时处于 STOPPED 状态。

3. 卸载游戏

成功条件:

  • 执行 EasyAntiCheat_EOS_Setup 来卸载轻松反作弊服务。
  • 命令 sc query EasyAntiCheat_EOS 报告指定的服务不再作为已安装的服务存在。

游戏客户端和反作弊启动加载器

1. 转到 开发人员门户(Developer Portal) > 你的产品(Your Product) > 游戏服务(Game Services) > 反作弊(Anti-Cheat) > 配置(Configure)。选择 全部启用(Enable All) ,然后点击 保存更改(Save Changes)

成功条件:

  • 在刷新反作弊页面之后,客户端保护(Client Protection)服务器踢出(Server Kicks) 保持启用。

2. 在没有反作弊启动加载器的情况下启动游戏。

成功条件:

  • 你的游戏可能会正常运行,或者可能会显示一段警告/错误消息(如果你选择此选项的话)。

    EOS_Platform_GetAntiCheatClientInterface 会在有人启动了游戏但没使用反作弊启动加载器时返回nullptr。你可以将其用于确定何时显示警告/错误消息。

  • 但是,玩家应该无法加入其他玩家的受保护多玩家游戏会话。反作弊身份验证应该失败,并显示相应的消息。

3. 在具有反作弊启动加载器的情况下启动游戏。

成功条件:

  • 你的游戏应该正常运行。
  • 玩家应该能够成功加入其他玩家的受保护多玩家游戏会话,并且能够保持连接状态超过10分钟。
  • 玩家应该能够从一个受保护的多玩家游戏会话断开连接并成功加入另一个。

如果你遇到了任何错误,请查看反作弊文档的 常见错误 部分,了解故障排查错误。

4. 转到 开发人员门户(Developer Portal) > 你的产品(Your Product) > 游戏服务(Game Services) > 反作弊(Anti-Cheat) > 配置(Configure)。选择 仅启用客户端保护(Enable Client Protection Only) ,然后点击 保存更改(Save Changes)

成功条件:

  • 在刷新反作弊页面之后,客户端保护(Client Protection) 保持启用。

5. 将环境变量 EOS_USE_ANTICHEATCLIENTNULL 设置为 1 ,然后在没有反作弊启动加载器的情况下启动游戏。在该测试步骤完成后,删除该环境变量。

成功条件:

  • 你的游戏应该正常运行。
  • 玩家应该能够成功加入其他玩家的受保护多玩家游戏会话,并且能够保持连接状态超过10分钟。
  • 玩家应该能够从一个受保护的多玩家游戏会话断开连接并成功加入另一个。

6. 在具有反作弊启动加载器的情况下启动游戏。

成功条件:

  • 你的游戏应该正常运行。
  • 玩家应该能够成功加入其他玩家的受保护多玩家游戏会话,并且能够保持连接状态超过10分钟。
  • 玩家应该能够从一个受保护的多玩家游戏会话断开连接并成功加入另一个。

7. 转到 开发人员门户(Developer Portal) > 你的产品(Your Product) > 游戏服务(Game Services) > 反作弊(Anti-Cheat) > 配置(Configure)。选择 全部禁用(Disable All) ,然后点击 保存更改(Save Changes)

成功条件:

  • 在刷新反作弊页面之后,客户端保护(Client Protection)服务器踢出(Server Kicks) 保持禁用。

8. 在具有反作弊启动加载器的情况下启动游戏。

成功条件:

  • 你的游戏应该正常运行。
  • 对于Windows) 当游戏正在运行时,命令 sc query EasyAntiCheat_EOS 报告服务处于STOPPED状态。
  • 玩家应该能够成功加入其他玩家的受保护多玩家游戏会话,并且能够保持连接状态超过10分钟。
  • 玩家应该能够从一个受保护的多玩家游戏会话断开连接并成功加入另一个。

9. 转到 开发人员门户(Developer Portal) > 你的产品(Your Product) > 游戏服务(Game Services) > 反作弊(Anti-Cheat) > 配置(Configure)。选择 全部启用(Enable All),启用 强制启用服务器踢出(Force Enable Server Kicks),然后点击 保存更改(Save Changes)

成功条件:

  • 在刷新反作弊页面之后,客户端保护(Client Protection)服务器踢出(Server Kicks) 保持启用。