Flutter儿童广告插件apsl_ads_flutter_kids的使用

请展示一些❤️给这个包，点赞👍并⭐️仓库以支持项目！

简化将各种广告网络集成到您的Flutter应用中的过程。

特性

• Google Mobile Ads（横幅广告、应用打开广告、插屏广告、激励广告、原生广告）

Admob Mediation

• 该插件提供了对AdMob中介的支持。详情。
• 简单地添加AdMob中介的本地平台设置。

平台特定设置

iOS

更新你的Info.plist

• 需要在Info.plist中添加Google Ads的关键字。

更新你的应用的ios/Runner/Info.plist文件，添加两个键：

<key>GADApplicationIdentifier</key>
<string>YOUR_SDK_KEY</string>

• 你必须为所有由apsl-ads-flutter提供的网络添加SKAdNetworkItems。你可以在这里复制粘贴SKAdNetworkItems到你的项目中。

Android

更新AndroidManifest.xml

<manifest>
    <application>
        <!-- 示例 AdMob 应用ID: 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>

初始化广告ID

import 'dart:io';

import 'ads_id_manager.dart';

class TestAdsIdManager extends AdsIdManager {
  const TestAdsIdManager();

  [@override](/user/override)
  List<AppAdIds> get appAdIds => [
        AppAdIds(
          adNetwork: 'admob',
          appId: Platform.isAndroid
              ? 'ca-app-pub-3940256099942544~3347511713'
              : 'ca-app-pub-3940256099942544~1458002511',
          appOpenId: Platform.isAndroid
              ? 'ca-app-pub-3940256099942544/3419835294'
              : 'ca-app-pub-3940256099942544/5662855259',
          bannerId: Platform.isAndroid
              ? 'ca-app-pub-3940256099942544/6300978111'
              : 'ca-app-pub-3940256099942544/2934735716',
          interstitialId: Platform.isAndroid
              ? 'ca-app-pub-3940256099942544/1033173712'
              : 'ca-app-pub-3940256099942544/4411468910',
          rewardedId: Platform.isAndroid
              ? 'ca-app-pub-3940256099942544/5224354917'
              : 'ca-app-pub-3940256099942544/1712485313',
          nativeId: Platform.isAndroid
              ? 'ca-app-pub-3940256099942544/2247696110'
              : 'ca-app-pub-3940256099942544/3986624511',
        ),
      ];
}

初始化SDK

在加载广告之前，调用ApslAds.instance.initialize()初始化Mobile Ads SDK。这将初始化SDK并返回一个当初始化完成时（或30秒超时后）完成的Future。这只需要做一次，最好是在运行应用之前。

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

const IAdIdManager adIdManager = TestAdIdManager();

ApslAds.instance.initialize(
  adIdManager,
  adMobAdRequest: const AdRequest(),
  admobConfiguration: RequestConfiguration(testDeviceIds: []),
);

插屏广告/激励广告

加载广告

广告在显示时会自动加载，或者在首次调用initialize()时加载。作为安全措施，你可以调用此方法来加载激励和插屏广告。如果广告已经加载，则不会重新加载。

ApslAds.instance.loadAd();

显示插屏广告或激励广告

ApslAds.instance.showAd(AdUnitType.rewarded);

显示应用打开广告

ApslAds.instance.showAd(AdUnitType.appOpen)

显示横幅广告

这是如何在小部件树中显示横幅广告的方式：

[@override](/user/override)
Widget build(BuildContext context) {
  return Column(
    crossAxisAlignment: CrossAxisAlignment.stretch,
    children: [
      SomeWidget(),
      const Spacer(),
      ApslBannerAd(
        adNetwork: AdNetwork.admob,
        adSize: AdSize.mediumRectangle,
      ),
    ],
  );
}

依次显示所有横幅广告

横幅广告将尝试按您提供的顺序加载广告网络。如果由于任何原因某个网络无法加载，它会自动切换到下一个网络以防止收入损失。

