cocos creator2.4 导出安卓 接入穿山甲 视频广告 最详细 教程 附带js与java互调

首先非常感谢两位大神的经验分享,我也是参考这两位的教程 才能一个安卓小白的情况,实现cocos creator导出安卓接入穿山甲广告成功的。csdn 的 MrLizs 以及 橘子呀c

首先阅读MrLizs的教程贴,我大部分java代码都是在这里面复制的,会方便很多,一定要看清楚,里面的环境配置,还有安卓工程配置
https://blog.csdn.net/MrLizs/article/details/106728558;
其次可以参考 橘子呀c 的教程贴,接入过程中遇到很多问题也是在这里找到灵感,banner广告接入我是参考他的后续教程的
https://blog.csdn.net/qq_34772097/article/details/101468072
另外也要参考穿山甲的接入文档。

接下来请先确保你安卓的环境配置正确 java 安装android studio 然后在里面安装ndk sdk 等等。我用的是android studio3.5,一般要求android studio3.0以上,这里推荐用android studio3.5,可能会避免版本问题导致的打包出错。
其实修改内容很少,但是为了和我一样的android小白少走弯路,我尽量每步都截图。文件路径说清楚。所以会显得文章偏长,没办法作为一个小白,太容易遇到坑了,打包apk你都不知道点哪个
下面是我cocos creator2.4构建项目的选项,APP ABI 这里我建议是全部勾选,因为我当时没有全选后面加好代码某些机型真机运行报错。


image.png

我是用cocos creator2.4 导出的正式安卓工程目录,(cocos creator导出的时候只要构建成功就好 ,编译步骤在android studio加入代码后再进行)下面图,是我用android studio打开 cocos creator项目根目录\build\jsb-default\frameworks\runtime-src\proj.android-studio (这个就是安卓工程的根目录 ), 我们大部分代码修改都是位于项目工程的app底下


image.png

接着我们在app文件夹底下新建libs文件夹 ,把下载的穿山甲sdk 文件中 open_ad_sdk.aar放入此文件夹内。如下图:


image.png

步骤一:修改build.gradle

文件路径jsb-default\frameworks\runtime-src\proj.android-studio\app\build.gradle
如果仔细看app文件夹底下的build.gradle 文件 就会知道里面已经自动引入了app/libs 文件夹底下所有的aar文件,但是接下来还要修改这个app文件夹底下的build.gradle文件(上图已经指出的文件)。
这是build.gradle原本的文件头部内容


image.png

我们需要在 android 内容里面加入一行

compileSdkVersion 28

在defaultConfig内容里面修改

  minSdkVersion 16     
  targetSdkVersion 28

并且加入

     ndk {
            //选择要添加的对应cpu类型的.so库。   // 还可以添加 'x86', 'x86_64', 'mips', 'mips64'
            abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        }

修改后build.gradle如图下


image.png

然后在build.gradle文件里面 找到 dependencies 项在此内容里面添加一行代码;
我这边的情况是这行代码不加的话,后面运行项目始终报错找不到 open_ad_sdk 穿山甲sdk里面的广告代码文件,这个是我们公司的安卓大神帮我找到问题。我看上面几篇教程中并没有这一块的修改说明。也许他们的项目中没有遇到这个问题吧哈哈。这行代码你们如果加入报错可以先试着删除,不过一般是没什么问题的
如下图:

implementation 'com.android.support:appcompat-v7:28.0.0'      
image.png

步骤二:修改AndroidManifest.xml

文件路径
jsb-default\frameworks\runtime-src\proj.android-studio\app\AndroidManifest.xml
在app目录底下打开AndroidManifest.xml
首先添加申请权限代码,找到原本的 uses-permission 权限申请代码,在之后添加如下代码

    
    
    
    
    
    
    
    

    
    

修改后的如下图


image.png

接着在AndroidManifest.xml 文件中找到 application ,在application内容里面加上穿山甲广告需要的provider 代码

       
            
        

        

修改后如下图


image.png

步骤三 添加 file_paths.xml 文件

