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

SDK说明

本文档旨在说明龙图BaseSDK版本Admob广告功能说明。
本文的所述接口需要在接入龙图海外BaseSDK,并经过打包工具打包之后才可以使用。

使用说明

Admob广告功能封装了广告接口,以方便开发者接入。

1.0 插页广告回调

1.0.1 接口介绍

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

1.0.2 功能回调说明

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

接口 接口说明
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. };

1.1 广告初始化

1.1.1 功能介绍

用于初始化Admob广告平台,
调用初始化前,需要先设置回调接口,以便于接收事件结果。

1.1.2 接口介绍

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

1.1.3 接口使用说明

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

1.2 加载插页广告

1.2.1 功能介绍

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

1.2.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.2.3 接口使用说明

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

1.3 播放插页广告

1.3.1 功能介绍

播放加载完成广告。

1.3.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.3.3 接口使用说明

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

1.4 加载并播放插页广告

1.4.1 功能介绍

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

1.4.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.4.3 接口调用

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