要设置所有横幅广告的顺序，只需在ApslAllBannerAd构造函数中传递orderOfAdNetworks参数即可。否则，默认顺序为[admob, facebook, unity]，默认广告尺寸为AdSize.banner。

这是如何在小部件树中显示横幅广告的方式：

[@override](/user/override)
Widget build(BuildContext context) {
  return Scaffold(
    appBar: AppBar(
      title: Text('我的应用'),
    ),
    body: Column(
      children: [
        // 你的其他小部件...
        ApslAllBannerAd(
          orderOfAdNetworks: [
            AdNetwork.admob,
          ],
          adSize: AdSize.largeBanner,
          // 其他参数...
        ),
        // 你的其他小部件...
      ],
    ),
  );
}

监听回调

在类中声明此对象：

StreamSubscription? _streamSubscription;

以下代码片段演示了显示插屏广告并检查是否已显示的过程： 如果为true，我们取消最后订阅的回调。然后，我们监听流并访问所需的特定事件。

if (ApslAds.instance.showInterstitialAd()) {
  // 取消最后一个订阅的回调
  _streamSubscription?.cancel();
  // 监听来自showInterstitialAd()的回调
  _streamSubscription = ApslAds.instance.onEvent.listen((event) {
    if (event.adUnitType == AdUnitType.interstitial &&
        event.type == AdEventType.adDismissed) {
      _streamSubscription?.cancel();
      goToNextScreen(countryList[index]);
    }
  });
}

示例代码

以下是示例代码的完整实现：

import 'dart:async';
import 'dart:io';

import 'package:apsl_ads_flutter_kids/apsl_ads_flutter_kids.dart';
import 'package:flutter/material.dart';
import 'package:webview_flutter/webview_flutter.dart';

const AdsIdManager adIdManager = TestAdsIdManager();

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ApslAds.instance.initialize(
    isShowAppOpenOnAppStateChange: true,
    adIdManager,
    adMobAdRequest: const AdRequest(),
    admobConfiguration: RequestConfiguration(testDeviceIds: []),
    showAdBadge: false,
  );

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: 'Flutter Apsl Ads 示例',
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  const HomeScreen({Key? key}) : super(key: key);

  [@override](/user/override)
  State<HomeScreen> createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  /// 使用它来取消订阅的回调
  StreamSubscription? _streamSubscription;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("广告列表"),
        centerTitle: true,
      ),
      body: SafeArea(
        child: SingleChildScrollView(
          child: Column(
            children: [
              _sectionTitleWidget(context, title: '应用打开广告'),
              AdListTile(
                networkName: 'Admob 应用打开广告',
                onTap: () => _showAd(AdNetwork.admob, AdUnitType.appOpen),
              ),
              const ApslSequenceNativeAd(templateType: TemplateType.medium),
              const Divider(thickness: 2),
              _sectionTitleWidget(context, title: '插屏广告'),
              AdListTile(
                networkName: 'Admob 插屏广告',
                onTap: () => _showAd(AdNetwork.admob, AdUnitType.interstitial),
              ),
              AdListTile(
                networkName: '显示插屏广告一个接一个',
                onTap: () => _showAvailableAd(AdUnitType.interstitial),
              ),
              const Divider(thickness: 2),
              _sectionTitleWidget(context, title: '激励广告'),
              AdListTile(
                networkName: 'Admob 激励广告',
                onTap: () => _showAd(AdNetwork.admob, AdUnitType.rewarded),
              ),
              AdListTile(
                networkName: '显示激励广告一个接一个',
                onTap: () => _showAvailableAd(AdUnitType.rewarded),
              ),
              AdListTile(
                networkName: "导航广告",
                onTap: () => _showAdOnNavigation(),
              ),
              const ApslSequenceBannerAd(
                orderOfAdNetworks: [
                  AdNetwork.admob,
                ],
              ),
            ],
          ),
        ),
      ),
    );
  }

  Widget _sectionTitleWidget(BuildContext context, {String title = ""}) {
    return ListTile(
      title: Text(
        title,
        style: Theme.of(context)
            .textTheme
            .headlineSmall!
            .copyWith(color: Colors.blue, fontWeight: FontWeight.bold),
      ),
    );
  }

  void _showAd(AdNetwork adNetwork, AdUnitType adUnitType) {
    if (ApslAds.instance.showAd(
      adUnitType,
      adNetwork: adNetwork,
      shouldShowLoader: Platform.isAndroid,
      context: context,
      delayInSeconds: 1,
    )) {
      // 取消最后一个订阅的回调
      _streamSubscription?.cancel();
      // 监听来自showRewardedAd()的回调
      _streamSubscription = ApslAds.instance.onEvent.listen((event) {
        if (event.adUnitType == adUnitType) {
          _streamSubscription?.cancel();
          goToNextScreen(adNetwork: adNetwork);
        }
      });
    } else {
      goToNextScreen(adNetwork: adNetwork);
    }
  }

  void _showAvailableAd(AdUnitType adUnitType) {
    if (ApslAds.instance.showAd(adUnitType)) {
      // 取消最后一个订阅的回调
      _streamSubscription?.cancel();
      // 监听来自showRewardedAd()的回调
      _streamSubscription = ApslAds.instance.onEvent.listen((event) {
        if (event.adUnitType == adUnitType) {
          _streamSubscription?.cancel();
          goToNextScreen();
        }
      });
    } else {
      goToNextScreen();
    }
  }

  void _showAdOnNavigation() {
    if (ApslAds.instance.showAdOnNavigation()) {
      // 取消最后一个订阅的回调
      _streamSubscription?.cancel();
      // 监听来自showRewardedAd()的回调
      _streamSubscription = ApslAds.instance.onEvent.listen((event) {
        if (event.adUnitType == AdUnitType.interstitial) {
          if (event.type == AdEventType.adFailedToLoad ||
              event.type == AdEventType.adDismissed) {
            _streamSubscription?.cancel();
            goToNextScreen();
          }
        }
      });
    } else {
      goToNextScreen();
    }
  }

  void goToNextScreen({AdNetwork? adNetwork}) {
    Navigator.push(
      context,
      MaterialPageRoute(
        builder: (context) => DetailScreen(adNetwork: adNetwork),
      ),
    );
  }
}

