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

前提条件

已通过游戏盾控制台获取iOS版本的SDK包和AccessKey(即Appkey)。具体操作,请参见获取SDK和AccessKey下载SDK和AccessKey

操作步骤

  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. 初始化SDK。
    使用以下代码前,必须替换以下变量:
    • <yourAppKey>替换成您通过游戏盾控制台获取的AccessKey。
    • <token>替换成游戏内玩家的唯一ID。如果无法获取该ID,可以设置为一个默认值,但是不允许为空。
    - (int) SDKInit {
        const char * appkey = "<yourAppKey>";
        const char * token = "<token>";
        int ret = YunCeng_InitEx(appkey, token);
        if (ret == 0) {
            NSLog(@"sdk init success");
        } else {
            NSLog(@"sdk init failed, ret %d", ret);
        }
        return ret;
    }
    故障排查:
    • 如果编译时出错并提示 "_OBJC_CLASS_$_CTTelephonyNetworkInfo", referenced from,请参见步骤4添加CoreTelephony.framework库。
    • 如果编译时出错并提示 "_res_9_getservers", referenced from,请参见步骤4添加libresolv.tbd库。libresolv.tbd

后续步骤

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