Cocos2DX 简介
Cocos2d- x 是一套成熟的开源跨平台游戏开发框架。其引擎提供了图形渲染、GUI、音频、网络、物理、用户输入等丰富的功能,被广泛应用于游戏开发及交互式应用的构建。引擎的核心采用 C ++ 编写,支持使用 C ++、Lua 或者 JavaScript 进行开发。同时 Cocos2d- x 可以适配 IOS、Android、HTML5、Windows 和 Mac 系统。
Cocos2d- x 在中国及全球都有一定的市场份额,为了给开发出来的游戏增加知名度,更好的进行营销,社交分享功能是必不可少的。但是所要分享的平台针对全球不同的区域有不同的侧重点,这就需要短时间内接入多个社交平台,但是每个平台的接入时间成本按天计算,多个平台叠加在一起的时间就很不乐观。所以使用 Cocos2d- x 引擎的开发人员急需一种能够让开发者快速接入授权、分享功能的 SDK。
Cocos2d- x 集成 ShareSDK 过程如下:
产品主页网址:http://www.mob.com/product/sh…
官方插件地址:https://github.com/MobClub/Ne…
Android 集成
首先下载官方插件,下载完毕之后需要做如下几步工作
把 ShareSDK 的 cocos2dx 的 proj.android-studio 项目里的 libs 包复制到你的项目里,除了 armeabi 目录不用复制其他都要。
把 ShareSDK 的 cocos2dx 的 New-C2DX-For-ShareSDK 项目里的 Classes 目录下的文件都复制到你的项目里的 Classes 目录下。
在 jni/Android.mk 添加下面代码来引入相关文件,如:
../../Classes/AppDelegate.cpp \
../../Classes/HelloWorldScene.cpp \
../../Classes/C2DXShareSDK/Android/ShareSDKUtils.cpp \
../../Classes/C2DXShareSDK/C2DXShareSDK.cpp \
../../Classes/C2DXShareSDK/Android/JSON/CCJSONConverter.cpp \
../../Classes/C2DXShareSDK/Android/JSON/cJSON/cJSON.c
LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../Classes \
$(LOCAL_PATH)/../../Classes/C2DXShareSDK \
$(LOCAL_PATH)/../../Classes/C2DXShareSDK/Android \
$(LOCAL_PATH)/../../Classes/C2DXShareSDK/Android/JSON \
$(LOCAL_PATH)/../../Classes/C2DXShareSDK/Android/JSON/cJSON
在 proj.android-studio 工程下,app 目录下,build.gradle 文件内,寻找到 dependencies 标签,配置如下的代码
compile project(‘:libcocos2dx’)
在主 activity 里 (一般在 cocos 项目的此目录下面:proj.android-studiosrcorgcocos2dxcppAppActivity.java) 的 onCreate 方法里添加 ShareSDKUtils.prepare()方法。
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
ShareSDKUtils.prepare();
}
各个平台的配置方式:平台的配置在 libcocos2dx 这个依赖工程内,工程根目录下边有一个 MobSDK.gradle 文件,写法示例如下边的代码所示,用户需要用自己申请到的 Key 来替换下文中的 key。平台的选择也根据自己的需要来进行增加删除。
apply plugin: ‘com.mob.sdk’
MobSDK {
appKey "moba6b6c6d6"
appSecret "b89d2427a3bc7ad1aea1e1e8c1d36bf3"
ShareSDK {
// 平台配置信息
devInfo {
SinaWeibo {
id 1
sortId 1
appKey "568898243"
appSecret "38a4f8204cc784f81f9f0daaf31e02e3"
callbackUri "http://www.sharesdk.cn"
shareByAppClient true
enable true
}
QZone {
id 3
sortId 3
appId "100371282"
appKey "aed9b0303e3ed1e27bae87c33761161d"
shareByAppClient true
bypassApproval false
enable true
}
QQ {
id 7
sortId 7
appId "100371282"
appKey "aed9b0303e3ed1e27bae87c33761161d"
shareByAppClient true
bypassApproval false
enable true
}
Wechat {
id 4
sortId 4
appId "wx4868b35061f87885"
appSecret "64020361b8ec4c99936c0e3999a9f249"
userName "gh_b0c6a9ca668a"
path "pages/index/index?id=mob"
withShareTicket true
miniprogramType 2
bypassApproval false
enable true
}
WechatMoments {
id 5
sortId 5
appId "wx4868b35061f87885"
appSecret "64020361b8ec4c99936c0e3999a9f249"
bypassApproval false
enable true
}
WechatFavorite {
id 6
sortId 6
appId "wx4868b35061f87885"
appSecret "64020361b8ec4c99936c0e3999a9f249"
bypassApproval false
enable true
}
Facebook {
id 8
sortId 8
appKey "1412473428822331"
appSecret "a42f4f3f867dc947b9ed6020c2e93558"
callbackUri "https://mob.com"
shareByAppClient true
enable true
}
Twitter {
id 9
sortId 9
appKey "viOnkeLpHBKs6KXV7MPpeGyzE"
appSecret "NJEglQUy2rqZ9Io9FcAU9p17omFqbORknUpRrCDOK46aAbIiey"
callbackUri "http://mob.com"
shareByAppClient true
enable true
}
}
}
}
iOS 集成
将下面红色方框的资源文件拖到 Cocos2d- x 项目中
将 SDK 文件夹拖进项目(下载地址)
注意:请务必在上述步骤中选择“Create groups for any added folders”单选按钮组。如果你选择“Create folder references for any added folders”,一个蓝色的文件夹引用将被添加到项目并且将无法找到它的资源。
添加必须的依赖库
libc++.tbd
libz.tbd
libsqlite3.tbd
各社交平台所需依赖库:
新浪微博:
ImageIO.framework
Photos.framework
Instagram:
AssetsLibrary.framework
Photos.framework
美拍:
AssetsLibrary.framework
添加依赖库的方法如下
配置 UrlScheme 和白名单等,各个社交平台需要的配置可以参考快速集成文档中的 URL Scheme 和白名单配置项。
在项目工程的 Info.plist 中如图增加 MOBAppKey 和 MOBAppSecret 两个字段
在 MOBAppKey 中 设置 ShareSDK 的 appKey,如果尚未在 ShareSDK 官网注册过 App,请移步到 登录后台 进行应用注册也可以点击 链接 看里面的操作步骤。
代码实现
初始化:打开 Classes 目录下边的 AppDelegate.cpp 文件,直接拷贝粘贴代码进行初始化工作。
导入头文件
include “C2DXShareSDK.h”
初始化
bool AppDelegate::applicationDidFinishLaunching()
{
// 初始化 ShareSDK
this->initShareSDKConfig();}
void AppDelegate::initShareSDKConfig()
{
// 设置平台配置
//Platforms
__Dictionary *totalDict = __Dictionary::create();
// 新浪微博
__Dictionary *sinaWeiboConf= __Dictionary::create();
sinaWeiboConf->setObject(__String::create("568898243"), "app_key");
sinaWeiboConf->setObject(__String::create("38a4f8204cc784f81f9f0daaf31e0 2e3"), "app_secret");
sinaWeiboConf->setObject(__String::create("http://www.sharesdk.cn"), "re direct_uri");
stringstream sina;
sina << cn::sharesdk::C2DXPlatTypeSinaWeibo;
totalDict->setObject(sinaWeiboConf, sina.str());
// 微信
__Dictionary *wechatConf = __Dictionary::create();
wechatConf->setObject(__String::create("wx4868b35061f87885"), "app_id");
wechatConf->setObject(__String::create("64020361b8ec4c99936c0e3999a9f249"), "app_secret");
stringstream wechat;
wechat << cn::sharesdk::C2DXPlatTypeWechatPlatform;
totalDict->setObject(wechatConf, wechat.str());
//QQ
__Dictionary *qqConf = __Dictionary::create();
qqConf->setObject(__String::create("100371282"), "app_id");
qqConf->setObject(__String::create("aed9b0303e3ed1e27bae87c33761161d"), "app_key");
stringstream qq;
qq << cn::sharesdk::C2DXPlatTypeQQPlatform;
totalDict->setObject(qqConf, qq.str());
//Facebook
__Dictionary *fbConf = __Dictionary::create();
fbConf->setObject(__String::create("107704292745179"), "api_key");
fbConf->setObject(__String::create("38053202e1a5fe26c80c753071f0b573"), "app_secret");
stringstream facebook;
facebook << cn::sharesdk::C2DXPlatTypeFacebook;
totalDict->setObject(fbConf, facebook.str());
//Twitter
__Dictionary *twConf = __Dictionary::create();
twConf->setObject(__String::create("LRBM0H75rWrU9gNHvlEAA2aOy"), "consumer_key");
twConf->setObject(__String::create("gbeWsZvA9ELJSdoBzJ5oLKX0TU09UOwrzdGfo9Tg7DjyGuMe8G"), "consumer_secret");
twConf->setObject(__String::create("http://www.mob.com"), "redirect_uri" ) ;
stringstream twitter;
twitter << cn::sharesdk::C2DXPlatTypeTwitter;
totalDict->setObject(twConf, twitter.str());
cn::sharesdk::C2DXShareSDK::registerAppAndSetPlatformConfig("moba6b6c6d6","b89d2427a3bc7ad1aea1e1e8c1d36bf3",totalDict);
}
以上平台的 app_key、app_secret 等字段不同分享平台可能不同,详情可参考:《统一表》。
授权功能:
C2DXShareSDK::authorize(C2DXPlatTypeSinaWeibo, authResultHandler);
authResultHandler 是默认定制的一个回调类,也可以自己写一个新的回调类来替代此类
// 授权回调
void authResultHandler(int seqId, cn::sharesdk::C2DXResponseState state, cn::sharesdk::C2DXPlatType platType, __Dictionary *result)
{
switch (state)
{
case cn::sharesdk::C2DXResponseStateSuccess:
{log("Success");
// 输出信息
try
{__Array *allKeys = result -> allKeys();
allKeys->retain();
for (int i = 0; i < allKeys -> count(); i++)
{__String *key = (__String *)allKeys -> getObjectAtIndex(i);
Ref *obj = result -> objectForKey(key -> getCString());
log("key = %s", key -> getCString());
if (dynamic_cast<__String *>(obj))
{log("value = %s", dynamic_cast<__String *>(obj) -> getCString());
}
else if (dynamic_cast<__Integer *>(obj))
{log("value = %d", dynamic_cast<__Integer *>(obj) -> getValue());
}
else if (dynamic_cast<__Double *>(obj))
{log("value = %f", dynamic_cast<__Double *>(obj) -> getValue());
}
}
allKeys->release();}
catch(...)
{log("==============error");
}
}
break;
case cn::sharesdk::C2DXResponseStateFail:
{log("Fail");
// 回调错误信息
__Array *allKeys = result->allKeys();
allKeys->retain();
for (int i = 0; i < allKeys-> count(); i++)
{__String *key = (__String*)allKeys->getObjectAtIndex(i);
Ref *obj = result->objectForKey(key->getCString());
log("key = %s", key -> getCString());
if (dynamic_cast<__String *>(obj))
{log("value = %s", dynamic_cast<__String *>(obj) -> getCString());
}
else if (dynamic_cast<__Integer *>(obj))
{log("value = %d", dynamic_cast<__Integer *>(obj) -> getValue());
}
else if (dynamic_cast<__Double *>(obj))
{log("value = %f", dynamic_cast<__Double *>(obj) -> getValue());
}
}
}
break;
case cn::sharesdk::C2DXResponseStateCancel:
{log("Cancel");
}
break;
default:
break;
}
}
获取用户的信息
授权之后,可以通过如下的方法来获取用户信息。
C2DXShareSDKC ::getUserInfo(C2DXPlatTypeSinaWeibo, getUserResultHandler);
分享
在需要分享操作的代码块中进行构造分享参数,示例如下:
__Dictionary *content = __Dictionary::create();
content -> setObject(__String::create(“ 分享文本 ”), “text”); // 分享文本
content -> setObject(__String::create(“HelloWorld.png”), “image”);// 分享图片
content -> setObject(__String::create(“ 测试标题 ”), “title”); // 分享标题
content -> setObject(__String::create(“http://www.mob.com”), “url”); // 分享 url
content -> setObject(__String::createWithFormat(“%d”, cn::sharesdk::C2DXContentTypeWebPage), “type”); /
构造分享内容字段参数值请参考:《分享内容字段值表》
调用分享方法:
// 弹出菜单
C2DXShareSDK::showShareMenu(NULL,content,100,100, shareContentResultHandler);// 第 3,4 个参数传入 iPad 视图要显示的坐标点,详见 API 说明
// 无 UI,直接分享
C2DXShareSDK::shareContent(cn::sharesdk::C2DXPlatTypeSinaWeibo, content, shareContentResultHandler);
// 弹出编辑界面分享
C2DXShareSDK::showShareView(cn::sharesdk::C2DXPlatTypeSinaWeibo, content, shareContentResultHandler);
设置分享回调方法 shareContentResultHandler,示例如下:
// 分享回调
void shareContentResultHandler(int seqId, cn::sharesdk::C2DXResponseState state, cn::sharesdk::C2DXPlatType platType, __Dictionary *result)
{
switch (state)
{
case cn::sharesdk::C2DXResponseStateSuccess:
{log("Success");
}
break;
case cn::sharesdk::C2DXResponseStateFail:
{log("Fail");
// 回调错误信息
__Array *allKeys = result->allKeys();
allKeys->retain();
for (int i = 0; i < allKeys-> count(); i++)
{__String *key = (__String*)allKeys->getObjectAtIndex(i);
Ref *obj = result->objectForKey(key->getCString());
log("key = %s", key -> getCString());
if (dynamic_cast<__String *>(obj))
{log("value = %s", dynamic_cast<__String *>(obj) -> getCString());
}
else if (dynamic_cast<__Integer *>(obj))
{log("value = %d", dynamic_cast<__Integer *>(obj) -> getValue());
}
else if (dynamic_cast<__Double *>(obj))
{log("value = %f", dynamic_cast<__Double *>(obj) -> getValue());
}
}
}
break;
case cn::sharesdk::C2DXResponseStateCancel:
{log("Cancel");
}
break;
default:
break;
}
}