易盾（网易）快速入门

易盾（网易） 为开发者提供游戏包体加固及游戏反外挂能力，开发者构建过程中自助完成SDK集成、构建完成后一键式进行包体加固，开发者无需再为游戏安全防护进行额外开发工作，可以专注于游戏业务，轻松搭建游戏防御体系。支持全平台：Android、iOS、H5。

版本更新说明（Cocos Creator 2.x）

  • 当前版本：0.5.2_5.0.4_1.7.1.3

    • 优化账号关联流程。

  • 0.5.2_5.0.4_1.7.1.3

    • 新增 网易易盾 服务。

版本更新说明（Cocos Creator 3.x）

  • 当前版本：2.1.0_5.0.4_1.7.1.3

    • 优化账号关联流程。

  • 2.0.0_5.0.4_1.7.1.3

    • 新增 网易易盾 服务。

一键接入易盾服务

开通服务

  • 使用 Cocos Creator 打开需要接入 易盾 服务的项目工程。

  • 点击菜单栏的 面板 -> 服务，打开 服务 面板，选择 易盾，进入服务详情页。然后点击右上方的 启用 按钮即可开通服务。详情可参考 服务面板操作指南。

  • 开通服务后，如果您的Cocos账号未关联易盾账号，面板会显示一个“关联易盾”按钮，如下：

  • 点击“关联易盾”按钮，会弹出对话框打开易盾关联页面，如下：

  • 点“同意并继续”后，可进行账号的登录/注册，如下：

  • 如果您还没有易盾账号，请点击“免费注册”按钮，填写相关信息以注册易盾账号，注册完后会自动登录；如果您已经有易盾账号了，请输入您已有的易盾账号及密码进行登录。登录完成后，会显示如下的授权页面：

  • 点击“确认授权”以完成授权操作，授权完成后，回到Cocos Creator中，点击下图中的“已完成关联”。

  • 完成与易盾账号的关联后，如果该账号下没有任何游戏，面板会显示创建游戏的页面，如下：

  • 请在填写完相关信息后，点击“创建游戏”以完成游戏的创建。游戏创建完成后，会显示完整的功能页面，如下：

  • 注1：构建时，切记填写的包名/bundle ID要和易盾账号的应用一致。
  • 注2：如需添加新的包名，请联系易盾团队。

创建其他平台的应用（可选）

  • 在易盾中， Android 和 iOS 是两个分开的应用，如需开通另外一个平台的应用，请点击“平台”下拉框，选中目标平台（比如“iOS”），如下：

  • 选中后，如果您没有目标平台的应用，会显示如下的创建应用页面：

  • 请填写相关信息，最后点“创建游戏”以创建该平台下的应用，如果不想创建，可以点“取消”以返回功能页面。

验证服务是否接入成功

游戏加固

在编译完游戏后，可进行游戏加固。

  • 首先，需要填写“保护文件”和“过滤文件”以告知易盾需要保护的文件有哪些，否则保护效果可能会下降，如下：

  • 接着，选中待加固的游戏包，如下：

  • 最后，点击“开始加固”以进行游戏加固（注：一定要在下拉框中选择正确的平台，再去加固，比如 APK 游戏包应该要选择 Android 平台的应用）。

  • 点击“开始加固”后，界面会显示加固进度，如下：

  • 加固成功后，会提示您是否要下载加固后的游戏包，选择是将会进行下载，您也可以在加固历史记录中点击某记录的“下载加固包”按钮以进行下载。

反外挂 SDK

如需要反外挂功能，请在加固之前集成 SDK 。

  • 首先，您需要勾选下图中的“SDK 集成”，如下：

  • 接着，点击“保存”按钮，如下：

  • 注意，勾选“SDK 集成”后，仅会在构建时自动集成 SDK ，您还需要手动调用 SDK 的接口以使用反外挂相关的功能（比如： SDK 的初始化）， SDK 集成说明，请参考：SDK 集成，API文档请参考：易盾 - Cocos Service API 文档。

  • 注：勾选“SDK 集成”， SDK 仅会在当前平台被集成，如果您需要在其他平台集成 SDK ，请切换到其他平台，然后勾选“SDK 集成”。

  • 完成以上步骤后，我们便可以通过在脚本中添加简单的代码，来验证 SDK 接入是否成功，如下：

// 初始化 SDK
netease.yidun.yidunService.init();
// 默认服务器地区类型是中国大陆，如果您应用所在地区不是中国大陆，
// 需要传递参数告知 SDK 具体的服务器地区类型，如下：
// netease.yidun.yidunService.init(netease.yidun.ServerType.Other);
// 其他 SDK 接口的使用请参考文档或者Sample工程。
  • 工程运行到手机后，首先在确认没有“appId不正确”之类的提示后，请您到易盾后台的“智能反外挂”板块下的“统计分析”页面，查看用户数量是否增加了。

Sample 工程

开发者可以通过 Sample 工程快速体验 易盾 服务。

  • 点击 易盾 服务面板中的 Sample 工程 按钮，克隆或下载 易盾 Sample 工程，并在 Cocos Creator 中打开。

  • 参照上文开通 易盾 服务并在相应平台下勾选“SDK 集成”后，可通过 Creator 编辑器菜单栏的 项目 -> 构建发布， 打开 构建发布 面板来构建编译工程。

  • Sample 工程运行到手机后，即可进入功能界面进行测试。

