NativeAdsPlugin v0.0.1

Cocos Creator 插件：实现原生平台广告的快速接入（支持iOS、Android）。

Creator编辑器进行广告信息配置，广告展示策略配置，编辑器下广告模拟展示，构建发布后快速集成至Xcode工程、Android Studio工程。

支持广告列表

名称	横幅	插屏	激励	说明
Admob	y	y	n	https://www.google.com/admob/
广点通	y	y	n	http://e.qq.com/dev/index.html
Facebook	y	y	n	https://developers.facebook.com/docs/audience-network 仅支持海外用户
Unity	n	y	y	https://unity3d.com/cn/services/ads
Vungle	n	y	y	http://vungle.cn/

插件安装方法

请参考扩展编辑器:安装与分享文档。

CocosCreator Menu->插件->插件商店购买下载安装后项目中多出native-ads-plugin-assets目录安装完成

运行DEMO

安装后，复制 creator工程目录/packages/native-ads-plugin/demo 至 creator工程目录/assets 下

creator编辑器下打开DEMO场景，配置广告信息，构建、发布，平台接入，enjoy！

快速开始

将命名NativeAdsManager的预制拖入场景中作为根节点。

配置广告信息

在NativeAdsManager节点中NativeAdsConfigData组件配置广告信息与展示策略。

详解参数意义，以admob为例：

admobBannerID 横幅ID

admobIniterialID 插屏ID

admobBannerEnabled 是否启用admob横幅广告

admobEnabled 是否启用admob插屏和激励广告

admobPriority 插屏展示优先级数字越小优先级越高，目的尽量多的展示广告与最大化收益

admobCooldown 插屏、激励广告展示的冷却时间，目的防止频繁展示被广告平台封号

admobTestDevices 测试设备号，在xcode、android studio真机调试时日志中广告平台会打印出测试设备号添加在这，目的防止测试频繁展示被广告平台封号

unityEncouragePriority 激励展示优先级数字越小优先级越高，目的尽量多的展示广告与最大化收益

代码使用

初始化广告管理类

初始化必须调用，推荐在程序开始。

var adManager = cc.find('NativeAdsManager').getComponent('NativeAdsManager');
adManager.initialize();

初始化只有第一次有效，读取NativeAdsConfigData中的配置数据，如果希望动态配置广告信息等数据，需要在初始化前修改NativeAdsConfigData中的内容。

var configData = cc.find('NativeAdsManager').getComponent('NativeAdsConfigData');
configData.admobBannerID = '123456';
configData.admobEnabled = true;
var adManager = cc.find('NativeAdsManager').getComponent('NativeAdsManager');
adManager.initialize();

展示横幅广告

adManager.showBanner();

隐藏横幅广告

adManager.hideBanner();

展示插屏广告

adManager.showInterstitial();

查询是否有可展示的插屏广告

bool flag = adManager.isInterstitialReady();

展示激励广告

adManager.showEncourageAd();

this.adManager.showEncourageAd('每日奖励');
this.adManager.showEncourageAd('复活');

查询是否有可展示的激励广告

bool flag = adManager.isEncourageAdReady();

回调

adManager.addListener(this, this.onAdsCallback);

onAdsCallback(event){
    cc.log('onAdsCallback eventName = ' + event.detail.eventName + ', adtype = ' + event.detail.adType);
    if (event.detail.eventName == 'encourageAdFinish'){
        cc.log('encourage zone = ' + event.detail.zone);
        //激励广告逻辑
        if (event.detail.zone == '每日奖励'){
            //每日奖励逻辑

        } else if (event.detail.zone == '复活'){
            //复活逻辑

        }
    }
},

平台接入

在CocosCreator第一次构建发布后，还需要配置原生项目（仅第一次）

iOS平台(Xcode工程)

添加依赖库和OC代码到Xcode工程

Xcode目录 creator工程目录/build/jsb-default(不同模版名字不同如jsb-link、jsb-binary)/frameworks/runtime-src/proj.ios_mac

NativeAdsPlugin的iOS目录(要添加的依赖库和代码) creator工程目录/packages/native-ads-plugin/platforms/ios

打开Xcode工程，导入nativeAdsPlugin的iOS目录下的文件，勾选copy items if needed

编辑AppController.h添加:

@interface AppController : NSObject

...

@property (retain, nonatomic) RootViewController *viewController;

@end

extern "C"{
    
    AppController* getAppController ();
    
    UIViewController *getRootViewController();
}

编辑AppController.mm添加:

@implementation AppController

@synthesize viewController = viewController;

...

static AppController *_appController;

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    _appController = self;
    ...
}

