Flutter广告展示插件display_ads的使用

display_ads 插件是一个用于在 Flutter 应用中轻松展示 Google 移动广告的封装。以下是该插件的基本使用方法。

特性

• 显示横幅广告（Banner Ads）
• 显示插屏广告（Interstitial Ads）

开始使用

平台特定设置

Android

确保你的应用使用的最小 SDK 版本为 19 或更高，并且编译 SDK 版本为 33 或更高。

在 AndroidManifest.xml 文件中添加 AdMob 应用 ID：

<manifest>
    <application>
        <!-- Sample AdMob app ID for testing : ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

iOS

在 Info.plist 文件中添加 AdMob 应用 ID 和 SKAdNetwork 信息：

<!-- Sample AdMob app ID for testing : ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <!-- 更多 SKAdNetworkIdentifier -->
</array>

使用插件

初始化插件

首先需要初始化插件，并提供相应的广告单元 ID。

import 'package:display_ads/display_ads.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  DisplayAds.instance.initialize(
    isShowAds: true,
    interstitialAdUnitIdIOS: "Put your interstitial AdUnitId for iOS here",
    interstitialAdUnitIdAndroid: "Put your interstitial AdUnitId for Android here",
    bannerAdUnitIdIOS: "Put your banner AdUnitId for iOS here",
    bannerAdUnitIdAndroid: "Put your banner AdUnitId for Android here",
  );
  runApp(const MyApp());
}

显示横幅广告

你可以通过以下方法来显示横幅广告：

DisplayAds.instance.bannerAd()

这个方法返回一个 Widget，可以将其插入到你的 Flutter 界面中。

显示插屏广告

你可以通过以下方法来加载并显示插屏广告：

DisplayAds.instance.loadInterstitialAds();

此方法将加载插屏广告，并可以在任何你希望展示插屏广告的地方调用它。

完整示例代码

import 'package:display_ads/display_ads.dart';
import 'package:flutter/material.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await DisplayAds.instance.initialize(
    isShowAds: true,
    interstitialAdUnitIdIOS: 'ca-app-pub-3940256099942544/4411468910',
    interstitialAdUnitIdAndroid: 'ca-app-pub-3940256099942544/1033173712',
    bannerAdUnitIdIOS: 'ca-app-pub-3940256099942544/2934735716',
    bannerAdUnitIdAndroid: 'ca-app-pub-3940256099942544/6300978111',
  );
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  void _showInterstitialAds() {
    DisplayAds.instance.loadInterstitialAds();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: Scaffold(
        appBar: AppBar(
          backgroundColor: Theme.of(context).colorScheme.inversePrimary,
          title: const Text("Example of Display Ads"),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              DisplayAds.instance.bannerAd(), // 显示横幅广告
              ElevatedButton(
                onPressed: _showInterstitialAds,
                child: const Text('Show Interstitial Ads'), // 按钮点击时显示插屏广告
              ),
            ],
          ),
        ),
      ),
    );
  }
}