Fyber 集成指南

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

前提条件

Android 系统, Fyber 最低系统要求是 4.0.3.
Fyber 不能 SOOMLA GROW 在一个工程中同时存在.

集成

用如下命令来集成 SDKBOX Fyber 插件,请确保您可以正常执行的 SDKBOX 安装器.

$ sdkbox import fyber

重点注意事项

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

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

添加以下项到 plist:

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

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

禁止 Bitcode 支持

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

游戏全屏配置

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

canOpenURL 白名单

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

关于 Creator 工程

Creator 导出工程会修改工程的配置, 这可能会影响 SDKBox 对工程的配置修改. 所以可以有以下做法(任选其一):

保存导出工程中的修改, 对于 SDKBox 来说可能有这些文件(mk, gradle, gradle.properties, AppDelegate.cpp, ...), 导出后再恢复对应该文件
在每一次 Creator 导出工程后, 重新 import 插件.

推荐第一种, 但是第一种的麻烦点在于, 对于第一次(或很久没接触的人)可能会有露掉某个文件第二种, 很方便, 它的麻烦点在于, 如果你对工程有自己的修改, SDKBox 的重新 import 不能帮你恢复.

额外步骤

获取 Fyber 开发者账号
在 Fyber 网站创建 APP

iOS

配置您的 APP: iOS Quick Start Guide

Android

java -version >= 1.7
配置您的 APP: Android Quick Start Guide
编辑 project.properties, 设置 target 目标 target=android-15

JSON 配置

SDKBOX 安装器会自动在您的工程中添加一个样例配置文件sdkbox_config.json.

下面给出一个 Fyber 的配置样例

"Fyber":
{
    "debug":true,
    "appid":"12345",
    "token":"34a9643edf4d3052d2bc1928b2e34d00"
}

使用

初始化 Fyber

修改您的lua代码用 init() 初始化插件. 这个可以在任何地方调用,但是必须在您要想使用 Fyber 的功能之前.

sdkbox.PluginFyber:init();

使用 Fyber

Offer Wall

显示 Offer Wall

sdkbox.PluginFyber:showOfferWall();

使用自定义的 placementId 显示 Offer Wall

sdkbox.PluginFyber:showOfferWall("coins");

Rewarded Video

iOS 参考 rewarded-video-iOS
Android 参考 rewarded-video-android

向服务器请求一个视频:

sdkbox.PluginFyber:requestOffers();

向服务器请求一个 placementId 的视频:

sdkbox.PluginFyber:requestOffers("coins");

显示奖励视频, 先调用 requestOffers(), 然后 showOffers():

sdkbox.PluginFyber:requestOffers();
sdkbox.PluginFyber:showOffers();

Interstitials

请求一个广告

sdkbox.PluginFyber:requestInterstitial();

显示广告. 请先调用 requestInterstitial :

sdkbox.PluginFyber:showInterstitial();

获取奖励

sdkbox.PluginFyber:requestDeltaOfCoins();

或者

sdkbox.PluginFyber:requestDeltaOfCoins("currencyId")

接收 Fyber 事件 (可选)

sdkbox.PluginFyber:setListener(function(args)
    dump(args)
    if args.name == "onVirtualCurrencyConnectorFailed" then
    elseif args.name == "onVirtualCurrencyConnectorSuccess" then
    elseif args.name == "onCanShowInterstitial" then
    elseif args.name == "onInterstitialDidShow" then
    elseif args.name == "onInterstitialDismiss" then
    elseif args.name == "onInterstitialFailed" then
    elseif args.name == "onBrandEngageClientReceiveOffers" then
    elseif args.name == "onBrandEngageClientChangeStatus" then
    elseif args.name == "onOfferWallFinish" then
    end
end)

API Reference

Methods

sdkbox.PluginFyber:init()

initialize the plugin instance.

sdkbox.PluginFyber:showOfferWall(placementId)

Presents the SponsorPay Mobile OfferWall as a child view controller of your own view controller.

sdkbox.PluginFyber:requestOffers(placementId)

Queries the server for BrandEngage offers availability.

