1. 理解AdMob插页式广告的异步加载机制
在使用admob集成插页式广告时，开发者常遇到的问题是广告无法显示，调试时发现广告对象为null。这通常是由于对admob广告的异步加载机制理解不足导致的。与传统的同步操作不同，admob广告的加载是一个耗时操作，它会在后台进行网络请求，下载广告素材。在加载完成之前，尝试显示广告对象将导致nullpointerexception或广告不显示。
核心问题所在：
原始代码中的问题在于，在调用 adsManager.loadInterstatialAd() 之后，立即尝试通过 mInterstitialAd.show() 显示广告：
adsManager = new AdsManager(this);
mInterstitialAd = adsManager.loadInterstatialAd(); // 开始加载广告，但此时mInterstitialAd仍为null
if (mInterstitialAd != null) { // 此时mInterstitialAd几乎总是null
mInterstitialAd.show(ColoringActivity.this);
}loadInterstatialAd() 方法内部会启动一个异步加载过程，并通过 InterstitialAdLoadCallback 回调通知加载结果。在 onAdLoaded 被调用并将加载成功的 InterstitialAd 实例赋值给 mInterstitialAd 之前，外部的 mInterstitialAd 仍然是其初始值（null）。因此，条件判断 if (mInterstitialAd != null) 始终为假，广告自然无法显示。
正确思路： 广告必须先成功加载，然后才能显示。加载过程是异步的，这意味着我们不能立即显示，而必须等待加载完成的回调。
2. AdMob插页式广告的正确集成流程
为了确保插页式广告能够正确加载和显示，我们需要遵循以下步骤：
2.1 依赖配置与权限声明
在开始之前，请确保您的项目已正确配置AdMob SDK。
build.gradle (Module):
dependencies {
implementation 'com.google.android.gms:play-services-ads:22.6.0' // 保持最新版本
}AndroidManifest.xml:
注意： 确保您的APPLICATION_ID与您在AdMob后台创建的应用ID一致。对于测试，可以使用Google提供的测试ID。
2.2 AdMob SDK初始化
在应用的启动阶段（例如，主Activity的onCreate方法中），初始化AdMob SDK。
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
MobileAds.initialize(this, new OnInitializationCompleteListener() {
@Override
public void onInitializationComplete(InitializationStatus initializationStatus) {
// AdMob SDK 初始化完成
Log.d("AdMob", "AdMob SDK initialized!");
}
});
}
}或者在Activity中：
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
MobileAds.initialize(this, initializationStatus -> {
// AdMob SDK 初始化完成
Log.d("AdMob", "AdMob SDK initialized!");
});
}
}2.3 优化 AdsManager 类设计
为了更好地管理广告生命周期和异步回调，建议重新设计 AdsManager 类。它应该负责加载广告，并通过回调通知Activity广告的状态。
import android.app.Activity;
import android.content.Context;
import android.util.Log;
import androidx.annotation.NonNull;
import com.google.android.gms.ads.AdError;
import com.google.android.gms.ads.AdRequest;
import com.google.android.gms.ads.FullScreenContentCallback;
import com.google.android.gms.ads.LoadAdError;
import com.google.android.gms.ads.interstitial.InterstitialAd;
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class AdsManager {
private static final String TAG = "AdsManager";
private Context context;
private InterstitialAd mInterstitialAd;
private String interstitialAdUnitId;
// 定义一个回调接口，用于通知Activity广告状态
public interface InterstitialAdListener {
void onAdLoaded();
void onAdFailedToLoad(LoadAdError adError);
void void onAdShowed();
void onAdDismissed();
void onAdFailedToShow(AdError adError);
}
private InterstitialAdListener adListener;
public AdsManager (Context context, String adUnitId, InterstitialAdListener listener) {
this.context = context;
this.interstitialAdUnitId = adUnitId;
this.adListener = listener;
// AdMob SDK 初始化通常在Application类中进行，这里不再重复
// MobileAds.initialize(context, new OnInitializationCompleteListener() { /* ... */ });
}
/**
* 加载插页式广告。
* 广告加载是异步的，结果通过 InterstitialAdListener 回调。
*/
public void loadInterstitialAd () {
if (mInterstitialAd != null) {
Log.d(TAG, "Interstitial ad is already loaded. No need to load again.");
if (adListener != null) {
adListener.onAdLoaded(); // 告知已加载
}
return;
}
AdRequest adRequest = new AdRequest.Builder().build();
InterstitialAd.load(context, interstitialAdUnitId, adRequest, new InterstitialAdLoadCallback() {
@Override
public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
super.onAdFailedToLoad(loadAdError);
Log.d(TAG, "Interstitial ad failed to load: " + loadAdError.getMessage());
mInterstitialAd = null; // 加载失败，确保置空
if (adListener != null) {
adListener.onAdFailedToLoad(loadAdError);
}
}
@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
super.onAdLoaded(interstitialAd);
mInterstitialAd = interstitialAd;
Log.d(TAG, "Interstitial ad loaded successfully.");
mInterstitialAd.setFullScreenContentCallback(new FullScreenContentCallback() {
@Override
public void onAdClicked() {
super.onAdClicked();
Log.d(TAG, "Ad was clicked.");
}
@Override
public void onAdDismissedFullScreenContent() {
super.onAdDismissedFullScreenContent();
Log.d(TAG, "Ad was dismissed.");
mInterstitialAd = null; // 广告显示后即失效，需置空以便重新加载
if (adListener != null) {
adListener.onAdDismissed();
}
// 建议在此处重新加载下一个插页式广告
// loadInterstitialAd();
}
@Override
public void onAdFailedToShowFullScreenContent(@NonNull AdError adError) {
super.onAdFailedToShowFullScreenContent(adError);
Log.e(TAG, "Ad failed to show: " + adError.getMessage());
mInterstitialAd = null; // 显示失败，确保置空
if (adListener != null) {
adListener.onAdFailedToShow(adError);
}
}
@Override
public void onAdImpression() {
super.onAdImpression();
Log.d(TAG, "Ad recorded an impression.");
}
@Override
public void onAdShowedFullScreenContent() {
super.onAdShowedFullScreenContent();
Log.d(TAG, "Ad showed full screen content.");
if (adListener != null) {
adListener.onAdShowed();
}
// 广告显示后，mInterstitialAd会被置空，以便下次重新加载。
// 这里可以不立即置空，因为onAdDismissedFullScreenContent会处理。
// mInterstitialAd = null;
}
});
if (adListener != null) {
adListener.onAdLoaded();
}
}
});
}
/**
* 显示插页式广告。
* 只有当广告已加载且不为null时才能显示。
*/
public void showInterstitialAd (Activity activity) {
if (mInterstitialAd != null) {
mInterstitialAd.show(activity);
} else {
Log.d(TAG, "Interstitial ad is not ready yet. Please load it first.");
// 可以在这里选择重新加载广告，或者提示用户
// loadInterstitialAd();
}
}
/**
* 检查广告是否已加载。
*/
public boolean isAdLoaded() {
return mInterstitialAd != null;
}
}关键改进点：
- loadInterstitialAd() 方法不再直接返回 mInterstitialAd，而是通过 InterstitialAdListener 接口通知调用者广告的加载状态。
- mInterstitialAd 在 onAdLoaded 回调中被赋值，确保只有在广告真正加载成功后才持有实例。
- 在 onAdDismissedFullScreenContent 或 onAdFailedToShowFullScreenContent 中将 mInterstitialAd 置为 null，因为插页式广告是“一次性”的，每次显示后都需要重新加载。
- 提供了 isAdLoaded() 方法，允许Activity在显示广告前进行检查。
2.4 在Activity中正确使用 AdsManager
Activity现在需要实现 InterstitialAdListener 接口，并在适当的时机加载和显示广告。
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;
import com.google.android.gms.ads.LoadAdError;
import com.google.android.gms.ads.AdError;
public class ColoringActivity extends AppCompatActivity implements AdsManager.InterstitialAdListener {
private static final String TAG = "ColoringActivity";
private AdsManager adsManager;
private Button showAdButton;
// 使用Google提供的测试广告单元ID
private static final String INTERSTITIAL_AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712";
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_coloring); // 假设您的布局包含一个按钮
// 初始化 AdsManager
adsManager = new AdsManager(this, INTERSTITIAL_AD_UNIT_ID, this);
showAdButton = findViewById(R.id.show_ad_button); // 假设您有一个ID为show_ad_button的按钮
showAdButton.setEnabled(false); // 默认禁用，直到广告加载完成
// 在Activity生命周期的早期加载广告，例如 onCreate 或 onResume
// 这样可以提前加载，提高用户体验
adsManager.loadInterstitialAd();
showAdButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (adsManager.isAdLoaded()) {
adsManager.showInterstitialAd(ColoringActivity.this);
} else {
Log.d(TAG, "Interstitial ad is not yet loaded. Trying to load again.");
// 如果用户点击时广告未准备好，可以尝试重新加载
adsManager.loadInterstitialAd();
// 也可以给用户一个提示
}
}
});
}
@Override
protected void onResume() {
super.onResume();
// 可以在这里再次检查并加载广告，确保广告在用户重新进入Activity时准备就绪
// adsManager.loadInterstitialAd();
}
// 实现 AdsManager.InterstitialAdListener 接口的方法
@Override
public void onAdLoaded() {
Log.d(TAG, "Interstitial ad is ready to be shown!");
// 广告加载成功，现在可以启用显示广告的按钮或触发显示逻辑
if (showAdButton != null) {
showAdButton.setEnabled(true);
}
}
@Override
public void onAdFailedToLoad(LoadAdError adError) {
Log.e(TAG, "Interstitial ad failed to load: " + adError.getMessage());
// 广告加载失败，可以禁用显示按钮或显示错误信息
if (showAdButton != null) {
showAdButton.setEnabled(false);
}
}
@Override
public void onAdShowed() {
Log.d(TAG, "Interstitial ad showed.");
// 广告已显示，通常在此处禁用按钮，因为广告显示后需要重新加载
if (showAdButton != null) {
showAdButton.setEnabled(false);
}
}
@Override
public void onAdDismissed() {
Log.d(TAG, "Interstitial ad dismissed. Loading a new one.");
// 广告被用户关闭，此时广告已失效，需要重新加载下一个广告
adsManager.loadInterstitialAd();
// 重新加载后，按钮会再次被 onAdLoaded 启用
}
@Override
public void onAdFailedToShow(AdError adError) {
Log.e(TAG, "Interstitial ad failed to show: " + adError.getMessage());
// 广告显示失败，同样需要重新加载
adsManager.loadInterstitialAd();
if (showAdButton != null) {
showAdButton.setEnabled(false);
}
}
}3. 注意事项与最佳实践
- 异步加载的本质： 始终记住广告加载是异步的。不要在调用 load 方法后立即尝试 show，而应通过回调函数来处理广告加载完成的事件。
- 提前加载： 建议在用户可能看到广告之前（例如，在Activity的onCreate或onResume方法中）预加载插页式广告。这可以减少用户等待时间，提升用户体验。
- 一次性使用： 插页式广告在显示一次后就会失效。每次用户关闭广告或广告显示失败后，您都需要
