Flutter广告集成插件bit_ads_package的使用

在本教程中，我们将介绍如何使用bit_ads_package插件来集成UnityAds和Admob广告到您的Flutter应用程序中。该插件允许您轻松加载和展示插屏广告（Interstitial Ads）、奖励视频广告（Rewarded Ads）以及横幅广告（Banner Ads）。以下是完整的步骤和代码示例。

Getting Started

初始化插件

在main()函数中初始化插件：

void main() {
  // 初始化 UnityAds 和 Google Ads 插件
  Unityads.initUnit(); // 初始化 UnityAds
  Googleads.init(); // 初始化 Google Ads
  runApp(MyApp());
}

UnityAds 使用

加载插屏广告

加载UnityAds插屏广告：

Unityads.unityIntraLoad();

展示插屏广告

展示插屏广告时，您可以监听广告的生命周期事件：

UnityAds.showVideoAd(
  placementId: 'PLACEMENT_ID', // 替换为您的广告位ID
  onStart: (placementId) => print('Video Ad $placementId started'), // 广告开始播放
  onClick: (placementId) => print('Video Ad $placementId click'), // 用户点击广告
  onSkipped: (placementId) => print('Video Ad $placementId skipped'), // 用户跳过广告
  onComplete: (placementId) => print('Video Ad $placementId completed'), // 广告播放完成
  onFailed: (placementId, error, message) =>
      print('Video Ad $placementId failed: $error $message'), // 广告加载失败
);

显示横幅广告

在布局中添加横幅广告：

// 在布局中调用 unityBannerShow 方法
Unityads.unityBannerShow;

Admob Ads 使用

添加 Admob 应用 ID

在Android项目的AndroidManifest.xml文件中添加以下内容：

<manifest>
  <application>
    <meta-data
      android:name="com.google.android.gms.ads.APPLICATION_ID"
      android:value="ca-app-pub-3940256099942544~3347511713"/>
  </application>
</manifest>

加载和展示横幅广告

展示Admob横幅广告：

Googleads.bannerAdsShow();

加载插屏广告和奖励视频广告

加载插屏广告和奖励视频广告：

Googleads.loadReward(); // 加载奖励视频广告
Googleads.loadIntra(); // 加载插屏广告

展示插屏广告

展示插屏广告前检查是否已加载：

final isLoaded = await interstitialAd.isLoaded();
if (isLoaded ?? false) {
  interstitialAd.show();
} else {
  showSnackBar('Interstitial ad is still loading...');
}

展示奖励视频广告

展示奖励视频广告前检查是否已加载：

if (await rewardAd.isLoaded()) {
  rewardAd.show();
} else {
  showSnackBar('Reward ad is still loading...');
}

完整示例代码

以下是一个完整的示例代码，展示了如何集成UnityAds和Admob广告：

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

void main() {
  // 初始化插件
  Unityads.initUnit();
  Googleads.init();

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

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

class _HomePageState extends State<HomePage> {
  bool _bannerVisible = false;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Bit Ads Package Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () {
                // 展示UnityAds插屏广告
                UnityAds.showVideoAd(
                  placementId: 'PLACEMENT_ID',
                  onStart: (placementId) => print('Video Ad $placementId started'),
                  onClick: (placementId) => print('Video Ad $placementId click'),
                  onSkipped: (placementId) => print('Video Ad $placementId skipped'),
                  onComplete: (placementId) => print('Video Ad $placementId completed'),
                  onFailed: (placementId, error, message) =>
                      print('Video Ad $placementId failed: $error $message'),
                );
              },
              child: Text('Show UnityAds Interstitial'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () async {
                // 展示Admob插屏广告
                final isLoaded = await interstitialAd.isLoaded();
                if (isLoaded ?? false) {
                  interstitialAd.show();
                } else {
                  ScaffoldMessenger.of(context).showSnackBar(
                    SnackBar(content: Text('Interstitial ad is still loading...')),
                  );
                }
              },
              child: Text('Show Admob Interstitial'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                // 切换横幅广告的可见性
                setState(() {
                  _bannerVisible = !_bannerVisible;
                });
              },
              child: Text(_bannerVisible ? 'Hide Banner' : 'Show Banner'),
            ),
            if (_bannerVisible) Unityads.unityBannerShow,
          ],
        ),
      ),
    );
  }
}