文件路径
jsb-default\frameworks\runtime-src\proj.android-studio\res\xml\file_paths.xml
首先在安卓根目录 proj.android-studio 文件夹底下找到 res文件夹 在里面新建 xml 文件夹,再于xml文件夹内新建 file_paths.xml 文件,文件路劲如上面已经给出
(另外插一句题外话,如果要修改cocos creator 导出的android项目中文名 res文件夹底下的values/strings.xml 文件里面修改,icon图标文件修改也是位于res文件夹底下mipmap)
文件内容代码



    
    
    
    
    
    

如下图


image.png

步骤四 修改逻辑代码文件

文件路径
jsb-default\frameworks\runtime-src\proj.android-studio\src\org\cocos2dx\javascript
接下来是java调用穿山甲sdk展示广告了
首先在proj.android-studio\src\org\cocos2dx\javascript新建TTAdManagerHolder.java 穿山甲sdk配置代码文件,代码如下

package org.cocos2dx.javascript;

import android.content.Context;

import com.bytedance.sdk.openadsdk.TTAdConfig;
import com.bytedance.sdk.openadsdk.TTAdConstant;
import com.bytedance.sdk.openadsdk.TTAdManager;
import com.bytedance.sdk.openadsdk.TTAdSdk;

/**
 * 可以用一个单例来保存TTAdManager实例,在需要初始化sdk的时候调用
 */
public class TTAdManagerHolder {

    private static boolean sInit;


    public static TTAdManager get() {
        if (!sInit) {
            throw new RuntimeException("TTAdSdk is not init, please check.");
        }
        return TTAdSdk.getAdManager();
    }

    public static void init(Context context) {
        doInit(context);
    }

    //step1:接入网盟广告sdk的初始化操作,详情见接入文档和穿山甲平台说明
    private static void doInit(Context context) {
        if (!sInit) {
            TTAdSdk.init(context, buildConfig(context));
            sInit = true;
        }
    }

    private static TTAdConfig buildConfig(Context context) {
        return new TTAdConfig.Builder()
                .appId("5001121")//这里填入穿山甲后台创建的应用id
                .useTextureView(true) //使用TextureView控件播放视频,默认为SurfaceView,当有SurfaceView冲突的场景,可以使用TextureView
                .appName("你的应用名称" )
                .titleBarTheme(TTAdConstant.TITLE_BAR_THEME_DARK)
                .allowShowNotify(true) //是否允许sdk展示通知栏提示
                .allowShowPageWhenScreenLock(true) //是否在锁屏场景支持展示广告落地页
                .debug(true) //测试阶段打开,可以通过日志排查问题,上线时去除该调用
                .directDownloadNetworkType(TTAdConstant.NETWORK_STATE_WIFI) //允许直接下载的网络状态集合
                .supportMultiProcess(true) //是否支持多进程,true支持
                .asyncInit(true) //异步初始化sdk,开启可减少初始化耗时
                //.httpStack(new MyOkStack3())//自定义网络库,demo中给出了okhttp3版本的样例,其余请自行开发或者咨询工作人员。
                .build();
    }
}

android studio 中如下图


image.png

接着打开proj.android-studio\src\org\cocos2dx\javascript\AppActivity.java 文件
import 引入包的 代码下加入

import org.cocos2dx.lib.Cocos2dxJavascriptJavaBridge;
import android.util.Log;
import com.bytedance.sdk.openadsdk.AdSlot;
import com.bytedance.sdk.openadsdk.TTAdConstant;
import com.bytedance.sdk.openadsdk.TTAdManager;
import com.bytedance.sdk.openadsdk.TTAdNative;
import com.bytedance.sdk.openadsdk.TTRewardVideoAd;

在AppActivity类里面加入如下代码

    //初始化代码
    static public AppActivity activity;
    private String TAG = "cocos日志";
    private TTAdNative mTTAdNative;
    private TTRewardVideoAd mttRewardVideoAd;

如下图


image.png

在AppActivity类里面的onCreate方法里面加入如下代码

        //穿山甲广告
        TTAdManagerHolder.init(this);
        activity = this;
