yandex_mobileads_v2 是一个用于在 Flutter 应用中集成 Yandex 广告的插件。通过这个插件，你可以轻松地在 Flutter 应用中展示横幅广告、插页式广告、激励视频广告等。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 yandex_mobileads_v2 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  yandex_mobileads_v2: ^1.0.0  # 请检查最新版本

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

2. 初始化 Yandex Mobile Ads SDK

在你的应用启动时，需要初始化 Yandex Mobile Ads SDK。通常，你可以在 main.dart 文件中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await YandexMobileAds.initialize();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

3. 展示横幅广告

要在应用中展示横幅广告，可以使用 BannerAd 类。以下是一个简单的示例：

import 'package:flutter/material.dart';
import 'package:yandex_mobileads_v2/yandex_mobileads_v2.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();
    _loadBannerAd();
  }

  void _loadBannerAd() {
    _bannerAd = BannerAd(
      adUnitId: 'your_banner_ad_unit_id', // 替换为你的广告单元ID
      size: AdSize.banner,
      onAdLoaded: () {
        print('Banner Ad loaded');
      },
      onAdFailedToLoad: (error) {
        print('Banner Ad failed to load: $error');
      },
    );
    _bannerAd?.load();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Yandex Ads'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Banner Ad Example'),
            if (_bannerAd != null)
              Container(
                alignment: Alignment.center,
                child: AdWidget(ad: _bannerAd!),
                width: _bannerAd!.size.width.toDouble(),
                height: _bannerAd!.size.height.toDouble(),
              ),
          ],
        ),
      ),
    );
  }

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

4. 展示插页式广告

插页式广告通常在全屏展示。你可以使用 InterstitialAd 类来加载和展示插页式广告：

import 'package:flutter/material.dart';
import 'package:yandex_mobileads_v2/yandex_mobileads_v2.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
      onAdLoaded: () {
        print('Interstitial Ad loaded');
      },
      onAdFailedToLoad: (error) {
        print('Interstitial Ad failed to load: $error');
      },
      onAdDismissed: () {
        print('Interstitial Ad dismissed');
        _loadInterstitialAd(); // 重新加载广告
      },
    );
    _interstitialAd?.load();
  }

  void _showInterstitialAd() {
    if (_interstitialAd != null && _interstitialAd!.isLoaded) {
      _interstitialAd?.show();
    } else {
      print('Interstitial Ad is not ready yet.');
    }
  }

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

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

5. 展示激励视频广告

激励视频广告通常用于奖励用户。你可以使用 RewardedAd 类来加载和展示激励视频广告：

import 'package:flutter/material.dart';
import 'package:yandex_mobileads_v2/yandex_mobileads_v2.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
      onAdLoaded: () {
        print('Rewarded Ad loaded');
      },
      onAdFailedToLoad: (error) {
        print('Rewarded Ad failed to load: $error');
      },
      onRewarded: (reward) {
        print('User earned reward: $reward');
      },
      onAdDismissed: () {
        print('Rewarded Ad dismissed');
        _loadRewardedAd(); // 重新加载广告
      },
    );
    _rewardedAd?.load();
  }

  void _showRewardedAd() {
    if (_rewardedAd != null && _rewardedAd!.isLoaded) {
      _rewardedAd?.show();
    } else {
      print('Rewarded Ad is not ready yet.');
    }
  }

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

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

6. 处理广告生命周期

确保在页面销毁时释放广告资源，以避免内存泄漏。在 dispose 方法中调用 dispose 方法：

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