Help Center

C++接入教程

2023.06.06 17:09:57

隐私说明

请参照网易易盾隐私政策，请将易盾隐私政策链接放到应用“用户协议”中。

接入说明

接入“智能风控” SDK，开发者需要完成以下步骤：

1. 根据应用/游戏开发平台，将SDK拷贝到指定的工程目录，并修改项目配置；
2. 接入风控SDK必接接口，根据业务需求接入建议接口；
3. 测试风控SDK接入是否正确；
4. 验证风控SDK功能效果；
5. 按业务常规发版流程进行测试与发版

游戏必须接入：

全局必须要接入的接口：初始化接口
游戏类型应用反外挂场景业务必须要接入的接口：设置用户信息接口
选择角色进入游戏后，接入该接口完成数据透传：同步获取凭证/异步获取凭证

建议接入：

获取风控基础信息：交互接口
校验风控状态/获取风控详细信息：心跳接口
协议保护/防脱机:安全通信协议接口
本地存档保护:本地数据加解密接口

接入步骤

SDK 涉及到以下文件：

nethtprotect.jar
libNetHTProtect.so
assets/motion/xxx.so
htp_agent.h
htp_sdk.cpp
htp_sdk.h

注意：

打包出来的 apk，必须包含 lib/xxx/libNetHTProtect.so 与 assets/motion/ 下的所有so文件。

引入jar

在工程内添加对nethtprotect.jar的依赖

引入so

在 android 工程加载游戏 so 的地方，添加对libNetHTProtect.so 的引用。

public class Game {
    static {
        System.loadLibrary("NetHTProtect");
        System.loadLibrary("game");
    }
}

注意：libNetHTProtect.so的加载顺序，需要在游戏自己的 so 之前。

引入htp_sdk

将 htp_agent.h htp_sdk.h htp_sdk.cpp 导入到项目中，在需要使用反外挂sdk函数的cpp中，引入 htp_sdk.h 头文件

链接so

在 jni/android.mk 中添加如下代码，用于链接libNetHTProtect.so

include $(CLEAR_VARS)
LOCAL_MODULE := libNetHTProtect
LOCAL_SRC_FILES := $(TARGET_ARCH_ABI)/libNetHTProtect.so
include $(PREBUILT_SHARED_LIBRARY)

在 jni/Android.mk 中，游戏所在 so 节，添加如下代码，用于指示对 libNetHTProtect 的引用

LOCAL_SHARED_LIBRARIES += libNetHTProtect

添加权限信息

SDK 不会申请任何权限，但是为了提升风控的效果，建议在 AndroidMenifest.xml 文件中添加下列权限配置：

    <!--网络通信-->
    <uses-permission android:name="android.permission.INTERNET"/>
    <!--获取设备信息-->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <!--获取MAC地址-->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    <!--获取网络状态-->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <!--若targetSdkVersion>=30，则需要增加以下权限，否则会影响SDK功能-->
    <queries>
        <intent>
            <action android:name="android.intent.action.MAIN"/>
        </intent>
    </queries>

添加 ProGuard 配置

若使用 ProGuard 进行混淆，需要将 SDK 使用的类排除掉。若使用 Android Studio 开发，则在 proguard-rules.pro 文件中添加如下信息：

 -keep class com.netease.htprotect.**{*;}

SDK 接入调用说明

SDK 初始化接口（init）

接口用途：

用于初始化智能风控 SDK。

接入须知：

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

函数原型：

void htp_init(const char *productid, const GameSetInfo &info, CallBack cb);

参数说明：

参数	说明	必要性
productId	易盾HTP分配的productId，可登录易盾后台获取	必填
info	与HTP相关的一些配置信息	可选，不需要可填null
cb	初始化是否成功的回调	可选，不需要可填null

GameSetInfo结构体

struct GameSetInfo {
    std::string game_key;            //由易盾分配
    int server_type;                 //服务端所属地区
    std::string channel;             //渠道信息
    std::map<std::string ,std::string> ext_data;            //额外数据
}

