flutter_pangle_global_ads 是一个用于在 Flutter 应用中集成 Pangle（穿山甲）全球广告的插件。Pangle 是字节跳动旗下的广告平台，支持全球范围内的广告展示。通过 flutter_pangle_global_ads，你可以在 Flutter 应用中轻松集成横幅广告、插屏广告、激励视频广告等。

以下是 flutter_pangle_global_ads 的基本使用步骤：

1. 安装插件

在 pubspec.yaml 文件中添加依赖：

dependencies:
  flutter_pangle_global_ads: ^版本号 # 请替换为最新版本

运行 flutter pub get 安装插件。

2. 初始化 Pangle SDK

在应用启动时初始化 Pangle SDK。通常可以在 main.dart 中进行初始化操作。

import 'package:flutter_pangle_global_ads/flutter_pangle_global_ads.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 Pangle SDK
  await FlutterPangleGlobalAds.init(
    appId: 'Your_App_ID', // 替换为你的 Pangle App ID
  );
  
  runApp(MyApp());
}

3. 使用广告类型

flutter_pangle_global_ads 支持多种广告类型。以下是常见广告的使用示例：

3.1 横幅广告

import 'package:flutter_pangle_global_ads/flutter_pangle_global_ads.dart';

class BannerAdExample extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Banner Ad')),
      body: Column(
        children: [
          Expanded(
            child: Container(),
          ),
          // 加载横幅广告
          PangleBannerAdWidget(
            adUnitId: 'Your_Banner_Ad_Unit_ID', // 替换为你的横幅广告位 ID
            adSize: AdSize.banner, // 广告尺寸
          ),
        ],
      ),
    );
  }
}

3.2 插屏广告

import 'package:flutter_pangle_global_ads/flutter_pangle_global_ads.dart';

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

class _InterstitialAdExampleState extends State<InterstitialAdExample> {
  PangleInterstitialAd? _interstitialAd;

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

  void _loadInterstitialAd() {
    PangleInterstitialAd.load(
      adUnitId: 'Your_Interstitial_Ad_Unit_ID', // 替换为你的插屏广告位 ID
      onAdLoaded: (ad) {
        setState(() {
          _interstitialAd = ad;
        });
      },
      onAdFailedToLoad: (error) {
        print('Interstitial ad failed to load: $error');
      },
    );
  }

  void _showInterstitialAd() {
    if (_interstitialAd != null) {
      _interstitialAd!.show();
    } else {
      print('Interstitial ad not ready.');
    }
  }

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

3.3 激励视频广告

import 'package:flutter_pangle_global_ads/flutter_pangle_global_ads.dart';

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

class _RewardedAdExampleState extends State<RewardedAdExample> {
  PangleRewardedAd? _rewardedAd;

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

  void _loadRewardedAd() {
    PangleRewardedAd.load(
      adUnitId: 'Your_Rewarded_Ad_Unit_ID', // 替换为你的激励视频广告位 ID
      onAdLoaded: (ad) {
        setState(() {
          _rewardedAd = ad;
        });
      },
      onAdFailedToLoad: (error) {
        print('Rewarded ad failed to load: $error');
      },
    );
  }

  void _showRewardedAd() {
    if (_rewardedAd != null) {
      _rewardedAd!.show(
        onRewarded: (reward) {
          print('User earned reward: ${reward.amount} ${reward.type}');
        },
      );
    } else {
      print('Rewarded ad not ready.');
    }
  }

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

4. 处理广告生命周期

确保在页面销毁时释放广告资源，例如在 dispose 方法中调用销毁方法。

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