本文介绍了使用XCode接入游戏盾SDK的操作方法。

前提条件

  • 从游戏盾控制台获取iOS版本的SDK包和AccessKey(即Appkey)。更多信息,请参见获取SDK和AccessKey
  • 从游戏盾控制台获取以下信息。
    • GroupName:节点组标识。前往游戏盾控制台,进入游戏管理页面,在基础接入参数页签下查看。基础接入参数,节点组标识
    • 防护目标标识:前往游戏盾控制台,进入游戏管理页面,在防护目标配置页签下查看。防护目标配置,防护目标标识

操作步骤

  1. 运行XCode。
  2. 新建一个工程,选择Single View Application,并按照默认配置完成创建向导。示例中将工程命名为yxd_sdk_test。
    说明 进行后续操作前,请确认新建工程可以正常运行。
  3. 添加库依赖。将iOS SDK包中的YunCeng.framework复制到新建工程(示例中是yxd_sdk_test)的目录下。复制YunCeng.framework
  4. 修改工程配置。
    • Build Phases修改为Link Binary With Libraries
    • 添加YunCeng.framework及其他依赖framework。添加YunCeng.framework
  5. 修改ViewController.m
    说明 关于核心函数initEx和getProxyTcpByDomain的说明,请参见核心函数说明
    // 初始化,只需成功初始化一次
    const char appkey[] = "appkeytest"; //控制台获取
    int ret = [YunCeng initEx: appkey: "token"];
    if (0 != ret) {
        printf("init failed. \n");
        return;
    }
    const char groupname[] = "GroupName"; //控制台获取,一个游戏一个
    char ip[128] = {0};
    char port[32] = {0};
    
    //核心调用接口
    ret = [YunCeng getProxyTcpByDomain: "玩家ID": groupname: “防护目标端口”: "服务器端口": ip: 128 : port: 32];
    if (0 != ret) {
        printf("get next ip failed. \n");
        return;
    }
    printf("get next ip success. %s, port:%s \n", ip, port);
    说明
    • 若编译时出错并提示 "_OBJC_CLASS_$_CTTelephonyNetworkInfo", referenced from,请参见步骤4添加CoreTelephony.framework库。
    • 若编译时出错并提示 "_res_9_getservers", referenced from,请参见步骤4添加libresolv.tbd库。libresolv.tbd

后续步骤

完成SDK接入后,您将可以通过SDK获得游戏盾转化的IP和端口。针对不同的业务类型,具体使用游戏盾转化IP和端口的方法也有区别,请分别参见以下文档。