sdkbox.PluginFyber:showOffers()

Starts running an available engagement.

sdkbox.PluginFyber:requestInterstitial()

Check if interstitial ads are available

sdkbox.PluginFyber:showInterstitial()

Shows an interstitial ad. Check first that one is ready to be shown with requestInterstitial.

sdkbox.PluginFyber:requestDeltaOfCoins(currencyId)

Fetches the amount of a given currency earned since the last time this method was invoked for the current user ID / app ID combination.

Listeners

onVirtualCurrencyConnectorFailed(error, errorCode, errorMsg)

onVirtualCurrencyConnectorSuccess(deltaOfCoins,
                                   currencyId,
                                   currencyName,
                                   transactionId)

onCanShowInterstitial(canShowInterstitial)

onInterstitialDidShow()

onInterstitialDismiss(reason)

onInterstitialFailed()

onBrandEngageClientReceiveOffers(areOffersAvailable)

onBrandEngageClientChangeStatus(status, msg)

onOfferWallFinish(status)

手动集成

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

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

iOS 平台手动集成

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

sdkbox.framework

PluginFyber.framework

上面的 frameworks 依赖于大量其他 frameworks。如果您没有添加它们，您也需要添加下列这些系统 frameworks：

AdSupport.framework

CoreGraphics.framework

CoreLocation.framework

CoreTelephony.framework

MediaPlayer.framework

QuartzCore.framework

StoreKit.framework

SystemConfiguration.framework

Security.framework

CFNetwork.framework

GameController.framework

在以下位置添加两个单独的链接选项： Target -> Build Settings -> Linking -> Other Linker Flags:

-ObjC

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

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

Android 手动集成

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

command-line 和 eclipse 类型的项目, <project_root> 指代 proj.android .
Android Studio 类型的项目, <project_root> 指代 proj.android-studio .

拷贝文件

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

PluginFyber.jar

sdkbox.jar

如果你使用 cocos2d-x 源码，拷贝 jar 文件到：

Android command-line: cocos2d/cocos/platform/android/java/libs

Android Studio: cocos2d/cocos/platform/android/libcocos2dx/libs
如果你使用 cocos2d-js 或者 lua ，拷贝 jar 文件到:

Android command-line: frameworks/cocos2d-x/cocos/platform/android/java/libs

Android Studio: frameworks/cocos2d-x/cocos/platform/android/libcocos2dx/libs
如果你使用 cocos2d-x 预编译包，拷贝 jar 文件到：

Android command-line: proj.android/libs

拷贝 jni 库

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

从 plugin/android/libs 拷贝 fyber_lib 目录到 <project_root>/libs/ directory.

编辑 `AndroidManifest.xml`

在标签 application tag 上添加下列权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

在接近文件底部的位置，拷贝并且粘贴下列定义到 application tags 标签结尾处。

<activity
    android:name="com.fyber.ads.ofw.OfferWallActivity"
    android:configChanges="screenSize|orientation" />
<activity
    android:name="com.fyber.ads.videos.RewardedVideoActivity"
    android:configChanges="screenSize|orientation"
    android:hardwareAccelerated="true"
  android:theme="@android:style/Theme.Translucent" />
<activity
    android:name="com.fyber.ads.interstitials.InterstitialActivity"
    android:configChanges="screenSize|orientation"
    android:theme="@android:style/Theme.Translucent" />
<activity
    android:configChanges="screenSize|orientation"
    android:name="com.fyber.cache.CacheVideoDownloadService"
    android:hardwareAccelerated="true"/>
<service android:name="com.fyber.cache.CacheVideoDownloadService" android:exported="false" />

编辑 `Android.mk`

编辑 <project_root>/jni/Android.mk :

为 LOCAL_STATIC_LIBRARIES 添加额外的库：

LOCAL_WHOLE_STATIC_LIBRARIES += PluginFyber
LOCAL_WHOLE_STATIC_LIBRARIES += sdkbox

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

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

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

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

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

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

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

为 APP_PATFORM 添加版本：

APP_PLATFORM := android-14