#npm包cordova-plugin-admob使用教程
本文将详细介绍npm包cordova-plugin-admob的使用方法,包括安装、配置、示例代码和注意事项等。
##1.安装
在终端中输入如下命令进行npm安装:
npm install cordova-plugin-admob --save
##2.配置
###2.1 集成cordova-plugin-admob
在你的cordova项目中加入cordova-plugin-admob:
cordova plugin add cordova-plugin-admob
###2.2 配置应用ID
在cordova-plugin-admob 插件的Android 平台配置信息中,需要配置广告商提供的应用ID。该应用ID 主要是调用平台广告 API时需要传入的参数。应用ID 在平台控制台中受到保护,需要由发布人员进行配置。
###2.3 JAR和Manifest 权限
cordova-plugin-admob 使用到了Google Play Services和Google Mobile Ads SDK。
需要将 Google Mobile Ads SDK、play-services 相关 jars,放置在${主项目}/libs 文件夹下,或使用Gradle进行配置,方法如下:
在 ${主项目}/platforms/android 下创建 build-extras.gradle 文件,加入如下代码:
-- -------------------- ---- ------- ----------- - ------------ - --------- - -------------- - ------- - ------- ------ ------------------------ - - ------------ - ------- ------------------------------------------------ ------- ------------------------------------------------------ ------- ------------------------------------------------ ------- ----------------------------------------------------- - -
将 ${主项目}/platforms/android/cordova-plugin-admob.xml 替换为以下内容:
-- -------------------- ---- ------- ----- ------------- ------------------ ------- ------------------------------------------------ ---------------------------------------------------------- ------------------------- ----------------- ------------------ -------------------- ------ --- ------ ------------------- --------- --------------- ------------ ------------------ ----------------------------- ---------------- ------------------------------------------ -- ---------------- ------------------------------------------------------ -- ---------------- --------------------------------------------------- -- ---------------- -------------------------------------------------- -- -------------- ------------ ------------------------------ ----------------------------- ---- -------- --- --------- ---------------------------------------------------- ------------------------------------------------------------------------------------------------------------- -------------------------------------------------- ---- -------- ---- ----- --------- --- --------- ----------------------------------------------------------- ------------------------------------------------------------------------------------------------------------- -- --------- ------------------------------------------------------------------------ --------------------------------------------------------------------------------------------------------------- ---------- --------------------------------------------- ------------------------------------------------------- ---- --- -- --- --- ---- -------- ---- --- -- --- ----- ---- ------ ---- -------- ------- --- ---------- -------------------------------------------------------- ---------------------------------- ---- ----- --- -- --- ------- --- ---- -- ---- --- ------ --- ---------- --- ---------- -------------------------- ------------------ -------------- ------------ ------------------- ---------------------------- ----------- ------------------------------------------------ ------------------------ -- ----------- ------------------------ ------------- -- ----------- -------------------- ------------- -- ----------- --------------------- ------------ -- ----------- ------------------------ ------------- -- ----------- ------------- -------------------- -- ----------- -------------------- ------------- -- ----------- --------------- ----------- -- ----------- ----------------------- ------------- -- ----------- ----------------------- ------------- -- ----------- --------------------------- ------------- -- ----------- ----------------------------- ------------- -- ----------- ------------------------ ------------- -- ----------- ----------------------- ----------------------- -- ----------- ----------------- ----------------------- -- ----------- ---------------- --------------------------- -- -------------- ----------- ---------
注意,将AndroidManifest.xml 中的 应用id,替换成自己获取的 应用 id
此外,在 AndroidManifest.xml 的application 标签中打入以下meta-data信息:
<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" /> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="@string/admob_app_id" />
##3.使用方法
cordova-plugin-admob 提供了以下的API:
window.AdMob.createBanner
创建一个广告横幅。
参数:
-- -------------------- ---- ------- --------------------------- ----- --------------------- --------- --------------------------------------- --------- ----- ----------- ---------- ------ -------- ------ ------------- ------ -------- -------- ----------------- ----- ---
window.AdMob.removeBanner()
移除当前广告横幅,移除后与banner相关的所有事件将不可用。如果想再次使用,您需要重新创建一个banner。
参数:无。
window.AdMob.showInterstitial
展示插页广告,插页广告需要预先加载,一般展示时间为5~10秒。
参数:
window.AdMob.showInterstitial({ adId: 'ca-app-pub-xxx/yyy', autoShow: true, //以下参数为可选参数 isTesting: false, orientationRenew: false });
window.AdMob.prepareInterstitial
准备插页广告,在页面ready后调用,可以在调用showInterstitial前完成预加载以保证广告的快速展示。
参数:
window.AdMob.prepareInterstitial({ adId: 'ca-app-pub-xxx/yyy', //以下参数为可选参数 isTesting: false });
InterstitialOptions
广告选项。在显示插页广告时可以自定义广告显示的样式。
参数:
-- -------------------- ---- ------- --- ------------------- - - ----- --------------------- ---------- ------ --------- ----- --------- ------- ---------------------------- ------ ---- ------- --- --------- --------------------------------------- -- -- -- - -- ---------------------------------------------------
##4.示例代码
下面是cordova-plugin-admob的示例代码,用于展示一个广告banner:
-- -------------------- ---- ------- ---------------------------------------- ---------- - --- ------- - --- --- -------------------------------------- - - ------- - - -- --- ------- ------- --------------------- ------------- -------------------- -- - --- ------------------- - ----------- ----------------------- -- --- ----------------- - ----------------- ----------------------- -- --- ------------------- - - ----- --------------------- ---------- ------ --------- ----- -- --- ------------ - ---------------------------------------------------- -------------------- ------------------- --- ------------- - ----------- ----------------------------- -- --- ----------- - ----------------- ----------------------------- -------------------- -- --------------------------- ----- --------------- --------- --------------------------------------- --------- ----- ---------- ------ -------- ------ ------------- ------ ------------ ------ -------- -------- ------- -------------- -- -------------- ------------- -- -------
##5.注意事项
- 应用ID需要从广告商处获取,去Google AdMob官网注册;
- 广告展示需要联网;
- 需要在正式环境中去除测试设备的ID;
- 一些原生调用的API需要打包到应用源文件中;
- 在Android中有些阻止广告的APP会使广告无法正常展示;
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600671cc30d09270238228a0