龙图安卓SDK Admob广告功能接入说明

SDK说明

接入龙图安卓SDK的游戏及应用的android客户端开发者。
使用此文档内接口,需要先接入龙图安卓海外SDK。

SDK配置说明

1 接入龙图安卓SDK后,需要配置Admob SDK需要的依赖库。
implementation ‘com.google.android.gms:play-services-ads:20.3.0’
implementation ‘androidx.work:work-runtime-ktx:2.7.0’

2 然后将 AdmobLibrary/libs目录下的jar 或 aar 复制到你的工程的libs文件夹(没有的话须手动创建)

3 添加admob参数,配置到 AndroidManifest.xml 内 meta-data 参数
参数需要找运营同学获取

参考demo/AndroidManifest.xml 文件

参数key 参数说明 是否必选 获取方式
com.google.android.gms.ads.APPLICATION_ID 谷歌gmsid 必选 运营提供

广告回调

接口介绍

  1. /**
  2. * 广告回调
  3. */
  4. LTAdsAdmob.getInstance().setmLTAdsAdmobInterstitialListener(mLTAdsAdmobInterstitialListener);

功能回调说明

接收到的数据为激励视频 播放结果。

接口 接口说明
onInitializationFinished 初始化完成
onAdFailedToShowFullScreenContent 广告展示失败
onAdShowedFullScreenContent 广告展示成功
onAdDismissedFullScreenContent 广告关闭
onAdNoLoaded 广告未加载
onAdFailedToLoad 广告加载失败
onAdLoaded 广告加载成功
onUserEarnedReward 激励广告完成且用户获得奖励
  1. /**
  2. * 视频回调
  3. */
  4. private LTAdsAdmobInterstitialListener mLTAdsAdmobInterstitialListener = new LTAdsAdmobInterstitialListener() {
  5. @Override
  6. public void onInitializationFinished() {
  7. LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "广告初始化成功", Toast.LENGTH_LONG);
  8. }
  9. @Override
  10. public void onAdFailedToShowFullScreenContent(String AdError) {
  11. LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "广告展示失败:" + AdError, Toast.LENGTH_LONG);
  12. }
  13. @Override
  14. public void onAdShowedFullScreenContent() {
  15. LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "广告展示完成", Toast.LENGTH_LONG);
  16. }
  17. @Override
  18. public void onAdDismissedFullScreenContent() {
  19. LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "广告关闭", Toast.LENGTH_LONG);
  20. }
  21. @Override
  22. public void onAdNoLoaded() {
  23. LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "广告未加载", Toast.LENGTH_LONG);
  24. }
  25. @Override
  26. public void onAdFailedToLoad(String loadAdError) {
  27. LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "广告加载失败" + loadAdError, Toast.LENGTH_LONG);
  28. }
  29. @Override
  30. public void onAdLoaded() {
  31. LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "广告加载完成", Toast.LENGTH_LONG);
  32. }
  33. @Override
  34. public void onUserEarnedReward(int amount, String type) {
  35. LTToast.makeText(LTBase_Demo_MainActivity.mMainActivity, "广告收益" + amount + "#" + type, Toast.LENGTH_LONG);
  36. }
  37. };

广告初始化

接口介绍

用于初始化Admob广告平台

接口介绍

  1. /**
  2. * 初始化广告平台
  3. * 初始化结果通过广告的回调获得
  4. *
  5. *@param activity 当前activity实列
  6. */
  7. public void initAdmob(Activity activity);

接口使用说明

  1. /**
  2. * 初始化广告平台
  3. * 初始化结果通过各类型广告的回调获得
  4. *
  5. * @param activity 当前activity实列
  6. */
  7. LTAdsAdmob.getInstance().initAdmob(this);

1.1 加载插页广告

1.1.1 功能介绍

缓存插页广告,研发可以先缓存一份广告,用于加速广告播放。建议提前缓存

1.1.2 接口使用说明

  1. /**
  2. * 插页广告 加载
  3. * @param Activity 当前activity实列
  4. * @param ad_unit_id admob平台创建的广告类型ID(找运营获取)
  5. */
  6. public void LTLoadInterstitialAd(Activity activity, String ad_unit_id)

1.1.3 接口使用说明

  1. /**
  2. *
  3. * 插页广告 加载
  4. * @param activity 当前activity实列
  5. * @param ad_unit_id admob平台创建的广告类型ID
  6. */
  7. LTAdsAdmob.getInstance().LTLoadInterstitialAd(this, "广告单元ID");

1.2 播放插页广告

1.2.1 功能介绍

播放加载完成广告。

1.2.2 接口使用说明

  1. /**
  2. * 播放插页广告
  3. * @param Activity 当前activity实列
  4. * @param PositionId 游戏内播放广告位id
  5. * @param PositionName 游戏内播放广告位名称
  6. */
  7. public void LTShowInterstitialAd(Activity activity,String PositionId, String PositionName)

1.2.3 接口使用说明

  1. /**
  2. * 播放插页广告
  3. * @param Activity 当前activity实列
  4. */
  5. LTAdsAdmob.getInstance().LTShowInterstitialAd(this, "1001", "增加体力");

1.3 加载并播放插页广告

1.3.1 功能介绍

调用此接口后广告先加载,加载完成以后自动播放。

1.3.2 接口介绍

  1. /**
  2. * 插页广告 加载并播放
  3. * @param activity 当前activity实列
  4. * @param ad_unit_id admob平台创建的广告类型ID
  5. * @param PositionId 游戏内播放广告位id
  6. * @param PositionName 游戏内播放广告位名称
  7. */
  8. public void LTLoadAndShowInterstitialAd(Activity activity, String ad_unit_id, String PositionId, String PositionName)

1.3.3 接口调用

  1. /**
  2. * 插页广告 加载并播放
  3. * @param activity 当前activity实列
  4. * @param ad_unit_id admob平台创建的广告类型ID
  5. */
  6. LTAdsAdmob.getInstance().LTLoadAndShowInterstitialAd(this, "广告单元ID", "1001", "增加体力");