帮助文档

1     易接COCOS JS使用准备

易接官网http://www.1sdk.cn/download.html下载SDK

解压后的目录及结构 JS部分的说明如下

                                                                           (图2.6

1.1 拷贝资源

1根据游戏使用的COCOS JS的版本, 选择2.x3.x文件夹下内容拷贝到游戏对应frameworks\runtime-src\Classes目录下

2在游戏的frameworks\runtime-src\proj.android目录下新建yijie文件夹,根据游戏frameworks\runtime-src\proj.android\jni\Application.mkAPP_STL值的类型,选择

对应文件夹下(图2.6标注的C部分)内容拷贝到新建的yijie文件夹下

32.6标注的D部分拷贝到游戏的frameworks\runtime-src\proj.android\libs目录下,如果没有libs目录,请新建此文件夹

42.6标注的E部分拷贝到游戏的src目录下

1.2 添加易接提供的Activity引用

在游戏frameworks\runtime-src\proj.android\AndroidManifest.xml文件中添加由易接提供如下代码:

1.  <service  

2.  android:name="com.snowfish.a.a.s.ABGSvc"  

3.  android:enabled="true"  

4.  android:process="com.snowfish.a.a.bg">  

5.  <intent-filter>  

6.  <actionandroid:name="com.snowfish.a.a.s.ABGSvc"/>  

7.  <categoryandroid:name="android.intent.category.DEFAULT"/>  

8.  </intent-filter>  

9.  </service>  

10. <meta-data  

11. android:name="com.snowfish.customer"  

12. android:value="SNOWFISH">  

13. </meta-data>  

14. <meta-data  

15. android:name="com.snowfish.channel"  

16. android:value="SNOWFISH">  

17. </meta-data>  

18. <meta-data  

19. android:name="com.snowfish.sdk.version"  

20. android:value="2">  

21. </meta-data>  

22. <meta-data  

23. android:name="com.snowfish.appid"  

24. android:value="KEY">  

25. </meta-data>  

26. <meta-data  

27. android:name="com.snowfish.channelid"  

28. android:value="{4ff036a1-3254eafe}">//此参数不做修改,保持默认就行,打包会自动替换  

29. </meta-data> 

标红处的KEY值是由易接用户中心申请获取格式如:{12345678-12345678}

1.3 修改 Application

在游戏frameworks\runtime-src\proj.android\AndroidManifest.xml文件中修改Application

  1若无自定义Applicatiion,则修改AndroidManifest.xmlApplication如下:

<applicationandroid:name="com.snowfish.cn.ganga.helper.SFOnlineApplication"/>

2)若开发者自定义的Application。则自定义Application需要继承com.snowfish.cn.ganga.helper.SFOnlineApplicationAndroidManifest.xml修改如下:

1.   <applicationandroid:name="自定义Application"/>  

1.4 添加易接需要的use-permision

在游戏frameworks\runtime-src\proj.android\AndroidManifest.xml中添加use-permision如下:

1.   <uses-permissionandroid:name="android.permission.INTERNET"/>  

2.   <uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE"/>  

3.   <uses-permissionandroid:name="android.permission.ACCESS_WIFI_STATE"/>  

4.   <uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/>  

5.   <uses-permissionandroid:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>  

6.   <uses-permissionandroid:name="android.permission.READ_EXTERNAL_STORAGE"/>  

7.   <uses-permissionandroid:name="android.permission.SYSTEM_ALERT_WINDOW"/>  

8.   <uses-permissionandroid:name="android.permission.READ_PHONE_STATE"/>  

9.   <uses-permissionandroid:name="android.permission.GET_TASKS"/>  

10.  <uses-permissionandroid:name="android.permission.WAKE_LOCK"/>  

11.  <uses-permissionandroid:name="android.permission.CHANGE_NETWORK_STATE"/>

1.5 增加易接闪屏Activity

继承com.snowfish.cn.ganga.helper.SFOnlineSplashActivity并将该Activity设置为程序启动时的Activity

1.   publicclassMySplashActivityextendsSFOnlineSplashActivity {  

2.       publicintgetBackgroundColor() {  

3.       // 返回闪屏的背景颜色  

4.           returnColor.WHITE;  

5.           }  

6.       @Override  

7.       publicvoidonSplashStop() {  

8.       // 闪屏结束进入游戏  

9.       Intent intent = newIntent(this, MainActivity.class);  

10.          startActivity(intent);  

11.          this.finish();  

12.      }  

13.  }  

AndroidManifest.xml中关于该Activity的声明,要声明为启动Activity

1.   <activity  

2.   android:name=" com.snowfish.cn.ganga.helper.MySplashActivity"  

3.   android:configChanges="orientation|keyboardHidden|screenSize"  

4.   android:screenOrientation="portrait">  

5.   <intent-filter>  

6.   <actionandroid:nameactionandroid:name="android.intent.action.MAIN"/>  

7.   <categoryandroid:namecategoryandroid:name="android.intent.category.LAUNCHER"/>  

8.   </intent-filter>  

9.   </activity>  

注意:闪屏的横竖屏需要cp自己在AndroidManifest.xml中的闪屏activity中,设置一下screenOrientation属性。

1.6 修改Android.mk

在游戏frameworks\runtime-src\proj.android\jni\Android.mk中增加

1.  LOCAL_WHOLE_STATIC_LIBRARIES += YijieCocosJSStatic  

2.  LOCAL_SRC_FILES += ../../Classes/yijie.cpp  

3.  LOCAL_C_INCLUDES +=$(LOCAL_PATH)/../yijie/android   \  

4.                          $(LOCAL_PATH)/../yijie/include  

5.  $(call import-module,yijie/android)  

修改后如下图

1.7 添加yijiesdkconst.js

根据cocosjs版本选择合适的修改方式。

acocosjs 3.x版本:

修改游戏project.json文件,"jsList" 数组中增加"src/yijiesdkconst.js"

修改后如下图:

bcocosjs 2.x版本

       修改游戏cocos2d.js文件(如果没有此文件,需要根据AppDelegate.cpp文件中调用.js文件为准),添加”src/yijiesdkconst.js”,修改后如下图所示:

1.8 拷贝易接SDK资源及修改NDK_MODULE_PATH

根据cocosjs版本选择合适的修改方式。

acocosjs 3.x版本:

  修改frameworks\runtime-src\proj.android\build-cfg.json文件增加

"ndk_module_path":数组中增加

{
  ,
""
}

"copy_resources":数组中增加
{
"from": "yijie/asssets/Sonnenblume",
"to": "Sonnenblume"
}

修改后如下图。

bcocosjs 2.x版本:

       修改proj.android\build_native.sh文件,增加内容:

       YIJIE_RESROUCE_ROOT="$DIR/yijie/asssets/Sonnenblume"

       cp -rf "$YIJIE_RESROUCE_ROOT" "$APP_ANDROID_ROOT"/assets

       ${APP_ROOT}/proj.android:

修改后如图:

     

1.9 修改AppDelegate.cpp文件

AppDelegate.cppsc->start();之前添加如下代码:

#include "yijie.hpp"

sc->addRegisterCallback(register_all_yijie);

修改之后效果图如下: