Flutter功能扩展插件ap_flutter_kit的使用

Ap Flutter Kit 是一个用于 ApAppKit 的 Flutter 插件。它目前支持 Android 平台。它允许你在应用中集成 AdPushup 的 AdX 广告。

开始使用

本指南面向希望使用 Flutter 构建的 Android 应用通过 AdPushup AdX 广告实现盈利的开发者。将 Ap Flutter Kit 集成到你的应用中是实现 AdPushup AdX 广告的第一步。

代码更改

A: 配置

要准备你的应用，请完成以下步骤：

1. 运行此命令：

   使用 Flutter：

   flutter pub add ap_flutter_kit
   

   这将在你的包的 pubspec.yaml 文件中添加一行（并运行隐式的 flutter pub get）：

   dependencies:
     ap_flutter_kit: ^0.3.0
   

   另外，你的编辑器可能支持 flutter pub get。查看你的编辑器文档以了解更多信息。

2. 导入库：

   现在可以在 Dart 代码中使用：

   import 'package:ap_flutter_kit/ap_flutter_kit.dart';
   

B: 使用

你必须在广告的 onAdImpression() 回调中调用 ApFlutterKit.ping() 方法。

示例：

onAdImpression: (Ad ad) {
  ApFlutterKit.ping(context, ad.adUnitId, ad.responseInfo?.responseId);
}

完整示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 应用中集成和使用 Ap Flutter Kit：

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

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:ap_flutter_kit/ap_flutter_kit.dart';

void main() {
  // 初始化 Google 广告 SDK。
  WidgetsFlutterBinding.ensureInitialized();
  MobileAds.instance.initialize();

  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> {
  // AdRequest. 你可以添加任何额外参数。
  static const AdRequest request = AdManagerAdRequest();

  // 存储加载的插屏广告对象。
  InterstitialAd? _interstitialAd;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 在应用状态初始化时加载广告。
    _loadAd();
  }

  // 函数用于加载新的插屏广告（如果尚未加载）。
  void _loadAd() {
    if (_interstitialAd == null) {
      Fluttertoast.showToast(msg: "正在加载广告...");
      InterstitialAd.load(
          adUnitId: '/6499/example/interstitial',
          request: request,
          adLoadCallback: InterstitialAdLoadCallback(
            onAdLoaded: (InterstitialAd ad) {
              _interstitialAd = ad;
              _interstitialAd!.setImmersiveMode(true);
              Fluttertoast.showToast(msg: "广告已加载");
            },
            onAdFailedToLoad: (LoadAdError error) {
              _interstitialAd = null;
            },
          ));
    } else {
      Fluttertoast.showToast(msg: "广告已加载");
    }
  }

  // 函数用于显示已加载的插屏广告。
  void _showAd() {
    if (_interstitialAd == null) {
      Fluttertoast.showToast(msg: "广告尚未加载");
      return;
    }
    _interstitialAd!.fullScreenContentCallback = FullScreenContentCallback(
        onAdDismissedFullScreenContent: (InterstitialAd ad) {
      ad.dispose();
    }, onAdFailedToShowFullScreenContent: (InterstitialAd ad, AdError error) {
      ad.dispose();
    }, onAdImpression: (Ad ad) {
      // 通过向 Ap Flutter Kit 发送 ping 请求来通知新的广告印象。
      // 我们需要传递上下文、广告单元 ID 和广告响应 ID。
      ApFlutterKit.ping(context, ad.adUnitId, ad.responseInfo?.responseId);
    });
    _interstitialAd!.show();
    _interstitialAd = null;
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('ApAppKit 示例'),
        ),
        body: Center(
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.stretch,
            mainAxisSize: MainAxisSize.min,
            children: [
              // 按钮用于加载新的插屏广告。
              TextButton(
                  onPressed: () {
                    _loadAd();
                  },
                  child: const Text('加载广告')),
              // 按钮用于显示已加载的插屏广告。
              TextButton(
                  onPressed: () {
                    _showAd();
                  },
                  child: const Text('显示广告')),
            ],
          ),
        ),
      ),
    );
  }
}