//step1:初始化sdk
        TTAdManager ttAdManager = TTAdManagerHolder.get();
//step2:(可选,强烈建议在合适的时机调用):申请部分权限,如read_phone_state,防止获取不了imei时候,下载类广告没有填充的问题。
        TTAdManagerHolder.get().requestPermissionIfNecessary(this);
//step3:创建TTAdNative对象,用于调用广告请求接口
        mTTAdNative = ttAdManager.createAdNative(getApplicationContext());
        loadAd("你的激励视频广告位id", TTAdConstant.VERTICAL);

如下图


image.png

在AppActivity里最底下增加以下方法:

    //播放广告方法,js中调用此方法。传入广告位id  codeId
    static public void showAd(String codeId) {
        Log.e(activity.TAG, "java广告方法");
        activity.runOnUiThread(new Runnable() {
            @Override
            public void run() {
                if (activity.mttRewardVideoAd != null) {
                    //step6:在获取到广告后展示
                    //该方法直接展示广告
                    activity.mttRewardVideoAd.showRewardVideoAd(activity);
                    //展示广告,并传入广告展示的场景
                    activity.mttRewardVideoAd = null;
                } else {
                    Log.e(activity.TAG, "请先加载广告");
                }
            }
        });
    }

  public void sendReward() {
        Log.e(activity.TAG,"奖励发放java调用");
        activity.runOnGLThread(new Runnable() {
            @Override
            public void run() {

                String js = "adController.adEnd()";
                Cocos2dxJavascriptJavaBridge.evalString(js);
                Log.e(activity.TAG,"奖励发放完毕");
            }
        });
    }

    private void loadAd(final String codeId, int orientation) {
        //step4:创建广告请求参数AdSlot,具体参数含义参考文档
        AdSlot adSlot = new AdSlot.Builder()
                .setCodeId(codeId)
                .setSupportDeepLink(true)
                .setImageAcceptedSize(1080, 1920)
                .setRewardAmount(1)  //奖励的数量
                .setUserID("1111")//用户id,必传参数,穿山甲后台可以看到你的用户id
                .setOrientation(orientation) //必填参数,期望视频的播放方向:TTAdConstant.HORIZONTAL 或 TTAdConstant.VERTICAL
                .build();
        //step5:请求广告
        mTTAdNative.loadRewardVideoAd(adSlot, new TTAdNative.RewardVideoAdListener() {
            @Override
            public void onError(int code, String message) {
                Log.e(TAG, message);
            }

            //视频广告加载后,视频资源缓存到本地的回调,在此回调后,播放本地视频,流畅不阻塞。
            @Override
            public void onRewardVideoCached() {
                Log.e(TAG, "rewardVideoAd video cached");
            }

            //视频广告的素材加载完毕,比如视频url等,在此回调后,可以播放在线视频,网络不好可能出现加载缓冲,影响体验。
            @Override
            public void onRewardVideoAdLoad(TTRewardVideoAd ad) {
                Log.e(TAG, "视频广告已经加载");
                mttRewardVideoAd = ad;
                mttRewardVideoAd.setRewardAdInteractionListener(new TTRewardVideoAd.RewardAdInteractionListener() {

                    @Override
                    public void onAdShow() {
                        Log.e(TAG, "视频广告播放");
                    }

                    @Override
                    public void onAdVideoBarClick() {
                        Log.e(TAG, "rewardVideoAd bar click");
                    }

                    @Override
                    public void onAdClose() {
                        Log.e(TAG, "rewardVideoAd close");
                        //关闭后再次加载广告
                        loadAd(codeId, TTAdConstant.VERTICAL);
                    }

                    //视频播放完成回调
                    @Override
                    public void onVideoComplete() {
                        Log.e(TAG,"rewardVideoAd complete");
                    }

                    @Override
                    public void onVideoError() {
                        Log.e(TAG,"rewardVideoAd error");
                    }

                    //视频播放完成后,奖励验证回调,rewardVerify:是否有效,rewardAmount:奖励梳理,rewardName:奖励名称
                    @Override
                    public void onRewardVerify(boolean rewardVerify, int rewardAmount, String rewardName, int var4, String var5) {
                        Log.e(TAG,"广告播放完成回调");

                        //发放奖励
                        sendReward();
                    }

                    @Override
                    public void onSkippedVideo() {
                    }
                });
            }
        });
    }