...

@end


extern "C"{
    
    AppController* getAppController () {
        return _appController;
    }
    
    UIViewController *getRootViewController() {
        return getAppController().viewController;
    }
    
}

添加Frameworks

AdSupport.framework

CoreTelephony.framework

libz.tbd

StoreKit.framework

libxml2.tbd

WebKit.framework

EventKitUI.framework

EventKit.framework

MessageUI.framework

Compile Flags

新添加的.m和.mm文件需要标注自动引用计数-fobjc-arc

iOS10 新增权限验证

Info.plist添加以下权限

<key>NSBluetoothPeripheralUsageDescription</key>
<string>Use Your Bluetooth</string>
<key>NSCalendarsUsageDescription</key>
<string>Use Your Calendar</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>Use Your Location</string>
<key>NSLocationUsageDescription</key>
<string>Use Your Location</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Use Your Location</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Use Your Photo</string>

Android平台(Android Studio工程)

添加依赖库和java代码到Android Studio工程

Android Studio目录 creator工程目录/build/jsb-default/frameworks/runtime-src/proj.android-studio

NativeAdsPlugin的Android Studio目录 creator工程目录/packages/native-ads-plugin/platforms/android-studio

NativeAdsPlugin目录/src 文件复制到 Android Studio目录/app/src下

NativeAdsPlugin目录/libs 文件复制到 Android Studio目录/app/libs下

配置build.gradle文件

minSdkVersion 14+,compileSdkVersion 23+,targetSdkVersion=22

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.1"
    
    defaultConfig {
        minSdkVersion 14
        targetSdkVersion 22
        ...
    }
    ...
    lintOptions {
        abortOnError false
    }
}


repositories {
    flatDir {
        dirs 'libs'
    }
    mavenCentral()
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile project(':libcocos2dx')

    compile 'com.google.firebase:firebase-ads:9.4.0'
    compile 'com.google.android.gms:play-services-gcm:9.4.0'
    compile 'com.alibaba:fastjson:1.2.21'
    compile 'com.facebook.android:audience-network-sdk:4.+'

    compile 'com.android.support:support-v4:23.4.0'
    compile 'com.android.support:appcompat-v7:23.4.0'

    compile files('libs/GDTUnionSDK.TBS.4.9.542.min.jar')
    compile(name: 'DebugSettings', ext: 'aar')
    compile(name: 'unity-ads', ext: 'aar')
}

配置AndroidManifest.xml文件

添加权限

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

添加activity

<!--facebook-->
<activity android:name="com.facebook.ads.AudienceNetworkActivity"
    android:configChanges="keyboardHidden|orientation|screenSize" />
<!--gdt-->
<service
    android:name="com.qq.e.comm.DownloadService"
    android:exported="false"/>
<activity
    android:name="com.qq.e.ads.ADActivity"
    android:configChanges="keyboard|keyboardHidden|orientation|screenSize"/>
<!-- Vungle -->
<activity android:name="com.vungle.publisher.VideoFullScreenAdActivity"
    android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
    android:theme="@android:style/Theme.NoTitleBar.Fullscreen"/>
<activity android:name="com.vungle.publisher.MraidFullScreenAdActivity"
    android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
    android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"/>

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

NativeAdsPlugin v0.0.1

支持广告列表

插件安装方法

运行DEMO

快速开始

配置广告信息

代码使用

初始化广告管理类

展示横幅广告

隐藏横幅广告

展示插屏广告

查询是否有可展示的插屏广告

展示激励广告

查询是否有可展示的激励广告

回调

平台接入

iOS平台(Xcode工程)

添加依赖库和OC代码到Xcode工程

添加Frameworks

Compile Flags

iOS10 新增权限验证

Android平台(Android Studio工程)

添加依赖库和java代码到Android Studio工程

配置build.gradle文件

配置AndroidManifest.xml文件

About

Releases

Packages

SatanStudio/NativeAdsPlugin

Folders and files

Latest commit

History

Repository files navigation

NativeAdsPlugin v0.0.1

支持广告列表

插件安装方法

运行DEMO

快速开始

配置广告信息

代码使用

初始化广告管理类

展示横幅广告

隐藏横幅广告

展示插屏广告

查询是否有可展示的插屏广告

展示激励广告

查询是否有可展示的激励广告

回调

平台接入

iOS平台(Xcode工程)

添加依赖库和OC代码到Xcode工程

添加Frameworks

Compile Flags

iOS10 新增权限验证

Android平台(Android Studio工程)

添加依赖库和java代码到Android Studio工程

配置build.gradle文件

配置AndroidManifest.xml文件

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Packages