手上有一个自己开发的小游戏,想加一个家族系统活跃下游戏的氛围,想到这块儿可能会有大量的工作需要自己做,就偷了个懒去网上搜罗了一波,结果惊奇的发现居然真的有类似的服务,并且还是免费的,所以决定入坑尝试一下。这里就我使用的第三方家族系统(GangSDK)做一个简单的记录,方便以后查看。
一、GangSDK介绍
GangSDK是为开发者提供的一套快速接入社群系统的开发框架,主要为了帮助开发者在自己的应用里快速构建社群系统。社群系统包含两大功能:1、为用户们提供自己的社交圈,使他们交流更方便;2、社群建设,使社群更具影响力,同时吸引更多的用户加入。
GangSDK包括三个部分:
GangCore:数据管理(所有网络请求接口管理)
GangUI:界面展示(提供的UI布局)
GangUIResource:皮肤资源(为UI提供了多套资源,可选择替换使界面显示多样化)
二、集成前准备
1、注册及创建应用,网址:http://www.gangsdk.com/statichtml/html/gangsdkmanage/myapp.html
2、下载GangSDK.zip,网址:http://www.gangsdk.com/statichtml/resource/sdk/ios/GangSDK.zip
三、开始集成
1、导入GangSDK
1>将GangSDK.zip解压后拷贝到工程文件夹(.xcodeproj文件所在目录)中去,如图:
2>通过在工程目录上的右键[Add Files to…]来添加上面拷贝进去的文件夹,如图:
2、添加依赖库
点击项目文件->选择项目target->选中Build Phase ->在Link Binary With Libraries中添加 libicucore.tbd,如图:
3、添加 -ObjC 链接符号
点击项目文件->选择项目target->选中Build Setting ->在搜索框中输入other link ,找到Other Linker Flags ->添加-ObjC,如下图:
4、添加权限
1>选中info.plist->右键选择Open as -> Source Code,如下图:
2>将下面的配置信息粘贴进去,如下图:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
<key>NSPhotoLibraryUsageDescription</key>
<string>能够查看相册图片</string>
<key>NSCameraUsageDescription</key>
<string>拍摄照片</string>
<key>NSMicrophoneUsageDescription</key>
<string>发送语音消息</string>
5、初始化GangSDK
1>导入头文件:
import <GangSDK/GangSDK.h>
2>调用方法:
//初始化,一般在应用一打开就进行
[[GangSDK instance] init:申请的key showDebug:是否打印日志];
一般在AppDelegate中进行,如下图:
如果想在不进入GangSDK界面前先登录GangSDK,从而收取一些即时消息等,那么在初始化后调用GangSDK的登录方法。
6、进入GangSDK界面
1>导入头文件:
import “GangSDK+UI.h”
2>调用方法:
如果上面已经调用了登录方法,则直接调用跳转进入界面方法。
否则调用下面的登录并跳转界面方法:
[[GangSDK instance] startUI:用来跳转的controller userId:用户的唯一标识符 nickname:用户的昵称 headIconUrl:用户的头像 gameLevel:应用中用户的等级 gameRole:应用中用户的角色 extParams:额外的用户信息 success:成功回调 failure:失败回调];
如果没有自己的用户系统,可以选择下面的重载方法,GangSDK会给用户自动生成一个唯一标识符,用户会使用默认的头像,而且在用户进入GangSDK界面的时候会弹出对话框让用户自己设置一个昵称:
[[GangSDK instance] startUI:用来跳转的controller success:成功回调 failure:失败回调];
更多重载方法:
[[GangSDK instance] startUI:用来跳转的controller userId:用户的唯一标识符 nickname:用户的昵称 success:成功回调 failure:失败回调];
[[GangSDK instance] startUI:用来跳转的controller userId:用户的唯一标识符 nickname:用户的昵称 headIconUrl: 用户的头像 success:成功回调 failure:失败回调];
进入GangSDK后默认的风格如图:
如果不想用默认的界面风格,可以下载其他GangUIResource来替换旧的GangUIResource文件夹,下载地址:
详细集成文档下载地址:http://www.gangsdk.com/statichtml/html/gateway/other/ios.html?downloadType=detailed