Cocos2d-x 3.0中集成社交分享ShareSDK的詳細(xì)步驟和常見(jiàn)問(wèn)題解決

更新時(shí)間：2014年04月28日 10:23:37 作者：

這篇文章主要介紹了Cocos2d-x 3.0中集成社交分享ShareSDK的詳細(xì)步驟和常見(jiàn)問(wèn)題的解決方法以及需要注意的問(wèn)題,需要的朋友可以參考下

給自己的手機(jī)游戲增加些社交分享功能，有助于游戲宣傳和提升知名度，是一種不錯(cuò)的社交營(yíng)銷(xiāo)手段。國(guó)內(nèi)這方面的第三方插件有不少，比如ShareSDK、友盟分享組件、Baidu分享組件等，之前在研究2.2.2版本時(shí)，集成了ShareSDK這個(gè)組件，這次遷移到Cocos2d-x 3.0rc2依舊選擇集成ShareSDK，這里就來(lái)說(shuō)說(shuō)集成的過(guò)程，遇到的一些問(wèn)題以及解決方法。這里僅以Android平臺(tái)游戲集成為例。

一、功能描述、SDK版本和帳號(hào)準(zhǔn)備

功能大致是這樣的：在游戲中設(shè)置一個(gè)按鈕，點(diǎn)擊這個(gè)按鈕，彈出知名社交平臺(tái)的分享圖標(biāo)集窗口，用戶選擇分享目標(biāo)后，相關(guān)信息分享到對(duì)應(yīng)的社交平臺(tái)。分享結(jié)果通知通過(guò)Toast顯示在屏幕的下方。

這次依舊使用ShareSDK for Android 2.3.7版本（ShareSDK-Android-2.3.7），Cocos2d-x的版本為3.0rc2。

集成前，你需要有一個(gè)基于Cocos2d-x 3.0rc2的可運(yùn)行的Android平臺(tái)游戲project，我們的集成就基于該project，這里我們的project名為GameDemo，GameDemo的源碼結(jié)構(gòu)大致是：

復(fù)制代碼代碼如下:

GameDemo/
    – Classes/
    – proj.android/
    – Resources/
    – cocos2d/
    – CMakeLists.txt
    – … …

使用ShareSDK前，你需要在各大主流社交平臺(tái)（微信、微博）申請(qǐng)開(kāi)發(fā)者帳號(hào)以及游戲接入權(quán)限(app_key、app_secret)等，當(dāng)然在ShareSDK站點(diǎn)也應(yīng)該有自己的帳號(hào)和應(yīng)用AppKey，這些申請(qǐng)的審核需要幾個(gè)工作日，甚至更長(zhǎng)。

二、ShareSDK集成步驟

按照ShareSDK官方manual說(shuō)法，Cocos2d-x集成ShareSDK有三種方式，之前在Cocos2d-x 2.2.2引擎中采用的是專(zhuān)用組件集成的方式，該組件(C2DXShareSDKSample)可以在這里下載（https://github.com/ShareSDKPlatform/C2DXShareSDKSample，該組件近期已經(jīng)fix了我之前發(fā)現(xiàn)的bug）。

1.jar包集成

這次我們主要做微博、微信的社交分享，因此只需要微博、微信相關(guān)jar包。在C2DXShareSDKSample/proj.android/libs下，我們找到以下幾個(gè)jar包：

復(fù)制代碼代碼如下:

  -rw-rw-r– 1 tonybai tonybai  97K  4月  8 18:10 mframework.jar
  -rw-rw-r– 1 tonybai tonybai 112K  4月  8 17:39 ShareSDK-Core-2.3.7.jar
  -rw-rw-r– 1 tonybai tonybai  19K  4月  8 17:39 ShareSDK-SinaWeibo-2.3.7.jar
  -rw-rw-r– 1 tonybai tonybai 4.3K  4月  8 17:39 ShareSDK-Wechat-2.3.7.jar
  -rw-rw-r– 1 tonybai tonybai  29K  4月  8 17:39 ShareSDK-Wechat-Core-2.3.7.jar
  -rw-rw-r– 1 tonybai tonybai 4.6K  4月  8 17:39 ShareSDK-Wechat-Favorite-2.3.7.jar
  -rw-rw-r– 1 tonybai tonybai 4.4K  4月  8 17:39 ShareSDK-Wechat-Moments-2.3.7.jar

把這些jar包文件Copy到GameDemo/proj.android/libs下。

2. 配置文件與資源部分集成

修改GameDemo/proj.android/AndroidManifest.xml文件，在application標(biāo)簽下，添加如下Activity標(biāo)簽：

