考虑到以下两点:
1. Cocos2d-x从3.7版开始优化对Android Studio的支持,相信这一趋势还会继续。可惜目前相关帮助文档还不完善,很多东西需要自己摸索。
2. 广点通广告平台的官方帮助文档没有针对Cocos2d-x。
所以在此对自己所学所得做一些总结,也希望能帮助到那些处在摸索之中的朋友们。
准备工作:
1)进入广点通官网,注册账号。注册时需要上传身份证正反面照片(好像还需要手持身份证照片)以及银行账户。然后等待审核。广点通审核时间略长,大概要一个礼拜。
2)审核通过后就可以创建应用和广告位。
3)下载广点通安卓版SDK。广点通的SDK文件夹里有示例代码,可以打开看一看,官网上也帮助文档,但是没有针对Cocos2d-x的。
开干正事:
1)在搞懂如何添加之前,建议不要直接在自己的工程里添加,最好新建一个HelloWorld项目用于试验。关于如何新建一个Android Studio版的HelloWorld项目,请参考博主另一篇博文。
2)打开下载下来的广点通文件夹,复制其中的GDTUnionSDK.4.8.509.jar文件,并拷贝到新建的HelloWorld项目下proj.android-studio->app->libs->armeabi文件夹中(该文件夹只有在第一步中完成编译之后才会出现)。并在Android Studio中打开HelloWorld项目,找到GDTUnionSDK.4.8.509.jar(在jiniLibs->armeabi下面),右击,选择Add As Library。这样就把广点通SDK添加到我们的项目中了。
3)在Android Studio中打开AndroidManifest.xml文件,往里面添加广点通权限声明和Activity声明。添加完后完整代码如下所示:
AndroidManifest.xml
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.istudy.HelloWorldGDT"
android:installLocation="auto">
<!--广点通声明1开始-->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_UPDATES"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!--广点通声明1结束-->
<uses-feature android:glEsVersion="0x00020000" />
<application
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开始-->
<service
android:name="com.qq.e.comm.DownloadService"
android:exported="false" >
</service>
<activity
android:name="com.qq.e.ads.ADActivity"
android:configChanges="keyboard|keyboardHidden|orientation|screenSize" >
</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>
4)在Android Studio里打开AppActivity,往里面添加显示广告的Java代码。但是由于我们Cocos2d-x的场景都是用C++实现的,所以我们在这里需要利用Handler来做接口。这和官方帮助文档不同。添加完后完整代码如下所示:
AppActivity
package org.cocos2dx.cpp;
import org.cocos2dx.lib.Cocos2dxActivity;
import android.app.Activity;
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.View.OnClickListener;
import android.view.ViewGroup;
import android.widget.RelativeLayout;
import com.qq.e.ads.banner.ADSize;
import com.qq.e.ads.banner.AbstractBannerADListener;
import com.qq.e.ads.banner.BannerView;
public class AppActivity extends Cocos2dxActivity {
//声明应用ID
public static final String APPID = "1101152570";
//声明广告条容器,广告条和广告位ID
private static RelativeLayout bannerContainer;
BannerView bv;
public static final String BannerPosID="9079537218417626401";
//声明handler用于发送消息
private static Handler handler;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//创建广告条容器
bannerContainer = new RelativeLayout(this);
RelativeLayout.LayoutParams parentLayoutParams = new RelativeLayout.LayoutParams(
RelativeLayout.LayoutParams.WRAP_CONTENT,
RelativeLayout.LayoutParams.WRAP_CONTENT);
this.addContentView(bannerContainer, parentLayoutParams);
//加载或卸载广告
handler = new Handler() {
@Override
public void handleMessage(Message msg) {
switch (msg.what) {
case 0:// showBannerAd()
if (bannerContainer.getChildCount() == 0) {
//初始化并加载广告条
initBanner();
bv.loadAD();
}else{
if (bv != null) {
bv.setVisibility(View.VISIBLE);
bv.loadAD();
}
}
break;
case 1: //hideBannerAd()
if (bv != null) {
doCloseBanner();
}
break;
default:
break;
}
}
};
}
private void initBanner() {
bv = new BannerView(this, ADSize.BANNER, APPID, BannerPosID);
bv.setRefresh(30);
bv.setShowClose(true);//一定要有这个关闭按钮,否则某些应用商店不给通过,虽然官方示例代码中没有。本人就被坑过一次。
bv.setADListener(new AbstractBannerADListener() {
@Override
public void onNoAD(int arg0) {
Log.i("AD_DEMO", "BannerNoAD,eCode=" + arg0);
}
@Override
public void onADReceiv() {
Log.i("AD_DEMO", "ONBannerReceive");
}
});
//添加广告并设置它的位置
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);
bannerContainer.addView(AppActivity.this.bv, layoutParams);
}
//刷新
private void doRefreshBanner() {
if (bv == null) {
initBanner();
}
bv.loadAD();
}
//关闭
private void doCloseBanner() {
bannerContainer.removeAllViews();
bv.destroy();
bv = null;
}
//打开和关闭广告接口
public static void showBannerAd() {
handler.sendEmptyMessage(0);
}
public static void hideBannerAd() {
handler.sendEmptyMessage(1);
}
}
注意我们这里是用代码来创建一个RelativeLayer布局对象来作为广告条容器的,而非通过布局文件xml来实现的,这一点和官方文档也不同。
5)在Cocos2d-x的Classes下面新建一个类,命名为GDTAD,在里面通过jni把Java的广告开关转换成了C++函数,以便在Cocos2d-x场景里调用。完整代码如下:
GDTAD.h
#ifndef CLASSES_GDTAD_H
#define CLASSES_GDTAD_H
class GDTAD {
public:
static void showBannerAd();
static void hideBannerAd();
};
#endif //CLASSES_GDTAD_H
#include "GDTAD.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 GDTAD::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 GDTAD::hideBannerAd()
{
cocos2d::JniMethodInfo hideBanner;
if (cocos2d::JniHelper::getStaticMethodInfo(hideBanner, AppActivityCalssName, "hideBannerAd", "()V")) {
hideBanner.env->CallStaticVoidMethod(hideBanner.classID, hideBanner.methodID);
}
else{
log("jni:hideBannerStatic false");
}
}
#else
//广告条
void GDTAD::showBannerAd()
{
log("showBannerAd() called");
return;
}
void GDTAD::hideBannerAd()
{
log("hideBannerAd() called");
return;
}
#endif