Flutter广告集成插件cs_adfly_ad的使用

cs_adfly_ad 是一个用于在 Flutter 应用中集成广告的插件。它可以帮助开发者在应用中轻松地展示广告，并通过广告收入来盈利。以下是如何在 Flutter 项目中使用 cs_adfly_ad 插件的基本步骤：

1. 添加依赖

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

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

然后运行 flutter pub get 来安装依赖。

2. 初始化广告插件

在你的 Flutter 应用启动时，需要先初始化广告插件。通常可以在 main.dart 文件中进行初始化。

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化广告插件
  await CsAdflyAd.initialize(
    appId: 'your_app_id',  // 替换为你的应用ID
    isDebug: true,         // 调试模式，发布时设置为 false
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Ads Demo',
      home: MyHomePage(),
    );
  }
}

3. 展示横幅广告

你可以在应用的任何页面中展示横幅广告。以下是一个简单的示例：

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

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Ads Demo'),
      ),
      body: Column(
        children: [
          Expanded(
            child: Center(
              child: Text('Hello, World!'),
            ),
          ),
          // 展示横幅广告
          CsAdflyBannerAd(
            adUnitId: 'your_banner_ad_unit_id',  // 替换为你的横幅广告单元ID
            adSize: AdSize.banner,
          ),
        ],
      ),
    );
  }
}

4. 展示插屏广告

插屏广告通常在全屏模式下展示，可以在用户执行某些操作后触发。以下是一个简单的示例：

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

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Ads Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            // 展示插屏广告
            await CsAdflyInterstitialAd.load(
              adUnitId: 'your_interstitial_ad_unit_id',  // 替换为你的插屏广告单元ID
            );
            CsAdflyInterstitialAd.show();
          },
          child: Text('Show Interstitial Ad'),
        ),
      ),
    );
  }
}

5. 展示激励视频广告

激励视频广告通常用于奖励用户观看广告后获得某些奖励。以下是一个简单的示例：

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

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Ads Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            // 展示激励视频广告
            await CsAdflyRewardedAd.load(
              adUnitId: 'your_rewarded_ad_unit_id',  // 替换为你的激励视频广告单元ID
            );
            CsAdflyRewardedAd.show(
              onUserEarnedReward: (RewardItem reward) {
                // 用户获得奖励后的回调
                print('User earned reward: ${reward.amount} ${reward.type}');
              },
            );
          },
          child: Text('Show Rewarded Ad'),
        ),
      ),
    );
  }
}

6. 处理广告生命周期事件

你可以监听广告的生命周期事件，例如广告加载成功、加载失败、展示、关闭等。以下是一个示例：

CsAdflyBannerAd(
  adUnitId: 'your_banner_ad_unit_id',
  adSize: AdSize.banner,
  listener: CsAdflyBannerAdListener(
    onAdLoaded: (Ad ad) {
      print('Ad loaded.');
    },
    onAdFailedToLoad: (Ad ad, LoadAdError error) {
      print('Ad failed to load: $error');
    },
    onAdOpened: (Ad ad) {
      print('Ad opened.');
    },
    onAdClosed: (Ad ad) {
      print('Ad closed.');
    },
  ),
);