字段	说明
game_key	由易盾分配gameKey，可登录易盾后台获取。数据校验，存档加解密和心跳系统必须设置此值，如果不使用这三个功能，可不设置或置空
server_type	服务器归属地，反外挂默认上报的服务器为中国大陆，若需要更改服务器归属地，可以调用该接口进行配置，支持的类型如下：1：中国大陆地区，默认即为该值，无须设置；2：中国台湾地区；3：海外地区
channel	渠道信息
ext_data	额外数据，作弊监控接口需要，可设置一些额外信息，必须在init之前设置

示例

GameSetInfo info;
info.server_type = 1; // 服务器所在地址，1：中国大陆，2：中国台湾地区，3：其他地区，4：欧盟地区
info.channel = "testchannel"; // 渠道
info.game_key = "fed80c732b7b467ea2156c29f830eed24fc8"; // 易盾HTP分配的gameKey
std::map<std::string, std::string> ext_data;
ext_data["c"] = "1";
ext_data["e"] = "11Y=";
ext_data["i"] = "222";
info.ext_data = ext_data; // 额外信息，反作弊接口需要，可不设置

CallBack回调

CallBack为一个函数指针，定义如下

typedef int(*CallBack)(int, const char*);

在使用时，需自己实现一个相同参数的函数，比如

/**
 * 初始化的回调接口
 * @param code 回调接口返回的错误码
 * @param msg 回调接口返回的信息
 * @return
 */
int htp_init_callback(int code, const char* msg) {
    LOGD("code = %d msg = %s", code, msg);
    // 如果code == 200，说明反外挂一切正常
    // 如果code == 400，请将 msg发送到贵方服务端，由贵方服务端通过[getConfig接口](https://support.dun.163.com/documents/761315885761396736?docId=771983453572567040)转发给易盾服务端，由易盾服务端响应
    // 易盾服务端返回结果，再将结果通过 通用查询接口(Cmd_SetConfigData) 反馈给反外挂sdk
    // char *config_buf = nullptr;
    // size_t config_buf_size = 0;
    // htp_ioctl(Cmd_SetConfigData, configData, config_buf, &config_buf_size); configData为易盾服务端返回的数据
    // SAFEFREE(config_buf)
    return 0;
}

示例代码

/**
 * htp防剥离线程，验证反外挂是否已经正常启动，建议在初始化完成之后，立马调用
 * 可简单判断反外挂是否正常启动，接入简单，如果依然被剥离，建议接入心跳或透传服务
 */
void *check_htp_alive_thread(void *arg) {
    sleep(60);
    if (!htp_check_alive()) {
        // 反外挂已被剥离
        LOGD("error htp is not alive");
    } else {
        // 反外挂正常
        LOGD("htp is alive");
    }
    return nullptr;
}

void my_htp_init() {
	GameSetInfo info;
    info.server_type = 1; // 服务器所在地址，1：中国大陆，2：中国台湾地区，3：其他地区，4：欧盟地区
    info.channel = "testchannel"; // 渠道
    info.game_key = "fed80c732b7b467ea2156c29f830eed24fc8"; // 易盾HTP分配gameKey，与手游加固的appKey对应，gameKey可登录易盾后台获取(如果没有调用数据校验(getDataSign)接口，此值可以为空或者不设置)
    std::map<std::string, std::string> ext_data;
    ext_data["c"] = "1";
    ext_data["e"] = "11Y=";
    ext_data["i"] = "222";
    info.ext_data = ext_data; // 额外信息，反作弊接口需要，可不设置
    htp_init(appid, info, htp_init_callback);
    // 初始化结束之后，立马启动htp防剥离线程
    pthread_t t;
    pthread_create(&t, nullptr, check_htp_alive_thread, nullptr);
}

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

设置用户信息接口（setRoleInfo）

接口用途：

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

接口须知：

须在 SDK 初始化且 用户同意隐私政策后才能调用该接口；
凡是涉及到用户登录、或者切换角色的地方，均需要调用该接口设置或者更新用户/玩家信息；

