SDKBox

sdkbox

SDKBox 是免费的让移动游戏开发人员简单轻松集成第三方 SDK 的工具，主要面向海外的各种平台和服务。支持苹果和谷歌的 IAP 内购等近 30 种 SDK，所有的 SDK 都经过严格的测试与官方认证。SDKBox 目前只支持 Android 和 iOS 平台。请访问 SDKBox 主页 获取更多的信息。

集成 SDKBox

  1. 使用 Creator 打开需要集成 SDKBox 的项目工程，从 菜单栏 — 项目 中打开 构建发布 面板，在 构建发布 面板中选择 iOS/Android，并勾选 SDKBox，然后点击 构建。

  2. 构建完成之后会自动弹出一个 Install SDKBox Plugin？ 的选择框，选择 Yes 来打开 SDKBox 窗口，然后点击 import 来导入所需的插件。具体的操作流程可点击 视频 参考。

sdkbox

使用指南

当 SDKBox 集成完成之后，就可以开始使用 SDK 的 API 了，这里将以 AdMob 作为示例。

添加按钮

首先在 场景编辑器 中添加两个按钮节点：

sdkbox

点击 层级管理器 左上方的 + 按钮，然后点击 创建 UI 节点 -> Button，即可在场景编辑器中添加 Button 节点。

添加 JavaScript 脚本组件

在 属性检查器 中点击左上方的 + 按钮，然后选择 JavaScript 来创建一个脚本。将脚本重命名为 AdMob.js，并且添加以下函数，记得要在 onLoad 函数中初始化 AdMob。

  1. cc.Class({
  2.     extends: cc.Component,
  4.     onLoad: function () {
  5.         //Add this line to onLoad
  6.         this.admobInit();
  7.     },
  9.     ...
  11.     admobInit: function() {
  12.         //finish it after import admob, let it empty for now
  13.     },
  15.     cacheInterstitial: function() {
  16.         //finish it after import admob, let it empty for now
  17.     },
  19.     showInterstitial: function() {
  20.         //finish it after import admob, let it empty for now
  21.     },
  23.     ...
  25. });

然后在 层级管理器 中选中 Canvas 节点。点击 属性检查器 最下方的 添加组件 按钮，选择 用户脚本组件 -> AdMob：

sdkbox

即可添加 AdMob 脚本组件到 Canvas 节点：

sdkbox

添加按钮点击事件

在 层级管理器 中选中之前创建的 Button 节点，可以看到在 属性检查器 中有一个 Button 组件。然后设置 Click Events 属性，将挂载了 AdMob 脚本组件的 Canvas 节点拖拽到 Click Events 属性的 cc.Node 中，如下图所示。具体的内容可参考 Button 事件。

sdkbox

sdkbox

配置 AdMob

根据 AdMob 账号配置发布包目录下的 ./build/jsb-link/res/sdkbox_config.json 文件，填写 AppID、广告 ID 等。可以通过点击编辑器右上方的 工程目录 按钮来打开工程文件夹。

编译项目

配置完成之后，再次打开 构建发布 面板，去掉 SDKBox 的勾选，然后点击面板下方的构建 -> 编译 -> 运行。而 iOS 平台在构建完成之后则需要使用 Xcode 打开发布包目录 ./build/jsb-link/frameworks/runtime-src/proj.ios_mac 目录下的 .xcodeproj 文件进行编译和运行。

运行完成后点击 Cache Interstitial 按钮，然后再点击 Show Interstitial 按钮，即可显示广告。

参考代码

可参考的完整的 AdMob.js 代码如下：

  1. cc.Class({
  2.     extends: cc.Component,
  4.     onLoad: function () {
  5.         //Add this line to onLoad
  6.         this.admobInit();
  7.     },
  9.     admobInit: function() {
  10.         if(cc.sys.isMobile) {
  11.             var self = this
  12.             sdkbox.PluginAdMob.setListener({
  13.                 adViewDidReceiveAd: function(name) {
  14.                     self.showInfo('adViewDidReceiveAd name=' + name);
  15.                 },
  16.                 adViewDidFailToReceiveAdWithError: function(name, msg) {
  17.                     self.showInfo('adViewDidFailToReceiveAdWithError name=' + name + ' msg=' + msg);
  18.                 },
  19.                 adViewWillPresentScreen: function(name) {
  20.                     self.showInfo('adViewWillPresentScreen name=' + name);
  21.                 },
  22.                 adViewDidDismissScreen: function(name) {
  23.                     self.showInfo('adViewDidDismissScreen name=' + name);
  24.                 },
  25.                 adViewWillDismissScreen: function(name) {
  26.                     self.showInfo('adViewWillDismissScreen=' + name);
  27.                 },
  28.                 adViewWillLeaveApplication: function(name) {
  29.                     self.showInfo('adViewWillLeaveApplication=' + name);
  30.                 }
  31.             });
  32.             sdkbox.PluginAdMob.init();
  33.         }
  34.     },
  36.     cacheInterstitial: function() {
  37.         if(cc.sys.isMobile) {
  38.             sdkbox.PluginAdMob.cache('gameover');
  39.         }
  40.     },
  42.     showInterstitial: function() {
  43.         if(cc.sys.isMobile) {
  44.             sdkbox.PluginAdMob.show('gameover');
  45.         }
  46.     },
  48. });

相关参考链接