復(fù)制代碼代碼如下:

        <activity
            android:name="cn.sharesdk.framework.ShareSDKUIShell"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:screenOrientation="portrait"
            android:theme="@android:style/Theme.Translucent.NoTitleBar"
            android:windowSoftInputMode="stateHidden|adjustResize" >
    </activity>
    <activity
            android:name=".wxapi.WXEntryActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:exported="true"
            android:screenOrientation="portrait"
            android:theme="@android:style/Theme.Translucent.NoTitleBar" />

將C2DXShareSDKSample/proj.android/res下的如下目錄中的文件復(fù)制到GameDemo/proj.android/res下：

復(fù)制代碼代碼如下:

   drawable-hdpi/  drawable-ldpi/  drawable-mdpi/ 
   drawable-xhdpi/  layout/  values/  values-en/

注意，類(lèi)似icon.png這種文件就不要復(fù)制了，自己做一下判斷就好。

3. C++部分代碼集成

將C2DXShareSDKSample/Classes下的C2DXShareSDK文件夾Copy到GameDemo/Classes下面。

由于Cocos2d-x 3.0rc2的類(lèi)命名發(fā)生了變化，我們需要對(duì)C2DXShareSDK中使用到的引擎中的類(lèi)名以及方法名進(jìn)行修改。但實(shí)際上Cocos2d-x 3.0rc2考慮到了一些兼容性的問(wèn)題，大部分名字通過(guò)cocos2d/cocos/deprecated/CCDeprecated.h中定義的typedef得以保留，雖然這些名字已經(jīng)被建議deprecated了。rc2中CCObject被改名為Ref了，這個(gè)我們需要手工在C2DXShareSDK進(jìn)行修改。

另外ShareSDK組件在實(shí)現(xiàn)時(shí)大量使用了CCDictionary、CCArray和CCString，而這三個(gè)類(lèi)在Cocos2d-x 3.0rc2中均被deprecated了，但我們依然可以使用，所以我們可以不做修改。但以后隨著cocos2d-x版本的演進(jìn)，這些類(lèi)很可能被徹底移除出引擎，我們就需要重新使用其替代品進(jìn)行實(shí)現(xiàn)了。

此外我們還需要手工修改一下C2DXShareSDK/Android/JSON/CCJSONConverter.cpp文件中的getObjJson方法，因?yàn)閞c2中CCDictionary、CCString、CCArray這些類(lèi)的真實(shí)名稱都已經(jīng)換成了__Dictionary、__String 和__Array，CCDictionary、CCString、CCArray只是些typedef，因此要像下面這樣做些修改(如果你是集成 cocos2d-x 2.x.x版本，則無(wú)需做下面修改)：

復(fù)制代碼代碼如下:

cJSON * CCJSONConverter::getObjJson(Ref * obj)
{
    std::string s = typeid(*obj).name();
    if(s.find("__Dictionary")!=std::string::npos){
        cJSON * json = cJSON_CreateObject();
        convertDictionaryToJson((CCDictionary *)obj, json);
        return json;
    }else if(s.find("__Array")!=std::string::npos){
        cJSON * json = cJSON_CreateArray();
        convertArrayToJson((CCArray *)obj, json);
        return json;
    }else if(s.find("__String")!=std::string::npos){
        CCString * s = (CCString *)obj;
        cJSON * json = cJSON_CreateString(s->getCString());
        return json;
    }else if(s.find("CCNumber")!=std::string::npos){
        CCNumber * n = (CCNumber *)obj;
        cJSON * json = cJSON_CreateNumber(n->getDoubleValue());
        return json;
    }else if(s.find("CCNull")!=std::string::npos){
        cJSON * json = cJSON_CreateNull();
        return json;
    }
    CCLog("CCJSONConverter encountered an unrecognized type");
    return NULL;
}

CCNumber和CCNull是ShareSDK組件自己實(shí)現(xiàn)的類(lèi)名，這里無(wú)需修改。

接下來(lái)我們需要在AppDelegate.cpp中對(duì)ShareSDK做初始化了：

復(fù)制代碼代碼如下:

bool AppDelegate::applicationDidFinishLaunching() {
    … …
    initShareSDK();
    … ..
}

