亿速云游戏盾SDK接入

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

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 后续补充