(2) 添加头文件，引入NTESRiskSecProtect.cs

using NTESHTPSec;

部分产品相关参数请用账号登陆易盾官网控制台获取参考

SDK 接入调用说明

SDK 初始化接口（init）

接口用途：

用于初始化智能风控 SDK。

接入须知：

• 使用其他接口之前，必须先调用初始化接口，建议在应用/游戏启动过后第一时间调用（初始化后，并不会获取任何个人隐私相关信息）；

• 该接口为 必须调用接口。

函数原型：

public static void init(string productId, InitCallback callback);

参数说明：

配置信息设置：

(1) 设置服务器归属地

public static void setServerType(int serverType);

智能风控默认上报的服务器为中国大陆的服务器，若需要更改服务器归属地，可以调用该接口进行配置，支持的类型如下：

(2) 设置渠道信息

public static void setChannel(string channel)

若需要传递当前应用包体来源渠道可调用该接口（比如：App Store CN/App Store EU）。

(3) 设置额外数据

public static void setExtraData(string key, string value)

若需要客户端传递额外信息给易盾，可调用该接口，支持多次调用，但必须在 init 之前设置。

(4) 设置私有化地址

public static void setHost(const char *host)

私有化的客户需要通过该接口设置服务器地址，其他客户可以忽略。

参数说明

• 配置域名的，只需填写域名即可，SDK会自动加上前缀“https://”，举例如下所示：

NTESRiskSecProtect.setHost("xxxxx.xxxx.xxxx");

• 配置ip和端口的，举例如下所示：

NTESRiskSecProtect.setHost("xx.xx.xx.xx:xxx");

回调接口：

[MonoPInvokeCallback(typeof(NTESRiskSecProtect.InitCallback))]
public static void initProductIdCallback(int code, string msg, string content)
{
   // 如果code == 200，说明初始化成功
   // 如果code == 199，说明初始化参数错误，如productId不合法或者过期
   // 如果code == 400，请将 content 发送到贵方服务端，由贵方服务端通过[getConfig接口[配置下发接口](https://support.dun.163.com/documents/761315885761396736?docId=771983453572567040)](https://support.dun.163.com/documents/761315885761396736?docId=771983453572567040)转发给易盾服务端，由易盾服务端响应
   // 易盾服务端返回结果，再将结果通过 通用查询接口(Cmd_SetConfigData) 反馈给智能风控sdk
   // configData为易盾服务端返回的数据
   string ret = NTESRiskSecProtect.ioctl(RequestCmdID.Cmd_SetConfigData, configData);
}

如需要示例 demo 请联系易盾获取。

示例代码：

using UnityEngine;
using System;
using System.Runtime.InteropServices;
using AOT;
using System.Text;
using NTESHTPSec;

public class Test : MonoBehaviour
{
    private const string ProductId = "易盾提供的产品id";
    void Start()
    {

#if UNITY_IPHONE || UNITY_IOS
        if (Application.platform == RuntimePlatform.IPhonePlayer)
        {
	          // 额外信息，反作弊接口需要，可不设置
            NTESRiskSecProtect.setExtraData("GameVersion", "1.0.0");
          	NTESRiskSecProtect.setExtraData("AssetVersion", "1.0.0");
	          // 渠道
	          NTESRiskSecProtect.setChannel("App Store CN");
          	NTESRiskSecProtect.setHost("");//非私有化部署不需要配置
  	        // 服务器所在地址，1:中国大陆，2:中国台湾地区，3:其他地区
	          NTESRiskSecProtect.setServerType(1);
            NTESRiskSecProtect.InitCallback initCallback = new NTESRiskSecProtect.InitCallback(initProductIdCallback);
            NTESRiskSecProtect.init(ProductId, initCallback);
        }
#endif

    }
    [MonoPInvokeCallback(typeof(NTESRiskSecProtect.InitCallback))]
    public static void initProductIdCallback(int code, string msg, string content)
    {
    	    // code返回200说明初始化成功
    }
}

设置角色信息接口（setRoleInfo）

接口用途：

游戏类型应用，在进行数据采集的过程中，会将角色 ID，角色名称、用户/角色账号等设置在风控 SDK 采集的数据中一同上传，用于表示角色信息，以便对有恶意、风险行为的用户/角色进行相应的处置。

接口须知：

• 须在 SDK 初始化且 用户同意隐私政策后才能调用该接口；

• 凡是涉及到用户登录、或者切换角色的地方，均需要调用该接口设置或者更新用户/玩家信息；

函数原型：

public static int setRoleInfo(string businessId, string roleId, string roleName, string roleAccount, string roleServer, int serverid, string gameJson);

参数说明：

gameJson 字段说明：

返回值：

示例代码：

int ret = NTESRiskSecProtect.setRoleInfo("易盾提供的业务id", "123456", "易小盾","yd@163.com", "游戏测试服", 123, "");

登出接口（logOut）

接口用途：

为了更好的统计该用户/玩家角色在本次登录后的行为，精准标识和打击有恶意行为的用户/玩家。

接入须知：

• 须在 设置用户信息接口被调用后方可调用，在用户/玩家退出当前角色（包括切换角色）或者退出游戏时调用接口。

• 此接口主要用于判断用户/玩家本次生命周期，不强制要求接入。

• 如果未调用初始化，此接口默认为空，不会执行任何逻辑。

函数原型：

public static void logOut();

示例代码：

NTESRiskSecProtect.logOut();

同步获取凭证（getToken）

接口用途：

用于关键业务节点风险防控场景中，比如注册、登录、领券、抽卡、兑换、点赞、评论等业务场景。业务方可通过此接口，获取检测唯一凭证 token。业务服务端通过此凭证实时获取当前用户/玩家风险检测结果，并根据结果进行处置。

接口适用场景为:
1、游戏类应用，当 SDK 数据上报接口被屏蔽导致数据上报失败时，通过 getToken 接口获取 SDK 采集信息，并由客户服务端传递给易盾服务器；
2、全类型应用，在关键业务节点主动调用检测时，通过 getToken 接口获取检测凭证，由客户服务端通过 token 凭证从易盾服务器查询检测结果。

接入须知：

• 须在 SDK 初始化且用户同意隐私政策后才能调用该接口，网易易盾隐私说明。

• 内部存在网络请求，只允许在子线程上调用。

• 返回值AntiCheatResult中token的使用方法请参考“后端接入-智能风控数据服务接口-在线检测接口”。

函数原型：

public static AntiCheatResult getToken(int timeout, string businessId);

参数说明：

返回值：

AntiCheatResult类说明：

	public class AntiCheatResult
	{
		public int code;
		public string codeStr;
		public string token;
		public string businessId;
	}

AntiCheatResult变量说明：

示例代码：

AntiCheatResult result = NTESRiskSecProtect.getToken(3000, LoginBusinessID);
Debug.Log("token code:" + result.code);
Debug.Log("token:" + result.token);

异步获取凭证（getTokenAsync）

接口用途：

同 同步获取凭证。

接入须知：

• 须在 SDK 初始化且用户同意隐私政策后才能调用该接口，网易易盾隐私说明。
• 在主线程调用，回调也在主线程。
• 返回值AntiCheatResult中token的使用方法请参考“后端接入-智能风控数据服务接口-在线检测接口”。

函数原型：

public static void getTokenAsync(int timeout, String businessId, getTokenAysncBlock callback);

参数说明：

getTokenAysncBlock说明：

public delegate void getTokenAysncBlock(AntiCheatResult result);

AntiCheatResult类说明：

public class AntiCheatResult
{
	public int code;
	public string codeStr;
	public string token;
	public string businessId;
}

AntiCheatResult变量说明：

示例代码：

[MonoPInvokeCallback(typeof(NTESRiskSecProtect.getTokenAysncBlock))]
public static void getTokenAction1(AntiCheatResult result) 
{
    Debug.Log("token：" + result.code + "codeStr：" + result.codeStr + "token数据:" + result.token + "businessID:" + result.businessId);
}

NTESRiskSecProtect.getTokenAysncBlock render = new NTESRiskSecProtect.getTokenAysncBlock(getTokenAction1);
NTESRiskSecProtect.getTokenAsync(3000, "易盾提供的业务id", render);

交互接口（ioctl）

接口用途：

用于在客户端查询 SDK 采集的基础数据、设置需要传递给 SDK 数据（比如初始化配置内容、check 结果信息等）、及其他可能的定制功能服务。

接入须知：

接口调用前置条件是：调用了初始化接口以及同意隐私政策之后。

函数原型：

public static string ioctl(RequestCmdID request, string data);

参数说明：

request值说明：

public enum RequestCmdID
{
  // 初始化配置内容，防止初始化失败情况下，客户可以通过服务端请求初始化配置并传递给SDK
	Cmd_SetConfigData = 16,
	// 客户服务端将check结果传递给SDK，便于执行后续动作
	Cmd_SetResponseData = 17,
  // 获取服务端设备指纹
  Cmd_GetDeviceId = 20,
};