函数原型：

int htp_set_role_info(const char *business_id, const char *role_id, const char *role_name, const char *role_account,
                       const char *role_server, int server_id, const char *game_json);

参数说明：

参数	说明	必要性
business_id	当前业务 ID	必填
role_id	用户/玩家的角色 ID	必填
role_name	用户/玩家的角色名称	可选，不需要可填null
role_account	用户/玩家的账号必填	必填
role_server	用户/玩家的角色的服务器名称	可选，不需要可填null
server_id	用户/玩家的角色所属服务器的 ID	可选，不需要请传入-1
game_json	游戏类型应用需要上传的信息，对应一个 json 字符串	可选，不需要可填null

game_json字段说明：

key 名称	key 类型	key 值	必要性	说明
游戏版本号	String	GameVersion	可选，不需要可填null	游戏版本号
资源文件版本	String	AssetVersion	可选，不需要可填null	游戏类型应用的资源文件版本号

示例代码：

htp_set_role_info(HTP_BUSINESS_ID, "123456","易小盾","yd@163.com", "游戏测试服",1,"");

登出接口（logOut）

接口用途：

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

接入须知：

须在设置用户信息接口接口被调用后方可调用，在用户/玩家退出当前角色（包括切换角色）或者退出游戏时调用接口。
此接口主要用于判断用户/玩家本次生命周期，不强制要求接入。
如果未调用初始化，此接口默认为空，不会执行任何逻辑。

函数原型：

void htp_logout();

示例代码：

htp_logout();

同步获取凭证（getToken）

接口用途：

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

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

接入须知：

须在 SDK 初始化且用户同意隐私政策后才能调用该接口，网易易盾隐私说明。
内部存在网络请求，只允许在子线程上调用。

函数原型：

int htp_get_anti_cheat_token(const char *businessId, char **out, size_t *out_len);

参数说明：

参数	说明	必要性
businessId	业务 ID	必填，由易盾后台分配，并在官网“服务管理”中查询
out	token的值	出参，token
out_len	token的长度	出参，token的长度

返回值：

值	说明
200	成功，当out不再使用时，需手动释放内存
-201	未初始化
-203	businessId不合法
-204	生成token出错
-205	参数错误，比如 out 或 out_len指针为NULL

示例代码

/*
 * 反作弊getToken线程
 */
void *anti_cheat_token_thread(void *arg) {
    char *token = nullptr;
    size_t token_len = 0;
    int ret = get_anti_cheat_token(appid, &token, &token_len);
    LOGD("ret = %d", ret);
    LOGD("token = %s", token);
    return nullptr;
}

void start_get_token() {
    pthread_t t;
    pthread_create(&t, nullptr, anti_cheat_token_thread, nullptr);
}

交互接口（ioctl）

接口用途：

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

接入须知：

接口调用前置条件是：调用了设置用户信息接口，并且设置了roleId等信息。

函数原型：

int htp_ioctl(int request, const char *data, /*[out]*/char **buf, /*[out]*/size_t *buf_size);

参数说明：

参数	说明
request	对应向风控系统请求的命令
data	设置信息的附加数据
buf	返回数据buffer
buf_size	实际使用的buffuer大小

request值说明：

enum RequestCmdID
{
    //模拟器名称
    Cmd_GetEmulatorName = 1,
    
    //是否root
    Cmd_IsRootDevice = 2,
    
    //本地随机生成的设备ID（不是服务端生成的唯一设备ID）
    Cmd_DeviceID = 3,
    
    //当前SDK版本
    Cmd_GetHTPVersion = 7,
    
    //加密后的当前SDK版本
    Cmd_GetEncHTPVersion = 9,
    
    //SDK运行状态，应对线程被挂起或其他导致无法运行时但是接口正常使用的状态
    Cmd_GetHtpStatus = 14,
    
    //初始化配置内容，防止初始化失败情况下，客户可以通过服务端请求初始化配置并传递给SDK
    Cmd_SetConfigData = 16,
    
    //客户服务端将check结果传递给SDK，便于执行后续动作
    Cmd_SetResponseData = 17
};

返回值：

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

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

不同命令设置方法：

(1) 模拟器信息

向风控 SDK 查询模拟器信息。

示例代码：

// 获取模拟器名称
char *emu_buf = nullptr;
size_t emu_buf_size = 0;
int emu = htp_ioctl(Cmd_GetEmulatorName, nullptr, &emu_buf, &emu_buf_size);
if(emu == 1) {
    LOGD("Emulator name:%s", emu_buf);
    // 这里需要主动释放内存
    SAFEFREE(emu_buf)
}

返回值： 对应查询的模拟器信息。若为已知模拟器，则返回模拟器名称，示例：emulator：Nox；若为未知模拟器，则返回：emulator：Unknown；若为真机，则返回：emulator：None。

(2) root信息

向风控 SDK 查询设备是否root。

示例代码：

// 是否root
char *root_buf = nullptr;
size_t root_buf_size = 0;
int root = htp_ioctl(Cmd_IsRootDevice, nullptr, &root_buf, &root_buf_size);
if(root == 1) {
    LOGD("root:%s", root_buf);
    SAFEFREE(root_buf)
}

返回值： 当前设备是否root信息。若为root设备，返回值为：root：1；若不是root设备，返回值为：root：0。

(2) 本地设备id

向风控 SDK 查询本地设备id

示例代码：

// 本地设备id
char *device_buf = nullptr;
size_t device_buf_size = 0;
int device = htp_ioctl(Cmd_DeviceID, nullptr, &device_buf, &device_buf_size);
if(device == 1) {
    LOGD("device:%s", device_buf);
    SAFEFREE(device_buf)
}

返回值： 本地设备id，比如，c09cb89662e6719f956f23651be42006

(4) 风控 SDK 版本号信息

向风控 SDK 查询当前风控 SDK 版本号，便于掌握每个玩家当前使用的游戏的风控 SDK 版本。

示例代码：

// 反外挂版本号，未加密
char *htpver_buf = nullptr;
size_t htpver_buf_size = 0;
int htpver = htp_ioctl(Cmd_GetHTPVersion, nullptr, &htpver_buf, &htpver_buf_size);
if(htpver == 1) {
    LOGD("htpversion:%s", htpver_buf);
    SAFEFREE(htpver_buf)
}

返回值： 风控 SDK 版本号一定不为空，返回值示例：“5.3.0”。若要获取加密后的版本号，可传入参数 “Cmd_GetEncHTPVersion”。

(5) 加密后的风控 SDK 版本号信息

向风控 SDK 查询当前风控 SDK 加密后的版本号。

示例代码：

char *enc_htpver_buf = nullptr;
size_t enc_htpver_buf_size = 0;
int enc_htpver = htp_ioctl(Cmd_GetEncHTPVersion, nullptr, &enc_htpver_buf, &enc_htpver_buf_size);
if(enc_htpver == 1) {
    LOGD("enc version:%s", enc_htpver_buf);
    SAFEFREE(enc_htpver_buf)
}

返回值： 风控 SDK 版本号一定不为空，返回值示例：“iF13uXaKVteXVA==||58807f98da0d945b5d60ba4e8f22a428”。

注意：返回值需要使用易盾提供的服务端解密sdk进行解密。

(6) 风控 SDK 运行状态信息

向风控 SDK 查询当前风控 SDK 运行状态信息，可用于判断当前环境风险度，可多次循环获取。

示例代码：

// 反外挂运行状态
char *htp_alive_buf= nullptr;
size_t htp_alive_buf_size = 0;
int htp_alive_status = htp_ioctl(Cmd_GetHtpStatus, nullptr, &htp_alive_buf, &htp_alive_buf_size);
if (htp_alive_status == 1) {
    LOGD("htp status = %s", htp_alive_buf);
    SAFEFREE(htp_alive_buf)
}

