手上有一個(gè)自己開發(fā)的小游戲,想加一個(gè)家族系統(tǒng)活躍下游戲的氛圍,想到這塊兒可能會(huì)有大量的工作需要自己做,就偷了個(gè)懶去網(wǎng)上搜羅了一波,結(jié)果驚奇的發(fā)現(xiàn)居然真的有類似的服務(wù),并且還是免費(fèi)的,所以決定入坑嘗試一下。這里就我使用的第三方家族系統(tǒng)(GangSDK)做一個(gè)簡(jiǎn)單的記錄,方便以后查看。
一、GangSDK介紹
GangSDK是為開發(fā)者提供的一套快速接入社群系統(tǒng)的開發(fā)框架,主要為了幫助開發(fā)者在自己的應(yīng)用里快速構(gòu)建社群系統(tǒng)。社群系統(tǒng)包含兩大功能:1、為用戶們提供自己的社交圈,使他們交流更方便;2、社群建設(shè),使社群更具影響力,同時(shí)吸引更多的用戶加入。
GangSDK包括三個(gè)部分:
GangCore:數(shù)據(jù)管理(所有網(wǎng)絡(luò)請(qǐng)求接口管理)
GangUI:界面展示(提供的UI布局)
GangUIResource:皮膚資源(為UI提供了多套資源,可選擇替換使界面顯示多樣化)
二、集成前準(zhǔn)備
1、注冊(cè)及創(chuàng)建應(yīng)用,網(wǎng)址:http://www.gangsdk.com/statichtml/html/gangsdkmanage/myapp.html
2、下載GangSDK.zip,網(wǎng)址:http://www.gangsdk.com/statichtml/resource/sdk/ios/GangSDK.zip
三、開始集成
1、導(dǎo)入GangSDK
1>將GangSDK.zip解壓后拷貝到工程文件夾(.xcodeproj文件所在目錄)中去,如圖:

2>通過在工程目錄上的右鍵[Add Files to…]來添加上面拷貝進(jìn)去的文件夾,如圖:

2、添加依賴庫
點(diǎn)擊項(xiàng)目文件->選擇項(xiàng)目target->選中Build Phase ->在Link Binary With Libraries中添加 libicucore.tbd,如圖:

3、添加 -ObjC 鏈接符號(hào)
點(diǎn)擊項(xiàng)目文件->選擇項(xiàng)目target->選中Build Setting ->在搜索框中輸入other link ,找到Other Linker Flags ->添加-ObjC,如下圖:

4、添加權(quán)限
1>選中info.plist->右鍵選擇Open as -> Source Code,如下圖:

2>將下面的配置信息粘貼進(jìn)去,如下圖:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
<key>NSPhotoLibraryUsageDescription</key>
<string>能夠查看相冊(cè)圖片</string>
<key>NSCameraUsageDescription</key>
<string>拍攝照片</string>
<key>NSMicrophoneUsageDescription</key>
<string>發(fā)送語音消息</string>

5、初始化GangSDK
1>導(dǎo)入頭文件:
import <GangSDK/GangSDK.h>
2>調(diào)用方法:
//初始化,一般在應(yīng)用一打開就進(jìn)行
[[GangSDK instance] init:申請(qǐng)的key showDebug:是否打印日志];
一般在AppDelegate中進(jìn)行,如下圖:

如果想在不進(jìn)入GangSDK界面前先登錄GangSDK,從而收取一些即時(shí)消息等,那么在初始化后調(diào)用GangSDK的登錄方法。
6、進(jìn)入GangSDK界面
1>導(dǎo)入頭文件:
import “GangSDK+UI.h”
2>調(diào)用方法:
如果上面已經(jīng)調(diào)用了登錄方法,則直接調(diào)用跳轉(zhuǎn)進(jìn)入界面方法。
否則調(diào)用下面的登錄并跳轉(zhuǎn)界面方法:
[[GangSDK instance] startUI:用來跳轉(zhuǎn)的controller userId:用戶的唯一標(biāo)識(shí)符 nickname:用戶的昵稱 headIconUrl:用戶的頭像 gameLevel:應(yīng)用中用戶的等級(jí) gameRole:應(yīng)用中用戶的角色 extParams:額外的用戶信息 success:成功回調(diào) failure:失敗回調(diào)];

如果沒有自己的用戶系統(tǒng),可以選擇下面的重載方法,GangSDK會(huì)給用戶自動(dòng)生成一個(gè)唯一標(biāo)識(shí)符,用戶會(huì)使用默認(rèn)的頭像,而且在用戶進(jìn)入GangSDK界面的時(shí)候會(huì)彈出對(duì)話框讓用戶自己設(shè)置一個(gè)昵稱:
[[GangSDK instance] startUI:用來跳轉(zhuǎn)的controller success:成功回調(diào) failure:失敗回調(diào)];
更多重載方法:
[[GangSDK instance] startUI:用來跳轉(zhuǎn)的controller userId:用戶的唯一標(biāo)識(shí)符 nickname:用戶的昵稱 success:成功回調(diào) failure:失敗回調(diào)];
[[GangSDK instance] startUI:用來跳轉(zhuǎn)的controller userId:用戶的唯一標(biāo)識(shí)符 nickname:用戶的昵稱 headIconUrl: 用戶的頭像 success:成功回調(diào) failure:失敗回調(diào)];
進(jìn)入GangSDK后默認(rèn)的風(fēng)格如圖:

如果不想用默認(rèn)的界面風(fēng)格,可以下載其他GangUIResource來替換舊的GangUIResource文件夾,下載地址:
詳細(xì)集成文檔下載地址:http://www.gangsdk.com/statichtml/html/gateway/other/ios.html?downloadType=detailed