安然游戏盾

准备游戏盾配置

创建有效套餐，配置启用的 TCP 转发规则，确认源站地址和端口，并确认套餐已分配可用节点、源站防火墙允许节点回源。

管理员为应用配置 SDK 应用 ID 与密钥，并提供对应的游戏 ID 和转发规则 ID。客户端用这些信息连接主控并取得可用节点。

统一客户端启动流程

1. 初始化 SDK，注册设备，并按游戏 ID 与规则 ID 握手。
2. 启动本地 TCP 代理，端口传 0 时由系统分配空闲端口。
3. 把游戏网络模块的目标改为 127.0.0.1 和 SDK 返回的本地端口。
4. 游戏退出时停止本地代理并反初始化 SDK。
5. 节点故障会中断已有 TCP 会话，游戏应使用原有逻辑重连。

只把地址改成 127.0.0.1 不够；游戏代码必须连接 SDK 实际返回的本地端口。

Windows · C/C++

#include "gameshield.h"

int localPort = 0;
if (gs_init(appId, appSecret, apiHost, callback, nullptr) == GS_OK
    && gs_register_device() == GS_OK
    && gs_handshake(gameId, ruleId) == GS_OK
    && gs_start_local_proxy(0, &localPort) == GS_OK) {
    ConnectGameNetwork("127.0.0.1", localPort);
}

// On game shutdown:
gs_stop_local_proxy();
gs_shutdown();

将 ConnectGameNetwork 替换为游戏原有的网络连接入口。可运行示例位于 sdk/windows/demo/integrated_client_example.cpp。

Android · Kotlin

将 sdk/android 中的 SDK 模块集成到应用，并在 AndroidManifest 中声明 INTERNET 权限。

Gameshield.init(context, appId, appSecret, apiHost, null)
Gameshield.registerDevice { ok, message ->
    if (ok) Gameshield.handshake(gameId, ruleId) { info, error ->
        if (info != null) {
            val proxy = Gameshield.startLocalProxy(info)
            // Connect the game's network module to proxy.host / proxy.port.
        }
    }
}

游戏会话结束时关闭本地代理：proxy.close()。

iOS · Swift

通过 Swift Package Manager 将 sdk/ios 集成到游戏 Target。SDK 在当前 App 内建立本地 TCP 转发。

Gameshield.initialize(appId: appId, appSecret: appSecret, apiHost: apiHost)
try await Gameshield.registerDevice()
let info = try await Gameshield.handshake(gameId: gameId, ruleId: ruleId)
let proxy = try await Gameshield.startLocalProxy(from: info)
// Connect the game's network module to proxy.host / proxy.port.
// On game shutdown:
proxy.stop()

游戏网络模块必须实际连接 SDK 返回的本地端点。

安全与上线验收

• 不要把 SDK 密钥写入日志或提交到公开代码仓库；客户端程序中的凭据应按可被提取处理。
• 不要关闭证书、指纹或路由签名校验；重新生成密钥后旧密钥会失效。
• 验证登录、选服、进服、重连、多业务端口、端口占用自动换端口、网络切换和规则更新。
• 确认业务连接目标是 SDK 返回的本地端点，并在控制台查看在线终端与连接记录。