void AppDelegate::initShareSDK()
{
    // sina weibo
    CCDictionary *sinaConfigDict = CCDictionary::create();
    sinaConfigDict->setObject(CCString::create("YOUR_WEIBO_APPKEY"), "app_key");
    sinaConfigDict->setObject(CCString::create("YOUR_WEBIO_APPSECRET"), "app_secret");
    sinaConfigDict->setObject(CCString::create("http://www.sharesdk.cn"), "redirect_uri");
    C2DXShareSDK::setPlatformConfig(C2DXPlatTypeSinaWeibo, sinaConfigDict);

    // wechat
    CCDictionary *wcConfigDict = CCDictionary::create();
    wcConfigDict->setObject(CCString::create("YOUR_WECHAT_APPID"), "app_id");
    C2DXShareSDK::setPlatformConfig(C2DXPlatTypeWeixiSession, wcConfigDict);
    C2DXShareSDK::setPlatformConfig(C2DXPlatTypeWeixiTimeline, wcConfigDict);
    C2DXShareSDK::setPlatformConfig(C2DXPlatTypeWeixiFav, wcConfigDict);

C2DXShareSDK::open(CCString::create("YOUR_SHARESDK_APPKEY"), false);
}

在Share按鈕的事件回調(diào)函數(shù)中調(diào)用ShareSDK的接口進(jìn)行社交平臺(tái)分享：

復(fù)制代碼代碼如下:

void GameScene::menuShareCallback(Ref* sender)
{
Dictionary *content = Dictionary::create();

    content->setObject(String::create("ShareSDK for Cocos2d-x 3.0rc2社交分享測(cè)試。")
                        , "content");
    content->setObject(String::create("ShareSDK分享測(cè)試"), "title");
    content->setObject(String::create("http://tonybai.com"), "titleUrl");
    content->setObject(String::create("http://tonybai.com"), "url");
    content->setObject(String::create("Tony Bai"), "site");
    content->setObject(String::create("http://tonybai.com"), "siteUrl");
    content->setObject(String::createWithFormat("%s", YOUR_LOCAL_IMAGE_PATH)
                       , "image");
    content->setObject(String::createWithFormat("%d", C2DXContentTypeNews)
                       , "type");

C2DXShareSDK::showShareMenu(NULL, content, CCPointMake(100, 100),
C2DXMenuArrowDirectionLeft, shareResultHandler);
}

void shareResultHandler(C2DXResponseState state,
                        C2DXPlatType platType,
                        Dictionary *shareInfo,
                        Dictionary *error)
{
    AppDelegate *app = (AppDelegate*)Application::getInstance();
    switch (state) {
        case C2DXResponseStateSuccess:
            CCLog("Share Ok");
            app->showShareResultToast("分享成功");
            break;
        case C2DXResponseStateFail:
            app->showShareResultToast("分享失敗");
            CCLog("Share Failed");
            break;
        default:
            break;
    }
}

showShareResultToast實(shí)現(xiàn)如下：

復(fù)制代碼代碼如下:

void AppDelegate::showShareResultToast(const char *msg)
{
    JniMethodInfo t;
    if (JniHelper::getStaticMethodInfo(t, "YOUR_ACTIVITY_NAME",
        "showShareResultToast", "(Ljava/lang/String;)V")) {
        jstring jmsg = t.env->NewStringUTF(msg);
        t.env->CallStaticVoidMethod(t.classID, t.methodID, jmsg);
        if (t.env->ExceptionOccurred()) {
            t.env->ExceptionDescribe();
            t.env->ExceptionClear();
            return;
        }
        t.env->DeleteLocalRef(t.classID);
    }
}

4. Java部分代碼集成

在GameDemo/proj.android/src下面建立cn/sharesdk路徑，將C2DXShareSDKSample /proj.android/src/cn/sharesdk下的onekeyshare和ShareSDKUtils.java Copy到GameDemo/proj.android/src/cn/sharesdk下面。

將ShareSDK-Android-2.3.7.zip解壓后的ShareSDK for Android/Src/wxapi Copy到GameDemo/proj.android/src/com.tonybai.game/下。

修改GameDemo/proj.android/src/com.tonybai.game/GameDemoActivity.java文件：

復(fù)制代碼代碼如下:

import android.widget.Toast;
import cn.sharesdk.ShareSDKUtils;
…

public class GameDemoActivity extends Cocos2dxActivity {

private static Context context;

    private static Handler notifyHandler = new Handler() {
        public void handleMessage(Message msg) {
            switch (msg.what) {
                case 1:
                    String message = (String) msg.obj;
                    Toast.makeText(context, message,
                      Toast.LENGTH_SHORT).show();
                    break;
                default:
                    break;
            }
        }
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        context = this;
        ShareSDKUtils.prepare();
        ShareSDKUtils.initSDK("YOUR_SHARESDK_APPKEY", true);
    }

    public static void showShareResultToast(String result) {
        Message msg = new Message();
        msg.what = 1;
        msg.obj = result;
        notifyHandler.sendMessage(msg);
    }

    @Override
    public void onDestroy() {
        ShareSDKUtils.stopSDK();
        super.onDestroy();
    }
}

三、問(wèn)題與解決方法

按照上面的集成方法修改后，通過(guò)cocos編譯app，在模擬器運(yùn)行GameDemo，點(diǎn)擊Share，理論上屏幕下方會(huì)出現(xiàn)ShareSDK的分享窗口，選擇“新浪微博”圖標(biāo)，會(huì)打開(kāi)“圖文分享”內(nèi)容窗口，點(diǎn)擊窗口右上角的“分享”即可。

【問(wèn)題1】“圖文分享”窗口內(nèi)容可編輯，并且總是彈出軟鍵盤(pán)，影響體驗(yàn)。

期望：內(nèi)容不可編輯，默認(rèn)不彈出軟鍵盤(pán)
解決方法：
打開(kāi)proj.android/src/cn/sharesdk/onekeyshare/EditPage.java，做如下修改：

將窗口的軟輸入方式默認(rèn)改為SOFT_INPUT_STATE_HIDDEN。

復(fù)制代碼代碼如下:

      public void setActivity(Activity activity) {
        super.setActivity(activity);
        if (dialogMode) {
            activity.setTheme(android.R.style.Theme_Dialog);
            activity.requestWindowFeature(Window.FEATURE_NO_TITLE);
        }
        activity.getWindow().setSoftInputMode(
                   //WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE);
                   WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN);//default: hidden
    }

在initPageView中增加一行：etContent.setKeyListener(null)。讓窗口內(nèi)容無(wú)法修改。

復(fù)制代碼代碼如下:

    private void initPageView() {
         … …
        // 文字輸入?yún)^(qū)域
        etContent = new EditText(getContext());
        etContent.setGravity(Gravity.LEFT | Gravity.TOP);
        etContent.setBackgroundDrawable(null);
        etContent.setText(String.valueOf(reqData.get("text")));
        etContent.setKeyListener(null);//make the edittext uneditable
        etContent.setLayoutParams(lpEt);
        … …
    }

【問(wèn)題2】向微博分享，點(diǎn)擊“分享”后，過(guò)一會(huì)程序異常停止。

原因分析：
通過(guò)調(diào)試觀察，發(fā)現(xiàn)ShareSDK在解析從Weibo收到的Json包時(shí)出現(xiàn)內(nèi)存違法訪問(wèn)。具體位置是在解析一個(gè)數(shù)組對(duì)象時(shí)出現(xiàn)的問(wèn)題。 ShareSDK用CCArray來(lái)存儲(chǔ)Json中的數(shù)組對(duì)象。該問(wèn)題在cocos2d-x 2.2.2版本中不會(huì)出現(xiàn)，但在cocos2d-x 3.0rc2版本中會(huì)出現(xiàn)。經(jīng)代碼對(duì)比發(fā)現(xiàn)，3.0rc2版本中的CCArray的實(shí)現(xiàn)與2.2.2 CCArray實(shí)現(xiàn)有很大不同，似乎是做了較大重構(gòu)，暫不能確定是否是3.0rc2版本中CCArray實(shí)現(xiàn)的bug。

解決方法：由于后續(xù)的分享結(jié)果通知成功與否只需要根據(jù)分享的狀態(tài)來(lái)決定，因此我們只需解析出"status"、“action”和“platform” 這三個(gè)CCNumber類(lèi)型字段的值即可。CCArray類(lèi)型的對(duì)象我們并不需要，因此我們只需繞過(guò)對(duì)Array類(lèi)型字段的解析和存儲(chǔ)即可，修改如下：

復(fù)制代碼代碼如下:

// Classes/C2DXShareSDK/Android/JSON/CCJSONConverter.cpp

void CCJSONConverter::convertJsonToDictionary(cJSON *json, CCDictionary *dictionary)
{
    dictionary->removeAllObjects();
    cJSON * j = json->child;
    while (j) {
        if (j->type == cJSON_Number) {
            Ref * obj = getJsonObj(j);
            dictionary->setObject(obj, j->string);
        }
        j = j->next;
    }
}

四、其他

在使用ShareSDK做社交分享時(shí)，注意下面兩個(gè)現(xiàn)象：
1) 第一次進(jìn)行微博或微信分享時(shí)，會(huì)打開(kāi)授權(quán)頁(yè)面，授權(quán)后才能分享成功；
2) 微信分享窗口只有在手機(jī)聯(lián)網(wǎng)狀態(tài)下才能打開(kāi)。如果手機(jī)無(wú)法聯(lián)網(wǎng)，那微信好友、朋友圈和收藏分享將無(wú)法打開(kāi)分享窗口，也不會(huì)有什么提示。

您可能感興趣的文章: