如何使用ShareSDK实现Cocos2d-x的Android/iOS分享与授权

1,625 阅读7分钟

Cocos2DX 简介

Cocos2d-x是一套成熟的开源跨平台游戏开发框架。其引擎提供了图形渲染、GUI、音频、网络、物理、用户输入等丰富的功能,被广泛应用于游戏开发及交互式应用的构建。引擎的核心采用C++ 编写,支持使用C++、Lua或者JavaScript进行开发。同时Cocos2d-x可以适配IOS、Android、HTML5、Windows和Mac系统。

Cocos2d-x在中国及全球都有一定的市场份额,为了给开发出来的游戏增加知名度,更好的进行营销,社交分享功能是必不可少的。但是所要分享的平台针对全球不同的区域有不同的侧重点,这就需要短时间内接入多个社交平台,但是每个平台的接入时间成本按天计算,多个平台叠加在一起的时间就很不乐观。所以使用Cocos2d-x引擎的开发人员急需一种能够让开发者快速接入授权、分享功能的SDK。

Cocos2d-x集成ShareSDK过程如下:

Android 集成

首先下载官方插件,下载完毕之后需要做如下几步工作

  1. 把ShareSDK的cocos2dx的proj.android-studio项目里的libs包复制到你的项目里,除了armeabi目录不用复制其他都要。

  2. 把ShareSDK的cocos2dx的New-C2DX-For-ShareSDK项目里的Classes目录下的文件都复制到你的项目里的Classes目录下。

  3. 在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
    
  4. 在proj.android-studio工程下,app目录下,build.gradle文件内,寻找到dependencies标签,配置如下的代码

    compile project(':libcocos2dx')
    
  5. 在主activity里(一般在cocos项目的此目录下面:\proj.android-studio\src\org\cocos2dx\cpp\AppActivity.java)的onCreate方法里添加ShareSDKUtils.prepare()方法。

    protected void onCreate(Bundle savedInstanceState){
            super.onCreate(savedInstanceState);
            ShareSDKUtils.prepare();
    }
    
  1. 各个平台的配置方式:平台的配置在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 集成

  1. 将下面红色方框的资源文件拖到Cocos2d-x项目中

  2. 将SDK文件夹拖进项目(下载地址

    注意
    :请务必在上述步骤中选择“Create groups for any added folders”单选按钮组。如果你选择“Create folder references for any added folders”,一个蓝色的文件夹引用将被添加到项目并且将无法找到它的资源。

  3. 添加必须的依赖库

    • libc++.tbd
    • libz.tbd
    • libsqlite3.tbd

各社交平台所需依赖库:

新浪微博:

  • ImageIO.framework
  • Photos.framework

Instagram:

  • AssetsLibrary.framework
  • Photos.framework

美拍:

  • AssetsLibrary.framework

添加依赖库的方法如下

  1. 配置UrlScheme和白名单等,各个社交平台需要的配置可以参考快速集成文档中的URL Scheme和白名单配置项。

  2. 在项目工程的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);
    
  • 分享

  1. 在需要分享操作的代码块中进行构造分享参数,示例如下:

    __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"); /
     
    

    构造分享内容字段参数值请参考:《分享内容字段值表》

  2. 调用分享方法:

    //弹出菜单
    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);
    
  3. 设置分享回调方法 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;
        }
    }