MobLink For Cocos2dx

本插件是基于MobLink 对Cococs2dx进行插件扩充支持。目的是方便Cococs2dx开发者更方便地集成使用MobLink。

当前支持的 MobLink 版本

• iOS v2.2.0
• Android v2.2.0

集成文档

• 快速集成文档

---

下载并导入MobLink

下载Cocos2dx-For-MobLink,下载完成后打开项目,将/Classes/C2DXMobLink文件夹复制到您的cocos2dx项目/Classes目录下

Android端接入

1. 拷贝demo项目中C2DXMobLinkH和libmoblinkbridge.a文件到您自己的项目proj.android-studio\app\jni文件夹下（注意清与您Android.mk文件同目录）

2. 在您的Android.mk文件中加入对Cocos2dxBridge module的jni部分(Android.mk文件）的引用，即是引入moblik_bridge静态库。在您的Android.mk文件中添加如下代码：

LOCAL_PATH := $(call my-dir)

#引入预编译编译的.a文件，此libmoblinkbridge.a的abi为 armeabi-v7a，
#如果需要其他平台的libmoblinkbridge.a文件 可以去proj.android-studio\Cocos2dxBridge\jni 下添加相关的abi参数并执行ndk-build生成相应的.a文件。
include $(CLEAR_VARS)
LOCAL_MODULE := libmoblinkbridge
LOCAL_SRC_FILES := libmoblinkbridge.a
LOCAL_EXPORT_C_INCLUDES  := $(LOCAL_PATH)/C2DXMobLinkH
include $(PREBUILT_STATIC_LIBRARY)
------
#您自己的mk内容

如果您不太明白怎么配置，可以去参考demo的Android.mk文件。 3.拷贝MobLink-CocosBridge.jar （demo工程的proj.android-studio\app\libs）到您项目的libs下并引用

dependencies {
   compile files('libs/MobLink-CocosBridge.jar')
}

4. 配置AndroidManiFest.xml文件

请参考原生Android平台的配置文件中的， 配置AndroidManiFest.xml文件部分

http://wiki.mob.com/moblinkandroidgradle3-x/

5. 修改AppActivity，重写onNewIntent方法

public class AppActivity extends Cocos2dxActivity {

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        setIntent(intent);
        // 游戏处于后台时，需要通过该方法触发场景还原
        MobLink.updateNewIntent(getIntent(), this);
    }
}

iOS端接入

对于iOS,还需要对Xcode项目进行一些配置 1.(重要) 配置MobAppKey以及MobAppSecret 在Xcode项目对应的info.plist文件中设置应MobLink官网获得的key和secret

2.添加MobLink库 在本demo项目的proj.ios_mac文件夹中找到SDK文件夹,将其添加到您的Xcode项目中(内含两个framework)

3.添加系统依赖库

选择项目Target-Build Phases-Link Binary With Libraries，然后选择“+”进行添加系统库：

libsqlite3 libz1.2.5 libstdc++ libicucore

4.配置Universal Link 以及 URL Scheme i. URL Scheme 项目中需要配置URL Scheme以用于场景恢复时跳转到应用中（这里的scheme要唯一确定，不要与其他应用一致，建议使用项目名称作为scheme）。请参考下图配置您自己的URL Scheme：

ii.Universal Link 然后在项目中配置Universal Link，请务必填写后台生成的Universal Link地址 (建议直接从管理后台拷贝)参考下图：

上述步骤其实与原生iOS集成MobLink一致,具体可参考iOS快速集成中的第三点的第1、2小点。

添加代码

1.设置场景回调

i.自行构建回调,自行处理得到的场景参数scene

void sceneHandler(C2DXMobLinkScene *scene)
{
    //自行处理取得的scene
    log("path = %s", scene->path.c_str());
    log("source = %s", scene->source.c_str());
    __Dictionary *custom = scene->getCustomParams();

    std::string content;
    content += "path:"; content += scene->path.c_str(); content += "\n";
    content += "source:"; content += scene->source.c_str(); content += "\n";
    content += "params:\n";

    DictElement *element;
    CCDICT_FOREACH(custom, element)
        {
            const char *key = element -> getStrKey();
            __String *obj = (__String*)element -> getObject();
            log("key = %s, value = %s",key,obj -> getCString());
            content += key; content += ":"; content += obj->getCString(); content += "\n";
        }

    MessageBox(content.c_str(), "得到场景恢复回调");
}

ii.将回调传入

//设置场景恢复之回调
    C2DXMobLink::setSceneRestoreCallBack(sceneHandler);

2.获取Mobid

i.自行构建回调,自行处理得到的mobid

void getMobIdHandler(const char * mobid)
{
    log("result - mobid = %s", mobid);
    std::string content = "mobId:";
    content += mobid;
    MessageBox(content.c_str(), "获取MobId的回调");
}

ii.构建场景参数,并传入上述回调

C2DXMobLinkScene *scene = new C2DXMobLinkScene();
scene->path = "the path";
scene->source = "the source";

__Dictionary *customParams = __Dictionary::create();
customParams->setObject(__String::create("999"), "Price");
customParams->setObject(__String::create("1"), "Chapter");
customParams->setObject(__String::create("Dragon Fire"), "ChapterName");
scene->setCustomParams(customParams);

C2DXMobLink::getMobId(scene, getMobIdHandler);

注意:获取到MobId后,应通过分享的方式将带有Mobid的链接分享出去 对于分享,我们更建议使用Cocos2dx For ShareSDK

如何Build Demo For Android

1.使用git工具下载代码

https://github.com/MobClub/Cocos2dx-For-MobLink.git

2.复制cocos2d目录到项目/根目录下, 建议使用cocos版本为3.8.1

3.使用AndroidStudio打开proj.android-studio项目

4.build 成功后，安装apk到手机上

5.在不同的平台(如微信/浏览器)分享以下链接，然后访问链接:

http://f.moblink.mob.com/test/demo/a/?mobid=up

http://f.moblink.mob.com/test/demo/b/?mobid=up

http://f.moblink.mob.com/test/demo/c/?mobid=up

http://f.moblink.mob.com/test/demo/d/?mobid=up