‹ LeadBolt Doc Home

LeadBolt 集成指南

For the Javascript version of cocos2d-x v3.x - (all other versions)

Integration

在您确保正确安装了 SDKBOX installer 的情况下,运行下面的命令来集成 SDKBOX LeadBolt 插件。

$ sdkbox import leadbolt

~~从 China 服务器下载~~ 服务器已停止

如果你在中国, 并且下载插件的速度比较慢, 可以尝试使用位于中国的服务器来下载, 查询插件, 使用方法为在你的 sdkbox import 后加 --server china 及可, 比如:

sdkbox import xxx  --server china

xxx 为你的插件名字

重点注意事项

如果您升级到了 Xcode7, 则需要以下额外步骤来确保插件工作正常:

禁用应用程序安全传输策略

添加以下项到 plist:

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

添加后的文件内容看起来就像这样:

禁止 Bitcode 支持

您必须禁止 Bitcode 的支持,否则将会编译失败。

游戏全屏配置

如果您的游戏不同时支持横竖屏,则必须在 Xcode 中选中 Requires full screen,否则将不会通过 Apple 的审核。

canOpenURL 白名单

取决于您使用哪些插件。需要在 info.plistLSApplicationQueriesSchemes 下添加名单。

JSON 配置

SDKBOX Installer 将会自动在您的 sdkbox_config.json 中插入一份配置样例。请修改这份配置样例,使其能用于您自己的 app 。

这里有一个 LeadBolt 配置的例子,您需要用您自己的 LeadBolt 帐号信息替换 <api_key><name>

{
    "ios": {
        "LeadBolt": {
            "api_key": "8uc8Kd5b6LoyJZCAsFUCY2sWmSJkXZ6c",
            "ads": {
                "directdeal": {
                    "name": "inapp"
                },
                "rewardedvideo": {
                    "name": "video"
                }
            }
        }
    },
    "android": {
        "LeadBolt": {
            "api_key": "is2byYEVjbXiFjVjaYIt6sM4aEIqMWZ3",
            "ads": {
                "directdeal": {
                    "name": "inapp"
                },
                "rewardedvideo": {
                    "name": "video"
                }
            }
        }
    }
}

使用

注册 Javascript 函数

您需要在使用之前,在 cocos2d-x 中注册所有的 LeadBolt JS 函数。

#include "PluginLeadBoltJS.hpp"
#include "PluginLeadBoltJSHelper.h"
sc->addRegisterCallback(register_all_PluginLeadBoltJS);
sc->addRegisterCallback(register_all_PluginLeadBoltJS_helper);

初始化 Leadbolt

通过在您的代码合适的位置调用 init() 方法来初始化这个插件。我们建议您在 app.js 中进行初始化。举例如下:

sdkbox.PluginLeadBolt.init();

缓存广告数据

sdkbox.PluginLeadbolt.loadModuleToCache("directdeal");
sdkbox.PluginLeadbolt.loadModuleToCache("rewardedvideo");

提示:LeadBolt 为了更好的用户体验,在使用前它会缓存广告数据。一旦缓存广告数据完成,您将能够看到这个广告。当缓存仍在进行中,广告是不可见的。

加载/显示广告

sdkbox.PluginLeadbolt.loadModule("directdeal");
sdkbox.PluginLeadbolt.loadModule("rewardedvideo");

判断广告是否缓存完成

sdkbox.PluginLeadbolt.isAdReady("directdeal");
sdkbox.PluginLeadbolt.isAdReady("rewardedvideo");

捕捉 LeadBolt 事件(可选)

该插件允许您捕捉 Leadbolt 广告事件,使您能可以根据返回的内容执行相应的操作。一个简单的例子如下:

var plugin = sdkbox.PluginLeadBolt
plugin.setListener({
  onModuleLoaded: function(placement) {},
  onModuleClosed: function(placement) {},
  onModuleClicked: function(placement) {},
  onModuleCached: function(placement) {},
  onModuleFailed: function(placement, error, cached) {},
  onMediaFinished: function(viewCompleted) {}
})
plugin.init();

API Reference