返回值： 状态码一定不为空，返回值有以下三个值：

返回值	说明
-1	风控 SDK 未启动
0	风控 SDK 运行正常
大于0	风控 SDK 运行有异常

(7) 设置配置信息

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

配置信息：

初始化接口需设置callback

如果callback的code返回400，将msg发送到服务端，再发送到易盾服务端

易盾服务端的返回结果即为配置信息

示例代码：

char *config_buf = nullptr;
size_t config_buf_size = 0;
htp_ioctl(Cmd_SetConfigData, responseData, config_buf, &config_buf_size); responseData为易盾服务端返回的数据
SAFEFREE(config_buf);
//如果入参为null或空，则表示查询当前内存中配置版本；如果参数不为空，则表示更新初始化配置

返回值： 返回值为一个json：

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

返回值	说明
s	0:成功 -1:内存配置加载失败
v	配置的版本号

(8) 设置响应信息

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

响应结果信息：

调用获取凭证(getToken)接口，获取token

将token发送到服务端，在服务端调用check接口，获取结果，其中的 sdkRespData 即为响应结果信息。

示例代码：

char *data1 = nullptr;
size_t data1_size = 0;
htp_ioctl(Cmd_SetResponseData, response, &data, &data1_size);
SAFEFREE(data)
SAFEFREE(data1)

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

返回值	说明
0或者-1	输入数据格式有误
1	解析成功

心跳接口（registInfoReceiver）

接口用途：

为保障风控 SDK 服务的安全运行，防止易盾风控服务被中止或者被剥离，定时向应用/游戏方客户端反馈风控 SDK 的心跳信息，告知应用/游戏方当前风控 SDK 运行状态，既方便应用/游戏方实时掌握风控服务运行状态，也能保证易盾风控服务正常运行。

同时心跳接口也可以主动实时返回风控数据（有别于交互接口），如需要详细说明文档，请联系易盾获取。

接口须知：

须在 SDK 初始化且用户同意隐私政策后才能调用该接口；
初始化接口的配置类必须设置gameKey
SDK 会启动线程来调用 onReceive 函数，请注意多线程问题。
如果未调用初始化，此接口默认为空，不会执行任何逻辑。

函数原型：

void htp_register_info_receiver(IInfoReceiver* receiver);

参数说明：

参数	类型	说明
receiver	InfoReceiver	回调函数，接收心跳信息

InfoReceiver 接口定义：

#ifdef __cplusplus
class IInfoReceiver
{
public:
    virtual ~IInfoReceiver(){}
    virtual void onReceive(int InfoType, const char* info) = 0;
};
#endif

InfoReveiver 接口中，onReceiver 方法参数说明：

参数	类型	说明
Type	int	接收数据的类型
Info	const char*	接收的具体数据内容

onReceiver 方法中参数 Type 支持类型有：

值	定义	说明
1	INFO_TYPE_HEARTBEAT	心跳数据，可直接在客户端解析
2	INFO_TYPE_ENC_HEARTBEAT	加密后的心跳数据，必须发往客户服务端进行解密
3	INFO_TYPE_CHEATINFO	检测信息，包括 APP 基本信息及风控检测到的异常信息，信息详情请联系易盾获取

注意

两种 type 类型心跳数据均可接收，也可只接收其中一种，建议只获取加密后的心跳数据，然后发往客户服务端进行解析。
心跳接口是每隔 10s 会返回一次数据（“Info”），返回的数据为一个字符串，“Info” 包含三种信息，分别是：序列号、时间戳、网络状态，使用 “key:value” 格式并用 “||” 符号分割。信息含义如下所示：

名称	标识	说明	异常情况	是否必有
序列号	seq	从初始值 “1” 开始递增	序列号不存在，或者乱序	是
时间戳	t	当前时间戳，以秒为单位	时间戳非当前时间	是
网络标识	net	数据发送是否成功（ 1 为成功，0 为失败）	网络异常，数据发送失败，则网络标识为：0	是