返回值：

错误的情况下，返回：unsupported request（不支持的命令）；正确的情况下，返回对应命令的结果。

注意：该接口的返回值类型均为String，对返回值做判断的时候需要注意该值的类型。

不同命令设置方法：

(1) 设置配置信息

向风控 SDK 配置传递从易盾服务器获取到的产品的配置信息（主要适用于风控 SDK 因被黑灰产屏蔽或其他原因导致无法正常获取配置信息的情况）。

示例代码：

NTESRiskSecProtect.InitCallback initCallback = new NTESRiskSecProtect.InitCallback(initProductIdCallback);
NTESRiskSecProtect.init(ProductId, initCallback);

[MonoPInvokeCallback(typeof(NTESRiskSecProtect.InitCallback))]
public static void initProductIdCallback(int code, string msg, string content)
{
	// code返回200说明初始化成功
	if (code != 200) {
		// 从易盾服务器获取到的产品的配置信息
		...
    // 如果入参为null或空，则表示查询当前内存中配置版本；如果参数不为空，则表示更新初始化配置
		string configData = "配置信息";
		string ret = NTESRiskSecProtect.ioctl(RequestCmdID.Cmd_SetConfigData, configData);
	}
}

返回值： 返回值为字符串格式的JSON数据：

// s：状态，int类型，只有为0，v 字段的值才有意义;
// v：版本，long类型(8字节)，配置的版本
{"s":0, "v":1130000000003212}

(2) 设置响应信息

向风控 SDK 配置传递从易盾服务端获取到的命中及响应结果信息，以便 SDK 执行相关处置动作（主要适用于风控 SDK 因被黑灰产屏蔽或其他原因导致无法正常获取响应结果的情况）。

示例代码：

string sdkRespData = "从易盾服务端获取到的命中及响应结果信息";
string ret = NTESRiskSecProtect.ioctl(RequestCmdID.Cmd_SetResponseData, sdkRespData);

返回值： 返回值为字符串格式：

(3) 获取服务端设备指纹

获取服务端设备指纹，需要在风控后台配置相关配置，请联系技术支持。

示例代码：

string fp = NTESRiskSecProtect.ioctl(RequestCmdID.Cmd_GetDeviceId, "");

返回值： 返回值为字符串格式

注意：除以下返回值外，返回为加密后的设备指纹，需要通过上传至服务端进行解密。

安全通信协议接口

接口用途：

该接口用于对通信数据进行白盒加密和白盒 HMAC 签名，加密和签名的密钥均会被隐藏，攻击者无法获取，从而保障应用/游戏的通信安全。

最新版本接口（V2）更新内容如下：

• 自定义二进制格式，增大分析难度；
• 多重加密，防明文传输；
• 数据将进行校验，防止篡改；
• 支持多算法，一旦加密算法被破解，可及时更新为另一种算法；
• 一次一密，每次加密的密钥都不相同；
• 自定义安全随机数发生器，防止系统随机数接口被篡改，始终生成一样的密钥；
• 防重放攻击；
• 防模拟执行(脱离Android/iOS环境运行)。

接口须知：

• 如需使用该接口，请联系易盾技术支持获取详细说明文档。

模拟点击AI识别

接口用途：

批量的模拟点击极大的影响到游戏的正常运营，特别是工作室的参与，不仅影响到游戏的平台，还影响到游戏方的收入。易盾智能反外挂SDK提供相关的行为检测方案，使用模拟点击行为检测接口时，需要在游戏登录后，并且调用设置用户信息接口，设置roleId等信息后调用。

接口须知：

请在作弊情况较严重的玩法和场景下调用registerTouchEvent和unregisterTouchEvent，开启和关闭点击数据的采集，初次接入建议设置一个玩法和场景id，并同步给易盾，如需接入多个玩法和场景需提前与易盾沟通。 开启registerTouchEvent后，在该场景结束后必须调用unregisterTouchEvent关闭检测逻辑。

（1）开启采集数据

函数原型：

public static void registerTouchEvent(ulong gameplayId, ulong sceneId);

函数说明

调用该接口后，开始采集点击事件的相关数据。

参数说明：

示例代码：

NTESRiskSecProtect.registerTouchEvent(1, 3);

（2）关闭数据采集

函数原型：

public static void unregisterTouchEvent();

函数说明

取消点击事件数据采集。

示例代码：

NTESRiskSecProtect.unregisterTouchEvent();