Methods

sdkbox.PluginLeadBolt.init();

initialize the plugin instance.

sdkbox.PluginLeadBolt.setListener(listener);

Set listener to listen for leadbolt events

sdkbox.PluginLeadBolt.loadModuleToCache(placement, userData);

Cache Ad with name @placement (referenced from your json config file)

sdkbox.PluginLeadBolt.isAdReady(placement);

Check if Ad with name @placement (referenced from your json config file) is available for display

sdkbox.PluginLeadBolt.loadModule(placement, userData);

Load/Display Ad with name @placement (referenced from your json config file)

sdkbox.PluginLeadBolt.setAgeRange(range);
sdkbox.PluginLeadBolt.setGender(gender);

You can increase your App’s performance by optionally including the additional information above. This allows selected premium advertisers to display their Ads to your users. To pass this additional information, use the following methods BEFORE calling loadModuleToCache.

Allowed values:

  • for age range are: "13-17", "18-25", "26-35", "36-45", "46+"

  • for gender are: "Male", "Female"

Listeners

onModuleLoaded(placement);

Notifies the delegate that the module has finished loading

onModuleClosed(placement);

Notifies the delegate that the module has closed

onModuleClicked(placement);

Notifies the delegate that the module has clicked

onModuleCached(placement);

Notifies the delegate that the module has cached

onModuleFailed(placement, error, iscached);

Notifies the delegate that the module has fail

onMediaFinished(viewCompleted);

Notifies the delegate that the rewarded video has finished playing.

手动集成

如果 SDKBOX 安装器 安装插件失败了,那么需要手动集成插件.如果安装器安装插件成功了,那么不需要,也没必要,按文档再手动集成一次.

下面列出的的步骤一般很少用到.如果你按下面的步骤完成了集成,请在完成集成后,再按步骤检查一次.

iOS 平台手动集成

拖拽下列 framework 从 Leadbolt 插件包的 plugins/ios 目录到您的 Xcode 工程中,在添加 frameworks 的时候,请勾选 Copy items if needed

sdkbox.framework

PluginLeadBolt.framework

AdSupport.framework

AVFoundation.framework

CoreMedia.framework

CoreTelephony.framework

StoreKit.framework

SystemConfiguration.framework

plugin/jsbindings 文件夹中所有的头文件和源文件都拷贝到你的工程的 Classes 文件夹中.

把刚刚拷贝的文件拖动到 Xcode 中或使用 File -> Add files to... 来添加.

Android 手动集成

SDKBox 支持三种 Android 工程, command-line, eclipseAndroid Studio.

拷贝文件

从插件安装包中的 plugin/android/libs 目录拷贝下列 jar 文件到您的工程的 proj.android/libs 目录。

AppTracker.jar

PluginLeadBolt.jar

sdkbox.jar

拷贝 jni 库

plugin/android/jni/ 拷贝并覆盖 <your_project_root>/jni/ 目录.

编辑 AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<activity
    android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
    android:name="com.apptracker.android.module.AppModuleActivity"
    android:hardwareAccelerated="false">

编辑 Android.mk

编辑 proj.android/jni/Android.mk

LOCAL_WHOLE_STATIC_LIBRARIES 添加额外的库:

LOCAL_WHOLE_STATIC_LIBRARIES += PluginLeadBolt
LOCAL_WHOLE_STATIC_LIBRARIES += sdkbox

在所有 import-module 语句之前添加一条 call 语句:

$(call import-add-path,$(LOCAL_PATH))

在最后添加额外的 import-module 语句:

$(call import-module, ./sdkbox)
$(call import-module, ./pluginleadbolt)

这意味着您的语句顺序看起来像是这样:

$(call import-add-path,$(LOCAL_PATH))
$(call import-module, ./sdkbox)
$(call import-module, ./pluginleadbolt)

Note: 如果您使用的是 cocos2d-x 预编译库,那么保证这些语句在已有的 $(call import-module,./prebuilt-mk) 语句之上非常重要。

编辑 Application.mk (只限 Cocos2d-x v3.0 到 v3.2 版本)

