Flutter广告集成插件ad_base的使用

本文档描述了如何使用 ad_base 插件。如果你将此插件发布到 pub.dev，此文档的内容将会出现在插件的首页。

Features

• 支持多种广告形式（如 Banner 广告、Interstitial 广告等）。
• 提供统一的 API 接口，方便开发者快速集成广告功能。
• 兼容多个广告平台（如 AdMob、Facebook Audience Network 等）。

Getting started

在使用 ad_base 插件之前，你需要确保已经配置好相关的广告平台账号，并在项目的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  ad_base: ^1.0.0

然后运行 flutter pub get 命令以安装依赖。

Usage

初始化插件

在使用广告功能之前，需要先初始化插件。通常在应用启动时调用初始化方法。

import 'package:ad_base/ad_base.dart';

void main() {
  // 初始化广告插件
  AdBase.initialize();
  runApp(MyApp());
}

添加 Banner 广告

Banner 广告是一种常用于页面底部的广告形式。

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

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  BannerAd? _bannerAd;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 创建 Banner 广告实例
    _bannerAd = BannerAd(
      adUnitId: 'your_banner_ad_unit_id', // 替换为你的 Banner 广告单元 ID
      size: AdSize.BANNER,
      listener: (event) {
        if (event == AdEvent.loaded) {
          print('Banner 广告加载成功');
        } else if (event == AdEvent.failedToLoad) {
          print('Banner 广告加载失败');
        }
      },
    );
    // 加载 Banner 广告
    _bannerAd?.load();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Banner 广告示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // 显示 Banner 广告
            Container(
              width: _bannerAd?.size.width.toDouble(),
              height: _bannerAd?.size.height.toDouble(),
              child: _bannerAd?.view,
            ),
          ],
        ),
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    // 销毁 Banner 广告实例
    _bannerAd?.dispose();
    super.dispose();
  }
}

添加 Interstitial 广告

Interstitial 广告是一种全屏广告形式，通常在用户完成某个操作后展示。

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

class MyInterstitialPage extends StatelessWidget {
  InterstitialAd? _interstitialAd;

  MyInterstitialPage() {
    // 创建 Interstitial 广告实例
    _interstitialAd = InterstitialAd(
      adUnitId: 'your_interstitial_ad_unit_id', // 替换为你的 Interstitial 广告单元 ID
      listener: (event) {
        if (event == AdEvent.loaded) {
          print('Interstitial 广告加载成功');
        } else if (event == AdEvent.closed) {
          print('Interstitial 广告关闭');
        }
      },
    );
    // 加载 Interstitial 广告
    _interstitialAd?.load();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Interstitial 广告示例'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 展示 Interstitial 广告
            _interstitialAd?.show();
          },
          child: Text('展示 Interstitial 广告'),
        ),
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    // 销毁 Interstitial 广告实例
    _interstitialAd?.dispose();
    super.dispose();
  }
}