Info 的返回值示例：

易盾风控服务网络通信正常时：

seq:1||t:1589781840||net:1

易盾风控服务网络通信异常时：

seq:1||t:1589781840||net:0

处理建议：

seq、t和net是否出现，该三个标识为心跳系统一定会返回的值，若无，说明反外挂异常；
seq的值是否符合"从1开始依次递增"的规则，若不符合，说明返回值被篡改；
net为0是否长期出现，若5分钟内net的取值都为0，说明网络异常；
若出现反外挂异常或网络异常，请结合游戏业务数据综合判断并自行处理。

数据校验接口（getDataSign）

接口用途：

应用/游戏协议如被破解，若为单机游戏类型应用，可直接影响到存档文件的安全性；若为帧同步游戏类型应用，可通过破解协议修改战斗数据；若为其他游戏类型应用，可被做成脱机协议，用于攻击或制作脱机外挂；若为非游戏类型应用，则可伪造业务数据欺骗客户端应用。为了保障应用/游戏协议安全，易盾风控服务提供 “数据校验” 方案，采用自研通讯协议校验算法。

接口须知：

客户端接入数据校验接口后，客户服务端需要对对应的数据进行校验，数据校验相关说明文档请联系易盾获取；
对于与服务端有通信的应用/游戏，强烈建议 使用该接口进行数据校验。
初始化接口的配置类必须设置gameKey
如果未调用初始化，此接口默认返回 -201
只有返回1，才表示调用成功

函数原型：

int htp_get_data_sign(int alg_type, const char* data, /*[out]*/char* buf, size_t size, size_t* used_buf_size);

参数说明：

参数	类型	说明
alg_type	int	使用的算法标识，当前固定为1003
data	const char*	待校验的数据
buf	char*	返回的数据即为校验结果，开发者需要将原始数据与校验结果发送到游戏服务端，由游戏服务端校验
size	size_t	返回数据大小
used_buf_size	size_t*	实际使用数据的大小

返回值：

返回的数据即为校验结果，开发者需要将原始数据与校验结果发送到应用/游戏服务端，由应用/游戏服务端校验。

安全通信协议接口

接口用途：

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

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

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

接口须知：

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

本地数据加解密接口

接口用途：

该接口用于对应用/游戏本地存储的数据进行加解密，保护本地数据安全（游戏类型应用可用于本地游戏存档保护）。

接口须知：

加密后的数据，需要接入方自行存储，风控 SDK 只提供加密和解密功能。
初始化接口的配置类必须设置gameKey
只有返回1，才表示调用成功

函数原型：

int htp_enc_local(const char* buf, size_t size, /*[out]*/char* enc_buf, size_t enc_buf_size, /*[out]*/size_t *used_buf_size,int alg_type);
int htp_dec_local(const char* buf, size_t size, /*[out]*/char* dec_buf, size_t dec_buf_size, /*[out]*/size_t *used_buf_size,int alg_type);

参数说明：

参数	说明
buf	需要加密或者解密的数据
size	buf的大小
enc_buf/dec_buf	返回数据buffer
enc_buf_size/dec_buf_size	返回数据buffer大小
used_buf_size	实际使用的buffuer大小
alg_type	参数为0：跟app安装绑定；参数为1：跟app签名绑定

返回值：

若是加密接口，返回的数据即为原始数据的密文；
若是解密接口，返回的数据即为密文对应的原始数据。

模拟点击AI识别

接口用途：

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

接入须知：

SDK5.3.5以之后版本支持该接口

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

函数原型：

void htp_register_touchevent(int gameplayId, int sceneId)

函数说明：

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

参数说明：

参数	说明
gameplayId	玩法id
sceneId	场景id

（2）关闭数据采集

函数原型：

void htp_unregister_touchevent()

函数说明：

取消点击事件数据采集。

Comment On The Document:

If you encounter product-related problems, you can Submit a ticket 或Online ChatSeek help.

Online Chat Tel：95163223 Free trial