开发指南

完整的代码请参考 Sample 工程。

初始化SDK

首先，为了启用反外挂功能，我们需要初始化 SDK ，初始化 SDK 代码如下：

netease.yidun.yidunService.init();

默认情况下，服务器地区类型是中国大陆，如果您应用所在地区不是中国大陆，可以传递服务器地区类型给 init 接口，如下：

netease.yidun.yidunService.init(netease.yidun.ServerType.Other);

iOS 平台下，如果需要使用透传功能，需要传递透传服务器地址给 init 接口，如下：

netease.yidun.yidunService.init(netease.yidun.ServerType.ChineseMainland, 'https://www.netease163.com');

SDK的大部分反外挂功能是自动运行的，不需要调用额外的接口，但是有些功能是需要手动调用的（比如 setRoleInfo 接口），具体可以参考以下的例子以及 SDK 集成 和 易盾 - Cocos Service API 文档。

登录接口/设置角色信息

SDK 需要知道当前玩家的角色ID、角色名称等信息，才能将当前作弊行为和具体角色对应起来，给予相应的惩罚，您需要调用 setRoleInfo 接口以设置角色信息，示例代码如下：

const roleId = '123456';
const roleName = '易小盾';
const roleAccount = 'yd@163.com';
const roleServer = '游戏测试服';
const serverId = 123; // Only used on Android
const gameJson = {
  GameVersion: '1.0.1',
  AssetVersion: '1.0.1',
  TransHost: 'test.163.com',
  TransIP: '8.8.8.8',
  TransPort: 80,
};
netease.yidun.yidunService.setRoleInfo(
  roleId,
  roleName,
  roleAccount,
  roleServer,
  serverId,
  JSON.stringify(gameJson)
);
cc.log('setRoleInfo');
cc.log('roleId:' + roleId);
cc.log('roleName:' + roleName);
cc.log('roleAccount:' + roleAccount);
cc.log('roleServer:' + roleServer);
cc.log('serverId:' + serverId);
cc.log('gameJson:' + JSON.stringify(gameJson));

通用查询

ioctlAndroid 和 ioctlIos 接口分别提供了 Android 和 iOS 下的通用查询功能，如查询root、模拟器、版本号等信息以及其他定制功能，由于 Android 和 iOS 下支持的查询和功能不同，故分成两个接口，请您根据具体平台，调用不同的接口。

ioctlAndroid 示例代码如下：

let requestCmdId = netease.yidun.RequestCmdIdAndroid.GetEmulatorName;
cc.log('The name of the emulator:' + netease.yidun.yidunService.ioctlAndroid(requestCmdId, ''));

requestCmdId = netease.yidun.RequestCmdIdAndroid.IsRootDevice;
cc.log('Is root device:' + netease.yidun.yidunService.ioctlAndroid(requestCmdId, ''));

requestCmdId = netease.yidun.RequestCmdIdIos.QuerySDKVersion;
cc.log('SDK Version:' + netease.yidun.yidunService.ioctlIos(requestCmdId, ''));

ioctlIos 示例代码如下：

let requestCmdId = netease.yidun.RequestCmdIdIos.QueryRootStatus;
cc.log('Root status:' + netease.yidun.yidunService.ioctlIos(requestCmdId, ''));

requestCmdId = netease.yidun.RequestCmdIdIos.QuerySDKVersion;
cc.log('SDK Version:' + netease.yidun.yidunService.ioctlIos(requestCmdId, ''));

requestCmdId = netease.yidun.RequestCmdIdIos.QueryYiDunCode;
cc.log('Yidun Code:' + netease.yidun.yidunService.ioctlIos(requestCmdId, ''));

其他 API

关于其他API的使用，请参考文档和 Sample 工程。

API 文档

详细的 API 说明，请参考 SDK 集成 以及 易盾 - Cocos Service API 文档。

iOS 平台注意事项

请在Xcode中编译项目

如果您构建的目标平台是 iOS 且勾选了“SDK 集成” ，则在构建完成后，不要直接点击编译，您需要用 Xcode 打开生成的 Xcode 项目，在 Xcode 中继续编译本项目，否则编译会失败（这是因为在 Cocos Creator 中点击编译，默认会编译模拟器的架构，一般这是 x86_64 架构，而易盾SDK暂不支持 x86_64 架构）。

针对Cocos Creator 2.x，生成的 Xcode 项目的路径一般是 {您的项目所在目录}/build/jsb-link/frameworks/runtime-src/proj.ios_mac/{游戏名称}.xcodeproj。

针对Cocos Creator 3.x，生成的 Xcode 工作空间的路径一般是 {您的项目所在目录}/build/{构建任务名}/proj/{游戏名称}.xcodeproj。

iOS 游戏加固需要开启 bitcode 、SDK 集成 不能开启 bitcode 的问题

如果您构建的目标平台是 iOS ，您需要注意： SDK 的集成需要禁用 bitcode 构建选项（默认是禁用的），而 iOS 游戏加固功能是需要启用 bitcode 构建选项的（需要在 Xcode 中开启），这两个是冲突的需求，且目前 Cocos Creator 暂时不支持开启 bitcode 编译，编译会失败（有些依赖库编译时没有包括 bitcode ），故目前暂时不支持 iOS 游戏的加固，但 SDK 的功能可以正常使用。

results matching ""

    No results matching ""