class DetailScreen extends StatefulWidget {
  final AdNetwork? adNetwork;
  const DetailScreen({super.key, this.adNetwork = AdNetwork.admob});

  [@override](/user/override)
  State<DetailScreen> createState() => _DetailScreenState();
}

class _DetailScreenState extends State<DetailScreen> {
  late final WebViewController _webViewController;

  [@override](/user/override)
  void initState() {
    super.initState();

    _webViewController = WebViewController()
      ..setJavaScriptMode(JavaScriptMode.unrestricted)
      ..setBackgroundColor(const Color(0x00000000))
      ..setNavigationDelegate(
        NavigationDelegate(
          onProgress: (int progress) {
            // 更新加载进度条。
          },
          onPageStarted: (String url) {},
          onPageFinished: (String url) {},
          onWebResourceError: (WebResourceError error) {},
          onNavigationRequest: (NavigationRequest request) {
            if (request.url.startsWith('https://www.youtube.com/')) {
              return NavigationDecision.prevent;
            }
            return NavigationDecision.navigate;
          },
        ),
      )
      ..loadRequest(Uri.parse(
          "https://support.google.com/admob/answer/9234653?hl=en#:~:text=AdMob%20is%20a%20mobile%20ad,helping%20you%20serve%20ads%20globally."));
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("ApslAds 示例")),
      body: WebViewWidget(
        controller: _webViewController,
      ),
    );
  }
}

class AdListTile extends StatelessWidget {
  final String networkName;
  final VoidCallback onTap;
  const AdListTile({super.key, required this.networkName, required this.onTap});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return ListTile(
      title: Text(
        networkName,
        style: const TextStyle(
          fontSize: 22,
          fontWeight: FontWeight.w400,
          color: Colors.black54,
        ),
      ),
      trailing: const Icon(Icons.arrow_forward_ios),
      onTap: onTap,
    );
  }
}