关于iOS GangSDK的使用 为App快速集成社群公会模块

时间:2021-07-20 01:15:34

手上有一个自己开发的小游戏,想加一个家族系统活跃下游戏的氛围,想到这块儿可能会有大量的工作需要自己做,就偷了个懒去网上搜罗了一波,结果惊奇的发现居然真的有类似的服务,并且还是免费的,所以决定入坑尝试一下。这里就我使用的第三方家族系统(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

关于iOS GangSDK的使用 为App快速集成社群公会模块

2>通过在工程目录上的右键[add files to…]来添加上面拷贝进去的文件夹,如图:

关于iOS GangSDK的使用 为App快速集成社群公会模块

2、添加依赖库

关于iOS GangSDK的使用 为App快速集成社群公会模块

3、添加 -objc 链接符号
点击项目文件->选择项目target->选中build setting ->在搜索框中输入other link ,找到other linker flags ->添加-objc,如下图:

关于iOS GangSDK的使用 为App快速集成社群公会模块

4、添加权限

1>选中info.plist->右键选择open as -> source code,如下图:

关于iOS GangSDK的使用 为App快速集成社群公会模块

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>

关于iOS GangSDK的使用 为App快速集成社群公会模块

5、初始化gangsdk

1>导入头文件:
#import <gangsdk/gangsdk.h>

2>调用方法:
//初始化,一般在应用一打开就进行
[[gangsdk instance] init:申请的key  showdebug:是否打印日志];

关于iOS GangSDK的使用 为App快速集成社群公会模块

如果想在不进入gangsdk界面前先登录gangsdk,从而收取一些即时消息等,那么在初始化后调用gangsdk的登录方法。

6、进入gangsdk界面

1>导入头文件:
#import “gangsdk+ui.h”

2>调用方法:
如果上面已经调用了登录方法,则直接调用跳转进入界面方法。
否则调用下面的登录并跳转界面方法:

[[gangsdk instance] startui:用来跳转的controller userid:用户的唯一标识符  nickname:用户的昵称  headiconurl:用户的头像  gamelevel:应用中用户的等级  gamerole:应用中用户的角色  extparams:额外的用户信息   success:成功回调  failure:失败回调];

关于iOS GangSDK的使用 为App快速集成社群公会模块

如果没有自己的用户系统,可以选择下面的重载方法,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:失败回调];

关于iOS GangSDK的使用 为App快速集成社群公会模块

如果不想用默认的界面风格,可以下载其他ganguiresource来替换旧的ganguiresource文件夹,

详细集成文档下载地址:http://www.gangsdk.com/statichtml/html/gateway/other/ios.html?downloadtype=detailed