亿速云游戏盾SDK接入

亿速云高防游戏盾SDK接入指南

注意：IOS系统默认本地IP只能使用”127.0.0.1”,如接入，默认链接的本地IP，都是”127.0.0.1”

windows 应用接入

1.接入方法

PC的SDK接入访问为DLL模式，只需要将shieldmanager.dll集成到项目并开启调用即可

2.接入示例

以下提供C++项目的接入,其他类型同理

//引入windows基本库
#include <windows.h>
#include <iostream>

//加载dll库
// ---- DLL 函数指针类型 ----
using FnShieldStart      = char* (*)(char*);
using FnShieldStop       = char* (*)();
using FnShieldGetState   = int   (*)();
using FnShieldVersion    = char* (*)();
using FnShieldFreeString = void  (*)(char*);
// ---- 定义DLL结构体并增加析构方法,用来释放库占用内存
struct DllGuard {
    HMODULE hModule = nullptr;
    explicit DllGuard(const char* path) {
        hModule = LoadLibraryA(path);
        if (!hModule)
            throw std::runtime_error(std::string("LoadLibrary failed: ") + path
                + "  LastError=" + std::to_string(GetLastError()));
        std::cout << "[DLL] Loaded: " << path << "\n";
    }
    ~DllGuard() {
        if (hModule) {
            FreeLibrary(hModule);
            std::cout << "[DLL] Unloaded\n";
        }
    }
    template<typename Fn>
    Fn proc(const char* name) const {
        auto fn = reinterpret_cast<Fn>(GetProcAddress(hModule, name));
        if (!fn)
            throw std::runtime_error(std::string("GetProcAddress failed: ") + name);
        return fn;
    }
};
// ---- 加载 DLL ----
DllGuard dll("shieldmanager.dll");
auto ShieldStart      = dll.proc<FnShieldStart>     ("ShieldStart");
auto ShieldStop       = dll.proc<FnShieldStop>      ("ShieldStop");
auto ShieldGetState   = dll.proc<FnShieldGetState>  ("ShieldGetState");
auto ShieldVersion    = dll.proc<FnShieldVersion>   ("ShieldVersion");
auto ShieldFreeString = dll.proc<FnShieldFreeString>("ShieldFreeString");
//定义sdk_key字符指针,根据实际gamekey复制即可
const char* SDK_KEY_DEFAULT =
    "";
std::string sdkKey = SDK_KEY_DEFAULT;
//调用上面定义的shieldStart函数，将真实的sdk_key传入
char* result = ShieldStart(const_cast<char*>(sdkKey.c_str()));
printResult("ShieldStart", result, ShieldFreeString);//结果为1表示正常启动

Android 应用接入

接入方式

Android 的SDK接入方法为arr模式，将shieldmanager.aar集成到项目中并开启时调用即可

需要开启android的网络权限

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

SDK接入示例

以下为Android Studio项目的示例，其他类型同理

Android Studio示例

1. 将shieldmanager.aar文件放到工程libs目录下

2. 在app级别的build.gradle中添加对libs目录的引入

implementation fileTree(dir: 'libs', include: ['*.aar'])

3.执行”File/Sync Project with Gradle Files”同步配置

4.在连接远程服务器前开启游戏盾(建议在程序运行后开启)，kotlin代码示例:

import shieldmanager.Shieldmanager
// SDK KEY
private val sdkKey = "your-sdk-key"
val resultEncoded = Shieldmanager.start(sdkKey)
val resultJson = String(Base64.decode(resultEncoded, Base64.NO_WRAP), Charsets.UTF_8)  //对结果进行base64解密
val result = JSONObject(resultJson)   //启动成功则返回为1
val errMsg = result.optString("error", "")
val data = result.optString("data", "")

5.程序结束后，关闭盾即可

val resultEncoded = Shieldmanager.stop()
val resultJson = String(Base64.decode(resultEncoded, Base64.NO_WRAP), Charsets.UTF_8)
val result = JSONObject(resultJson)
val errMsg = result.optString("error", "")

IOS 接入

Objective-C 示例

1. 选择”File/Add Files to”将”Shieldmanager.xcframework”文件放到项目目录Frameworks下

2. 在弹出的对话框中选择”Copy items if needed”

3. 在Build Settings 中关闭Enable Bitcode

4. 代码中引入头文件

#import <Shieldmanager/Shieldmanager.h>

5. 在程序运行后，就开启，代码示例:

//SDN key
static NSString *const SDK_KEY =@"your-sdk-key";
//开启盾，并对结果进行处理
NSString *resultB64 = ShieldmanagerStart(SDK_KEY);
        dispatch_async(dispatch_get_main_queue(), ^{
            NSString *json = decodeBase64JSON(resultB64);
            NSDictionary *result = [NSJSONSerialization
                JSONObjectWithData:[json dataUsingEncoding:NSUTF8StringEncoding]
                options:0 error:nil];
            NSString *error = result[@"error"] ?: @"";
            NSString *data  = result[@"data"]  ?: @"";
            if (error.length == 0 && [data isEqualToString:@"1"]) {
                // error为空，且data 是字符1表示启动成功
            } else {
                //error 不为空，则表示启动异常，data为具体的报错
            }
        });

6. 在程序结束前释放游戏盾，代码示例:

 NSString *resultB64 = ShieldmanagerStop();
        dispatch_async(dispatch_get_main_queue(), ^{
            NSString *json = decodeBase64JSON(resultB64);
            NSDictionary *result = [NSJSONSerialization
                JSONObjectWithData:[json dataUsingEncoding:NSUTF8StringEncoding]
                options:0 error:nil];
            NSString *error = result[@"error"] ?: @"";
            if (error.length == 0) {
               //表示成功关闭
            } else {
               //表示关闭异常
            }
        });