flet_ads 是一个用于在 Flutter 应用中集成广告的插件。它支持多种广告格式，包括横幅广告、插页式广告、奖励广告等。以下是如何在 Flutter 项目中使用 flet_ads 插件的基本步骤。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 flet_ads 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  flet_ads: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 初始化广告插件

在你的 main.dart 文件中，初始化 flet_ads 插件。通常，你需要在 main 函数中进行初始化：

import 'package:flet_ads/flet_ads.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化广告插件
  await FletAds.initialize(
    appId: 'YOUR_APP_ID',  // 替换为你的应用ID
    testMode: true,        // 测试模式，发布时设置为 false
  );
  
  runApp(MyApp());
}

3. 显示横幅广告

要在应用中显示横幅广告，你可以使用 BannerAdWidget：

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

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Ads Example'),
      ),
      body: Column(
        children: [
          Expanded(
            child: Center(
              child: Text('Hello, World!'),
            ),
          ),
          BannerAdWidget(adUnitId: 'YOUR_BANNER_AD_UNIT_ID'),  // 替换为你的横幅广告单元ID
        ],
      ),
    );
  }
}

4. 显示插页式广告

要显示插页式广告，你可以使用 InterstitialAd：

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

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

class _MyHomePageState extends State<MyHomePage> {
  InterstitialAd _interstitialAd;

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

  void _loadInterstitialAd() {
    _interstitialAd = InterstitialAd(
      adUnitId: 'YOUR_INTERSTITIAL_AD_UNIT_ID',  // 替换为你的插页式广告单元ID
      listener: (AdEvent event) {
        if (event == AdEvent.closed) {
          // 广告关闭后重新加载
          _loadInterstitialAd();
        }
      },
    );
    _interstitialAd.load();
  }

  void _showInterstitialAd() {
    if (_interstitialAd.isLoaded) {
      _interstitialAd.show();
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Ads Example'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: _showInterstitialAd,
          child: Text('Show Interstitial Ad'),
        ),
      ),
    );
  }
}

5. 显示奖励广告

要显示奖励广告，你可以使用 RewardedAd：

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

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

class _MyHomePageState extends State<MyHomePage> {
  RewardedAd _rewardedAd;

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

  void _loadRewardedAd() {
    _rewardedAd = RewardedAd(
      adUnitId: 'YOUR_REWARDED_AD_UNIT_ID',  // 替换为你的奖励广告单元ID
      listener: (AdEvent event, {RewardItem reward}) {
        if (event == AdEvent.closed) {
          // 广告关闭后重新加载
          _loadRewardedAd();
        } else if (event == AdEvent.rewarded) {
          // 用户获得奖励
          print('Reward: ${reward.amount} ${reward.type}');
        }
      },
    );
    _rewardedAd.load();
  }

  void _showRewardedAd() {
    if (_rewardedAd.isLoaded) {
      _rewardedAd.show();
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Ads Example'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: _showRewardedAd,
          child: Text('Show Rewarded Ad'),
        ),
      ),
    );
  }
}

6. 测试广告

在开发过程中，建议使用测试广告单元 ID 来避免产生无效的广告点击。flet_ads 提供了测试广告单元 ID：

BannerAdWidget(adUnitId: BannerAd.testAdUnitId),
InterstitialAd(adUnitId: InterstitialAd.testAdUnitId),
RewardedAd(adUnitId: RewardedAd.testAdUnitId),

7. 发布应用

在发布应用之前，请确保将 testMode 设置为 false，并使用你从广告平台获取的真实广告单元 ID。

8. 处理广告生命周期

确保在你的应用生命周期中正确处理广告的加载和销毁，以避免内存泄漏和其他问题。例如，在 dispose 方法中销毁广告：

[@override](/user/override)
void dispose() {
  _interstitialAd?.dispose();
  _rewardedAd?.dispose();
  super.dispose();
}