考虑到以下两点:
1. Cocos2d-x从3.7版开始优化对Android Studio的支持,相信这一趋势还会继续。可惜目前相关帮助文档还不完善,很多东西需要自己摸索。
2. 多盟广告平台的官方帮助文档没有针对Cocos2d-x。
所以在此对自己所学所得做一些总结,也希望能帮助到那些处在摸索之中的朋友们。
本文所用cocos2d-x为3.8版,android studio为1.3.2版,多盟SDK为4.5.4版。
准备工作
1) 进入多盟官网,注册账户。注册时需要上传身份证正反面照片和银行账户,并等待审核。审核大概需要一两天时间。
开干正事
1) 在搞懂如何添加之前,建议不要直接在自己的工程里面添加,最好新建一个HelloWorld项目用于试验。关于如何新建一个Android studio版的HelloWorld,请参考上一篇博文。
2) 打开下载下来的多盟SDK->lib,将其中的domob_android_sdk.jar考到新建的HelloWorld项目下proj.android-studio->app->libs->armeabi文件夹中(该文件夹只有在第一步中完成编译之后才会出现)。并在android studio中找到domob_android_sdk.jar(在jiniLibs->armeabi下面),右击,选择Add As Library。这样就把多盟的SDK添加到我们的项目中了。如果是eclipse,这一步稍有区别,需要通过Java Build Path添加。
3) 在android studio里面打开AndroidManifest.xml。相信你能找到这个文件!往里面添加两样东西:在<application>之前为多盟SDK添加权限,并在<application>里面添加多盟Activity声明。添加完后完整代码如下所示:
AndroidManifest.xml
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
package="com.istudy.CocosDomob"
android:installLocation="auto"
android:versionCode="2"
android:versionName="2.0">
<!--多盟官网考来的部分1开始-->
<uses-sdk android:minSdkVersion="8" android:targetSdkVersion="19"/>
<!-- 网络访问权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 获取网络信息状态,如当前的网络连接是否有效 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 读取手机状态 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- 允许程序写入外部存储,如SD卡上写文件 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 获取错略位置-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 获取WiFi状态 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 以下权限为可选权限,主要是品牌广告会用到,如果您没有添加,需要这些效果的品牌广告将不会投放到您的应用上 -->
<!-- 震动权限 -->
<uses-permission android:name="android.permission.VIBRATE" />
<!--多盟官网考来的部分1结束-->
<uses-feature android:glEsVersion="0x00020000" />
<application
tools:replace="android:label"
android:label="@string/app_name"
android:allowBackup="true"
android:icon="@mipmap/ic_launcher">
<!-- Tell Cocos2dxActivity the name of our .so -->
<meta-data android:name="android.app.lib_name"
android:value="cocos2dcpp" />
<!-- 多盟官网考来的部分2开始 -->
<activity android:name="cn.domob.android.ads.DmActivity"
android:theme="@android:style/Theme.Translucent"></activity>
<!--多盟官网考来的部分2结束-->
<activity
android:name="org.cocos2dx.cpp.AppActivity"
android:screenOrientation="Portrait"
android:configChanges="orientation|keyboardHidden|screenSize"
android:label="@string/app_name"
android:theme="@android:style/Theme.NoTitleBar.Fullscreen" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
<uses-permission android:name="android.permission.INTERNET"/>
</manifest>
注意<application>里面的第一行tools:replace="android:label"本来是没有的,但是如果不添加该代码,编译时会提示出错(发生定义冲突),并给出添加该代码的建议。该代码还需配合第三行的xmlns:tools="http://schemas.android.com/tools"使用。
4) 在android studio里面找到AppActivity(在java->org.cocos2dx.cpp下面),往里面添加显示广告的java代码,但是由于我们要在cocos2d-x的HelloWorld场景里面(也就是C++代码里面)添加广告,所以此处需要做一些接口函数,而不是像多盟官方文件UserGuide.pdf里面直接令其显示。添加完后,完整代码如下所示:
AppActivity
package org.cocos2dx.cpp;
import org.cocos2dx.lib.Cocos2dxActivity;
import cn.domob.android.ads.AdEventListener;
//import cn.domob.android.ads.AdManager;
import cn.domob.android.ads.AdManager.ErrorCode;
import cn.domob.android.ads.AdView;
import cn.domob.android.ads.InterstitialAd;
import cn.domob.android.ads.InterstitialAdListener;
//import android.app.ActionBar;
import android.content.Context;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.util.Log;
import android.view.View;
//import android.view.ViewGroup;
import android.widget.RelativeLayout;
public class AppActivity extends Cocos2dxActivity {
//声明应用ID
//private static AppActivity _AppActivity;
public static final String PUBLISHER_ID = "你的应用ID";
//声明插屏广告和插屏广告ID
private InterstitialAd mInterstitialAd;
public static final String InterstitialPPID = "你的插屏广告ID";
//声明广告条层和广告位ID
private static RelativeLayout bannerLayout;
private AdView mAdview;
public static final String InlinePPID="你的广告条ID";
//声明handler用于发送消息
private static Handler handler;
@Override
protected void onCreate(Bundle savedIntanceState){
super.onCreate(savedIntanceState);
//创建插屏广告
if (mInterstitialAd != null) {
return;
}
mInterstitialAd = new InterstitialAd(this, PUBLISHER_ID, InterstitialPPID);
mInterstitialAd.setInterstitialAdListener(new InterstitialAdListener() {
@Override
public void onInterstitialAdReady() {
Log.i("DomobSDKDemo", "onAdReady");
}
@Override
public void onLandingPageOpen() {
Log.i("DomobSDKDemo", "onLandingPageOpen");
}
@Override
public void onLandingPageClose() {
Log.i("DomobSDKDemo", "onLandingPageClose");
}
@Override
public void onInterstitialAdPresent() {
Log.i("DomobSDKDemo", "onLandingAdPresent");
}
@Override
public void onInterstitialAdDismiss() {
mInterstitialAd.loadInterstitialAd();
Log.i("DomobSDKDemo", "onInterstitialAdDismiss");
}
@Override
public void onInterstitialAdFailed(ErrorCode errorCode) {
Log.i("DomobSDKDemo", "onInterstitialAdFailed");
}
@Override
public void onInterstitialAdLeaveApplication() {
Log.i("DomobSDKDemo", "onInterstitialAdLeaveApplication");
}
@Override
public void onInterstitialAdClicked(InterstitialAd arg0) {
Log.i("DomobSDKDemo", "onInterstitialAdClicked");
}
});
mInterstitialAd.loadInterstitialAd();
//创建广告条容器
bannerLayout = new RelativeLayout(this);
RelativeLayout.LayoutParams parentLayoutParams = new RelativeLayout.LayoutParams(
RelativeLayout.LayoutParams.WRAP_CONTENT,
RelativeLayout.LayoutParams.WRAP_CONTENT);
this.addContentView(bannerLayout, parentLayoutParams);
//加载广告
handler = new Handler() {
@Override
public void handleMessage(Message msg) {
switch (msg.what) {
case 0:// showBannerAd()
if (bannerLayout.getChildCount() == 0) {
//创建广告条
//setContentView(R.layout.banner);
//mAdContainer = (RelativeLayout) findViewById(R.id.adcontainer);
//注意这两行注释掉的代码来自多盟文档,不可用
mAdview = new AdView(AppActivity.this, PUBLISHER_ID, InlinePPID);
mAdview.setKeyword("game");
mAdview.setUserGender("male");
mAdview.setUserBirthdayStr("2000-08-08");
mAdview.setUserPostcode("123456");
mAdview.setAdEventListener(new AdEventListener() {
@Override
public void onEventAdReturned(AdView adView) {
Log.i("DomobSDKDemo", "onDomobAdReturned");
}
@Override
public void onAdFailed(AdView adView, ErrorCode errorCode) {
Log.i("DomobSDKDemo", "onDomobAdFailed");
}
@Override
public void onAdOverlayPresented(AdView adView) {
Log.i("DomobSDKDemo", "overlayPresented");
}
@Override
public void onAdOverlayDismissed(AdView adView) {
Log.i("DomobSDKDemo", "Overrided be dismissed");
}
@Override
public void onLeaveApplication(AdView adView) {
Log.i("DomobSDKDemo", "onDomobLeaveApplication");
}
@Override
public void onAdClicked(AdView adView) {
Log.i("DomobSDKDemo", "onDomobAdClicked");
}
@Override
public Context onAdRequiresCurrentContext() {
//return null;
return AppActivity.this;
}
});
//添加广告并设置它的位置
RelativeLayout.LayoutParams layoutParams = new RelativeLayout.LayoutParams(
RelativeLayout.LayoutParams.WRAP_CONTENT, RelativeLayout.LayoutParams.WRAP_CONTENT);
//layoutParams.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM, RelativeLayout.TRUE);
layoutParams.addRule(RelativeLayout.CENTER_HORIZONTAL, RelativeLayout.TRUE);
bannerLayout.addView(AppActivity.this.mAdview, layoutParams);
}else{
if (mAdview != null) {
mAdview.setVisibility(View.VISIBLE);
mAdview.requestRefreshAd();
}
}
break;
case 1: //hideBannerAd()
if (mAdview != null) {
mAdview.setVisibility(View.GONE);
}
break;
case 2: //initInterstitialAd()
break;
case 3: //showInterstitialAd()
if (mInterstitialAd != null) {
if (mInterstitialAd.isInterstitialAdReady()) {
mInterstitialAd.showInterstitialAd(AppActivity.this);
} else {
Log.i("DomobSDKCocos2d-xDemo", "Interstitial Ad is not ready");
mInterstitialAd.loadInterstitialAd();
}
} else {
Log.i("DomobSDKCocos2d-xDemo", "Interstitial Ad is not init");
}
default:
break;
}
}
};
}
//打开和关闭广告
public static void showBannerAd() {
handler.sendEmptyMessage(0);
}
public static void hideBannerAd() {
handler.sendEmptyMessage(1);
}
public static void initInterstitialAd() {
handler.sendEmptyMessage(2);
}
public static void showInterstitialAd() {
handler.sendEmptyMessage(3);
}
}
注意这里和多盟官方文档UserGuide.pdf的两点区别。1, 我们的场景都是通过cocos2d-x创建的,因此本身没有布局文件xml,所以我们不通过布局文件以及setContentView(R.layout.banner)和mAdContainer=(RelativeLayout)findViewById(R.id.adcontainer)两条命令来创建广告条,而是选择通过代码来创建一个RelativeLayout布局对象作为广告条的容器。2,我们通过Handler来发送消息,从而起到控制广告开关的作用。
5) 在cocos2d-x的classes下面添加一个C++类,命名为DomobAd, 里面通过jni把java的广告开关函数转换成了C++函数,以便在cocos2d-x场景里调用。完整代码如下所示:
DomobAd.h
#ifndef CLASSES_DOMOBAD_H
#define CLASSES_DOMOBAD_H
class DomobAd {
public:
static void showBannerAd();
static void hideBannerAd();
static void showInterstitialAd();
};
#endif //CLASSES_DOMOBAD_H
#include "DomobAd.h"
#include "cocos2d.h"
USING_NS_CC;
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
#include "platform/android/jni/JniHelper.h"
#include <jni.h>
const char* AppActivityCalssName = "org/cocos2dx/cpp/AppActivity";
//显示广告条
void DomobAd::showBannerAd()
{
cocos2d::JniMethodInfo showBanner;
if (cocos2d::JniHelper::getStaticMethodInfo(showBanner, AppActivityCalssName, "showBannerAd", "()V")) {
showBanner.env->CallStaticVoidMethod(showBanner.classID, showBanner.methodID);
}
else{
log("jni:showBannerStatic false");
}
}
//隐藏广告条
void DomobAd::hideBannerAd()
{
cocos2d::JniMethodInfo hideBanner;
if (cocos2d::JniHelper::getStaticMethodInfo(hideBanner, AppActivityCalssName, "hideBannerAd", "()V")) {
hideBanner.env->CallStaticVoidMethod(hideBanner.classID, hideBanner.methodID);
}
else{
log("jni:hideBannerStatic false");
}
}
//显示插屏广告
void DomobAd::showInterstitialAd()
{
cocos2d::JniMethodInfo showInterstitial;
if(cocos2d::JniHelper::getStaticMethodInfo(showInterstitial,AppActivityCalssName,"showInterstitialAd","()V")){
showInterstitial.env->CallStaticVoidMethod(showInterstitial.classID,showInterstitial.methodID);
showInterstitial.env->DeleteLocalRef(showInterstitial.classID);
}
else{
log("jni:showBannerStatic false");
}
}
#else
//广告条
void DomobAd::showBannerAd()
{
log("showBannerAd() called");
return;
}
void DomobAd::hideBannerAd()
{
log("hideBannerAd() called");
return;
}
//插屏广告
void DomobAd::showInterstitialAd(){
log("showInterstitialAd() called");
return;
}
#endif
6) 接下来就可以愉快的在Cocos2d-x场景里添加广告了。这里我们就在HelloWorld场景的上端添加一个广告条,并在场景的中间设置一个按钮,一按就弹出一个插屏广告。完整代码如下:
HelloWorldScene.h
#ifndef __HELLOWORLD_SCENE_H__
#define __HELLOWORLD_SCENE_H__
#include "cocos2d.h"
class HelloWorld : public cocos2d::Layer
{
public:
static cocos2d::Scene* createScene();
virtual bool init();
// a selector callback
void menuCloseCallback(cocos2d::Ref* pSender);
void adCallback(cocos2d::Ref* pRef);
// implement the "static create()" method manually
CREATE_FUNC(HelloWorld);
};
#endif // __HELLOWORLD_SCENE_H__
#include "HelloWorldScene.h"
#include "DomobAd.h"
USING_NS_CC;
Scene* HelloWorld::createScene()
{
// 'scene' is an autorelease object
auto scene = Scene::create();
// 'layer' is an autorelease object
auto layer = HelloWorld::create();
// add layer as a child to scene
scene->addChild(layer);
// return the scene
return scene;
}
// on "init" you need to initialize your instance
bool HelloWorld::init()
{
//
// 1. super init first
if ( !Layer::init() )
{
return false;
}
Size visibleSize = Director::getInstance()->getVisibleSize();
Vec2 origin = Director::getInstance()->getVisibleOrigin();
/
// 2. add a menu item with "X" image, which is clicked to quit the program
// you may modify it.
// add a "close" icon to exit the progress. it's an autorelease object
auto closeItem = MenuItemImage::create(
"CloseNormal.png",
"CloseSelected.png",
CC_CALLBACK_1(HelloWorld::menuCloseCallback, this));
closeItem->setPosition(Vec2(origin.x + visibleSize.width - closeItem->getContentSize().width/2 ,
origin.y + closeItem->getContentSize().height/2));
//添加一个按钮用来弹出插屏广告
auto adItem = MenuItemImage::create(
"CloseNormal.png",
"CloseSelected.png",
CC_CALLBACK_1(HelloWorld::adCallback, this));
adItem->setPosition(Vec2(origin.x + visibleSize.width/2 ,origin.y + visibleSize.height/2));
// create menu, it's an autorelease object
auto menu = Menu::create(closeItem,adItem, NULL);
menu->setPosition(Vec2::ZERO);
this->addChild(menu, 1);
/
// 3. add your codes below...
// add a label shows "Hello World"
// create and initialize a label
//添加广告条
DomobAd::showBannerAd();
auto label = Label::createWithTTF("Hello World", "fonts/Marker Felt.ttf", 24);
// position the label on the center of the screen
label->setPosition(Vec2(origin.x + visibleSize.width/2,
origin.y + visibleSize.height - label->getContentSize().height));
// add the label as a child to this layer
this->addChild(label, 1);
// add "HelloWorld" splash screen"
auto sprite = Sprite::create("HelloWorld.png");
// position the sprite on the center of the screen
sprite->setPosition(Vec2(visibleSize.width/2 + origin.x, visibleSize.height/2 + origin.y));
// add the sprite as a child to this layer
this->addChild(sprite, 0);
return true;
}
void HelloWorld::menuCloseCallback(Ref* pSender)
{
Director::getInstance()->end();
#if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
exit(0);
#endif
}
void HelloWorld::adCallback(cocos2d::Ref* pRef){
DomobAd::showInterstitialAd();
}
7) 编译并运行。编译之前要先在Android.mk文件里添加DomobAd.cpp的路径,否则新建的C++文件无法被编译进去。比如可以通过命令行输入vi ~/Documents/HelloWorld/proj.android-studio/app/jni/Android.mk 进行添加。最终运行后效果如下图所示
从效果图里可以看出我已经在AndroidManifest.xml里把横屏改成了竖屏。
人生感悟:1.多跟人交流;2,多尝试;3,打好基础。
水平有限,如有不妥,欢迎指正!
参考文献:
[1]多盟官方UserGuide.pdf
[2]http://blog.csdn.net/aa294194253/article/details/38514125
[3]http://blog.csdn.net/u011909633/article/details/47038859