编辑 proj.android/jni/Application.mk 保证 APP_STL 的定义正确。如果 Application.mk 包含了 APP_STL := c++_static 语句,那么这条语句应该被改为:

APP_STL := gnustl_static

plugin/jsbindings 文件夹中所有的头文件和源文件都拷贝到你的工程的 Classes 文件夹中.

把你刚刚拷贝的 .cpp 文件添加到 Android.mk 文件的的 LOCAL_SRC_FILES 项.比如

LOCAL_SRC_FILES := hellocpp/main.cpp \
                  ../../Classes/AppDelegate.cpp \
                  ../../Classes/HelloWorldScene.cpp \
                                    ../../Classes/NewSourceFile.cpp

修改 AppActivity.java

插件版本 >= 2.4.0.3

  1. 找到 AppActivity.java 文件
find . -name "AppActivity.java"
  1. extends Cocos2dxActivity 替换为 extends com.sdkbox.plugin.SDKBoxActivity

以下是 AppActivity.java 不同版本的引擎所在的目录:

cpp
  - proj.android/src/org/cocos2dx/cpp/AppActivity.java
  - proj.android-studio/app/src/org/cocos2dx/cpp/AppActivity.java
  - proj.android/app/src/org/cocos2dx/cpp/AppActivity.java ( from cocos2d-x 3.17)

lua
  - frameworks/runtime-src/proj.android/src/org/cocos2dx/lua/AppActivity.java
  - frameworks/runtime-src/proj.android-studio/app/src/org/cocos2dx/lua/AppActivity.java
  - frameworks/runtime-src/proj.android/app/src/org/cocos2dx/lua/AppActivity.java (from cocos2d-x 3.17)

js
  - frameworks/runtime-src/proj.android/src/org/cocos2dx/javascript/AppActivity.java
  - frameworks/runtime-src/proj.android/app/src/org/cocos2dx/javascript/AppActivity.java ( from cocos2d-x 3.17)

插件版本 < 2.4.0.3

Note: 当你使用 cocos2d-x 源代码时,不同的版本中 Cocos2dxActivity.java 文件的位置也不同。一个确定该文件位置的方法是查看 proj.android/project.properties 。比如:

android.library.reference.1=../../cocos2d-x/cocos/platform/android/java

在这个例子中, Cocos2dxActivity.java 文件应该在如下位置:

../../cocos2d-x/cocos/platform/android/java/src/org/cocos2dx/lib/Cocos2dxActivity.java
import android.content.Intent;
import com.sdkbox.plugin.SDKBox;
onLoadNativeLibraries();
SDKBox.init(this);
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
          if(!SDKBox.onActivityResult(requestCode, resultCode, data)) {
            super.onActivityResult(requestCode, resultCode, data);
          }
    }
    @Override
    protected void onStart() {
          super.onStart();
          SDKBox.onStart();
    }
    @Override
    protected void onStop() {
          super.onStop();
          SDKBox.onStop();
    }
    @Override
    protected void onResume() {
          super.onResume();
          SDKBox.onResume();
    }
    @Override
    protected void onPause() {
          super.onPause();
          SDKBox.onPause();
    }
    @Override
    public void onBackPressed() {
          if(!SDKBox.onBackPressed()) {
            super.onBackPressed();
          }
    }

使用 Proguard (release模式下可选)

proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt

# leadbolt
-dontwarn android.support.v4.**
-keep public class com.google.android.gms.* { public *; }
-dontwarn com.google.android.gms.**

-keep class com.apptracker.** { *; }
-dontwarn com.apptracker.**
-keepclassmembers class **.R$* {
    public static <fields>;
}
-keep class **.R$*


# cocos2d-x
-keep public class org.cocos2dx.** { *; }
-dontwarn org.cocos2dx.**
-keep public class com.chukong.** { *; }
-dontwarn com.chukong.**

#sdkbox
-keep public class com.sdkbox.** { *; }
-dontwarn com.sdkbox.**

Note: Proguard 只能工作在 Release 模式下 (比如: cocos run -m release) debug 模式下不会触发 Proguard 。