手游智能反外挂(iOS-OC)接入文档

2023.08.22 11:09:31

    隐私说明

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

    接入说明

    接入步骤

    接入反外挂SDK,开发者需要完成以下步骤

    1. 根据游戏运行平台将SDK动态库拷贝到指定工程目录;
    2. 修改项目配置;
    3. 初始化SDK;
    4. 根据用户登录信息调用SDK接口函数;
    5. 验证SDK接入是否正确;
    6. 可选择性的接入相关功能性接口;
    7. 本SDK最低支持的系统:iOS 9.0。
    

    文件说明

    反外挂SDK在iOS系统下接入需要的相关文件有以下:

    RiskPerception.framework
    RiskPerceptionBundle.bundle
    

    接入步骤

    导入组件

    (1)导入 RiskPerception.framework

    导入RiskPerception.framework文件到您的工程

    (2)导入 RiskPerceptionBundle.bundle

    framework文件夹下的RiskPerceptionBundle.bundle 引入到工程, SDKBundle 引入完毕后如下所示:

    如需使用白盒加密,需要找运营获取,白盒加密每个客户端都有单独的白盒查找表在RiskPerceptionBundle.bundle文件,需要将文件加入工程中和sdk同一目录下。

    (3)添加头文件

    请将以下代码添加到AppDelegate.m引用头文件的位置。

    #import <RiskPerception/NTESRiskPerception.h>
    

    权限说明

    info.plist文件中添加

    1、App Transport Security Settings-Allow Arbitrary Loads
    

    修改项目配置

    (1)修改Buding Setting

    build settings ->other linker flags,添加 -ObjC-fprofile-instr-generate-lz

    (2)关闭bitcode

    SDK不支持bitcode需要关闭bitcode

    注意

    如果使用IPA方式对archive包加固,需要开启项目的bitcode,同时需要使用易盾辅助工具开启三方库的bitcode,详见加固工具的接入文档

    (3)添加依赖库

    General -> Frameworks,Libraries,and Embedded Content,添加以下库: AvFoundation.framework CoreTelephony.framework SystemConfiguration.framework libc++.tbd

    使用SDK

    (1)初始化

    AppDelegate.m文件didFinishLaunchingWithOptions方法中添加以下初始化代码

    a 中国大陆应用
    [[KpelleAzuriteCues fomentBevelDeadengo] deadengoBevel:@"APPID"];
    
    b 台湾应用
    [[KpelleAzuriteCues fomentBevelDeadengo] changeViewDetailStar:2];
    [[KpelleAzuriteCues fomentBevelDeadengo] deadengoBevel:@"APPID"];
    
    c 其他地区应用
    [[KpelleAzuriteCues fomentBevelDeadengo] changeViewDetailStar:3];
    [[KpelleAzuriteCues fomentBevelDeadengo] deadengoBevel:@"APPID"];
    
    说明:

    设置区域信息的接口: changeViewDetailStar,需要在初始化接口: deadengoBevel之前调用.

    AppID可在智能反外挂下的服务管理查询AppID,或者可在群里咨询技术支持人员。AppID示例:I003722234

    (2)设置角色信息

    用户登录或者切换游戏账号的时候,调用以下接口

    [[KpelleAzuriteCues fomentBevelDeadengo] sheldonstirpAlunitego:@"xxx" UserName:@"xxx" UserAccount:@"xxx" UserServer:@"xxx" GameJson:@"xxx"];
    
    说明:

    只有调用了sheldonstirpAlunitego接口,才会启动反外挂功能.

    接入验证

    1、确保工程中SDK相关接口已调用。

    2、运行程序,确保已触发相关接口。

    3、前往官网查询数据. 输入用户名进行查询

    SDK初始化

    接口用途:

    用于初始化反外挂SDK。

    注意

    该接口为必须调用接口。

    接入须知:

    正常环境下,使用直传方式。如需接入透传模式,需联系技术支持人员,设置相应的透传服务器。 自动化透传模式客户端会自动转发到被拦截的请求。

    函数原型:

    直传模式

    - (BOOL)deadengoBevel:(NSString *)app_id;
    

    自动化透传模式

    - (BOOL)deadengoBevel:(NSString *)app_id withDefineSpaces:(NSString *)url;
    
    参数说明:
    参数 说明 赋值
    app_id 不同用户或游戏的唯一标识(非bundleID),可在智能反外挂下的服务管理查询AppID,或者可在群里咨询技术支持人员。AppID示例:I003722234 必填
    url 透传服务器地址。url示例"https://www.netease163.com"。 可填空
    返回值说明:
    返回值 说明
    错误返回 NO 初始化失败
    正确返回 YES 初始化成功
    示例代码:
    [[KpelleAzuriteCues fomentBevelDeadengo] deadengoBevel:@"APPID"];
    

    登录接口/设置角色信息

    接口用途:

    在进行数据采集的过程中,会将角色ID、角色名称、角色账号等设置在反外挂采集的数据中一同上传,标识了用户的信息后,对应有恶意行为的用户可以进行相应的惩罚。

    注意

    该接口为必须调用接口。

    函数原型:
    - (void)sheldonstirpAlunitego:(NSString *)user_id 
    		     UserName:(NSString *)user_name 
    		  UserAccount:(NSString *)user_account  
    		   UserServer:(NSString *)user_server 
    		     GameJson:(NSString *)game_json;
    
    >参数说明:
    参数 说明 赋值
    user_id 玩家的角色ID 必填
    user_name 玩家的角色名称 可填空
    user_account 用户/玩家的账号;如业务方同时接入易盾反垃圾,则此账号需要与反垃圾接入中的account一致 可填空
    user_server 玩家的角色服务器 可填空
    game_json 游戏需要上传的信息,对应一个json字符串,包含key 可填空
    示例代码:
    [[KpelleAzuriteCues fomentBevelDeadengo] sheldonstirpAlunitego:@"163163" 
    						      UserName:@"netease" 
    						   UserAccount:@"wangyiyidun" 
    						    UserServer:@"server" 
    						      GameJson:@"data"];
    

    设置区域信息

    接口用途:

    非中国大陆地区,因为网络和监管需要,需要设置区域信息,以支持在不同的地区使用不同的网络进行数据传输。

    接入须知:

    不调用此接口默认为中国大陆。非中国大陆应用和台湾地区,需要调用此接口。如不按规范设置,可能会有数据丢失问题存在。设置时,请与技术支持确认。

    函数原型:
    - (void)changeViewDetailStar:(NSInteger)type;
    
    参数说明:
    参数 说明 赋值
    Type 服务器地区类型 1、中国大陆 2、台湾地区 3、非中国大陆地区。 必填
    示例代码:
    台湾地区应用
    [[KpelleAzuriteCues fomentBevelDeadengo] changeViewDetailStar:2];
    非中国大陆和台湾地区应用
    [[KpelleAzuriteCues fomentBevelDeadengo] changeViewDetailStar:3];
    

    退出登陆

    接口用途:

    账号退出登陆可以使用以下接口。

    接入须知:

    如果切换账号可以直接使用“设置角色信息”接口,会自动退出自己登陆的账号。

    函数原型:
    - (void)devastatedMovement;
    
    示例代码:
    [[KpelleAzuriteCues fomentBevelDeadengo] devastatedMovement];
    
    Online Chat Tel:95163223 Free trial