如下图


image.png

image.png

另外提一句,大家看看就好。上面的java代码中方法是会随着穿山甲sdk变动的,不过频率还是比较低的。要注意结合穿山甲官方文档和demo。比如onRewardVerify这个方法,老版本是只有三个参数,我从别的教程中复制的代码也只有三个参数,2020-11-24号下载的sdk中封装的onRewardVerify是五个参数,所以运行报错。之后看到的文档中是五个参数,所以这块也要改成五个参数,大家根据自己的情况决定。反正报错这块多看日志多百度。我也是安卓小白,但也能解决。

这个时候编辑器报错,关于sdk的引入这些文件都有红线,可以点击android studio 按钮file-》invalidate 按钮重启,这样编辑器就能识别到文件并且ctrl+鼠标左键点击就可以跳转

或者鼠标双击类名 然后alt+enter 键可以import class引入类


image.png

这里点击真机运行选择你要编译的项目,项目运行成功,广告播放成功

image.png

以下为补充说明

另外记得选中你自己的项目名而不是instantapp ,我们修改的文件夹都是proj.android-studio\app底下的build.gradle AndroidManifest.xml 还有skd文件夹libs也是放于app目录下。如果想编译instant,记得把app文件夹底下的修改,在proj.android-studio\game文件夹底下找到相应的文件一起改。
打包测试


image.png

如果遇到真机运行正常,打测试包build APKS 的时候报错没有找到穿山甲sdk,可以修改 proj.android-studio\settings.gradle,将:instantapp去掉,这样就不会编译instantapp,如下图


image.png

关于js调用java播放广告代码,js 代码 再你想要播放广告的时候

    /**
     * js调用java广告播放
     * @param type 区分回调事件
     * @param paragram 回调事件的参数
     */
    adPlay(type,paragram=false){
        this.adType = type;
        this.adParagram = paragram;
        if(cc.sys.isNative && cc.sys.os == cc.sys.OS_ANDROID) {
            cc.log('广告播放')
            jsb.reflection.callStaticMethod("org/cocos2dx/javascript/AppActivity", "showAd","(Ljava/lang/String;)V","你的广告位id");
        }
    },

关于java调用js 广告回调代码 j
java方面代码位于AppActivity类修改 sendReward方法中

              //  java调用js的全局方法adController的子方法adEnd()
              String js = "adController.adEnd()";
              Cocos2dxJavascriptJavaBridge.evalString(js);

js方面代码声明全局方法adEnd,记得在onload里面,调用广告前初始化

    /**
     * js端广告回调全局方法
     */
        var self = this;
        let foo = {
            adEnd : function(){
                console.info("js端广告回调成功");
                //复活
                if(self.adType  == "复活"){
                    self.revivalAction((self.paragram);
                }
        }
        window["adController"]=foo;

最后补充一个坑,如果遇到,真机调试可以,打包测试包也可以,但是打包正式包报错有proguard字眼的。且试过加了穿山甲文档中混淆代码没用的。可以试试我这个方法,禁用proguard,但是不推荐。修改proj.android-studio\app\build.gradle文件 ,搜索找到minifyEnabled 与 shrinkResources 修改为false,我是个安卓小白,暂时找不到更好的办法。这个坑当时困扰很久,幸得群里面道友指点。果然还是做php后端还有小程序网站更适合我

    minifyEnabled false
    shrinkResources false

最后,如果文章对你有帮助记得点赞喔,如果接入过程遇到其他问题,可以在下方留言,我会不定时看下问题,解答我会的

你可能感兴趣的:(cocos creator2.4 导出安卓 接入穿山甲 视频广告 最详细 教程 附带js与java互调)