Flutter弹窗广告插件flutter_app_popup_ad的使用

Flutter弹窗广告插件flutter_app_popup_ad的使用

Flutter_App_Popup_Ad 是一个为开发者设计的 Flutter 插件，用于以对话框/弹窗的形式推广自己的应用（或其他应用）。

安装

在你的 Flutter 项目的终端中运行以下命令：

flutter pub add flutter_app_popup_ad

在你的库中添加以下导入：

import 'package:flutter_app_popup_ad/flutter_app_popup_ad.dart';

使用

此插件需要一个你想要推广的应用列表。你需要用一个 <AppInfo> 列表或一个公共 URL 初始化该插件，该插件可以从 URL 中获取列表。以下是代码示例：

[@override](/user/override)
void initState(){
  super.initState();
  WidgetsBinding.instance?.addPostFrameCallback((_) async {
    // 如果主机应用也在要推广的应用列表中，则设置此选项，防止它自我推广
    final flutterAppPopupAd = FlutterAppPopupAd();
    flutterAppPopupAd.thisAppId = "om.Raziel619";
    
    await flutterAppPopupAd.initializeWithUrl('https://dev.raziel619.com/ariel/api/getpreviews', updateFreqDays: 1);
    // 或者你可以使用 flutterAppPopupAd.initializeWithApps(apps)
    
    await flutterAppPopupAd.determineAndShowAd(context, freq: 0);
  });
}

• updateFreqDays - 设置从 URL 获取应用列表的时间间隔。
• freq - 设置展示下一条广告之前应用必须被打开的次数。如果设置为 0，则每次调用 determineAndShowAd 方法时都会展示广告。

建议的方法是在 main.dart 返回 MaterialApp 后调用该插件，以便 Flutter 的 showDialog 方法可以正常工作。

限制

目前，该插件仅在 Android 上完全支持。对于 iOS，你可以传递一个指向应用在苹果应用商店页面的 URL，该插件将引导用户到那里。

示例代码

以下是一个完整的示例代码，展示了如何使用 flutter_app_popup_ad 插件：

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

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {

  // 这个小部件是你的应用的根组件。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;
  var flutterAppPopupAd = FlutterAppPopupAd();

  [@override](/user/override)
  void initState(){
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((_) async {
      // 如果主机应用也在要推广的应用列表中，则设置此选项，防止它自我推广
      flutterAppPopupAd.thisAppId = "om.Raziel619";

      await flutterAppPopupAd.initializeWithUrl('https://dev.raziel619.com/ariel/api/getpreviews', updateFreqDays: 1);
      // 或者你可以使用 flutterAppPopupAd.initializeWithApps(apps)

      await flutterAppPopupAd.determineAndShowAd(context, freq: 3);
    });
  }

  void _incrementCounter() {
    setState(() {
      _counter++;
      flutterAppPopupAd.determineAndShowAd(context, freq: 3);
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}