Flutter广告集成插件mint_admobkit的使用

Flutter广告集成插件mint_admobkit的使用

mint_admobkit 是一套用于集成 AdMob 广告的工具，适用于 MintMinter 应用。

功能包括：

• AdBanner: 显示横幅广告。
• SimpleAdBanner: 简单显示横幅广告。
• AdIdProvider: 提供不同类型的广告ID。
• AdType: 定义广告类型。
• AttView: 在iOS上显示ATT请求。

使用

在Android上集成AdMob

1. 更新AndroidManifest.xml

   • 在 <application> 前添加权限：

     <uses-permission android:name="android.permission.INTERNET"/>
     <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
     

   • 在 </application> 前添加元数据：

     <!-- 示例AdMob应用ID: ca-app-pub-3940256099942544~3347511713 -->
     <meta-data
         android:name="com.google.android.gms.ads.APPLICATION_ID"
         android:value="ca-app-pub-3940256099942544~3347511713"/>
     
     <!-- 延迟应用程序测量直到调用MobileAds.initialize()。参见https://developers.google.com/admob/flutter/eu-consent#delay_app_measurement_optional -->
     <meta-data
         android:name="com.google.android.gms.ads.DELAY_APP_MEASUREMENT_INIT"
         android:value="true"/>
     

2. 添加广告提供商

   import 'package:mintminter_mint/ad/ad.dart';
   
   sealed class ExampleAdType extends AdType {
     const ExampleAdType({required this.unitId});
   
     final String unitId;
   
     [@override](/user/override)
     List<Object?> get props => [
       unitId,
     ];
   }
   
   class ExampleTopBannerAndroid extends ExampleAdType {
     const ExampleTopBannerAndroid({
       required super.unitId,
     });
   
     [@override](/user/override)
     List<Object?> get props => [super.unitId];
   }
   
   class ExampleAdProvider extends AdIdProvider {
     ExampleAdProvider._internal();
   
     static ExampleAdProvider? _instance;
   
     /// 获取ExampleAdProvider实例
     factory ExampleAdProvider.getInstance() {
       _instance ??= ExampleAdProvider._internal();
   
       return _instance!;
     }
   
     /// 释放ExampleAdProvider实例
     static dispose() {
       _instance = null;
     }
   
     [@override](/user/override)
     String getAndroidAdUnitId(AdType adType) {
       if (adType is ExampleAdType) {
         return adType.unitId;
       } else {
         return '';
       }
     }
   
     [@override](/user/override)
     String getIOSAdUnitId(AdType adType) {
       return '';
     }
   }
   

3. 在主程序中初始化广告提供商

   void main() {
     WidgetsFlutterBinding.ensureInitialized();
     ExampleAdProvider.getInstance().initializeMobileAdsOnMobile();
   
     runApp(const App());
   }
   

4. 使用AdBanner

   AdBanner(
     padding: const EdgeInsets.symmetric(vertical: 50),
     type: const ExampleTopBannerAndroid(unitId: AdIdProvider.mockAdId), 
     adIdProvider: ExampleAdProvider.getInstance(),
   )
   

完整示例Demo

以下是一个完整的示例，展示了如何在Flutter应用中使用mint_admobkit。

import 'dart:async';
import 'dart:io';

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:mint_admobkit/mint_admobkit.dart';

import 'example_ad_provider.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  unawaited(ExampleAdProvider.getInstance().initializeMobileAdsOnMobile(
    requireEuConsent: !kIsWeb && Platform.isAndroid,
  ));

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Mint AdMobKit Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepOrange),
        useMaterial3: true,
      ),
      home: const HomePage(),
    );
  }
}

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: const Text('Mint AdMobKit Demo'),
      ),
      body: ListView(
        children: [
          AdBanner(
            padding: const EdgeInsets.symmetric(vertical: 50),
            type: const ExampleTopBannerAndroid(unitId: AdIdProvider.mockAdId),
            adIdProvider: ExampleAdProvider.getInstance(),
          ),
          if (kDebugMode) ...[
            InkWell(
              child: Container(
                color: Theme.of(context).colorScheme.primaryContainer,
                padding: const EdgeInsets.all(20),
                child: Text(
                  'Reset Consent Information',
                  style: TextStyle(
                    color: Theme.of(context).colorScheme.onPrimaryContainer,
                  ),
                ),
              ),
              onTap: () {
                ExampleAdProvider.getInstance().resetConsentInformation();
              },
            )
          ],
          const SizedBox(
            height: 20,
          ),
          Container(
            color: Theme.of(context).colorScheme.primaryContainer,
            padding: const EdgeInsets.all(20),
            child: Text(
              'Other content',
              style: TextStyle(
                color: Theme.of(context).colorScheme.onPrimaryContainer,
              ),
            ),
          )
        ],
      ),
    );
  }
}