Flutter未知功能插件xandr的探索使用

概述

xandr 是一个用于Flutter应用中集成Xandr广告平台的插件。尽管它目前仍处于开发阶段，API可能会有所变化，但它已经提供了基本的功能来展示横幅广告和插屏广告。

主要概念

1. XandrController: 中心控制器，负责初始化SDK、加载广告并将广告事件传播到Flutter端。
2. XandrBuilder: 简化处理全局XandrController的小部件，确保所有子广告仅在SDK成功初始化后请求。
3. AdBanner: 用于显示简单广告横幅的小部件。
4. InterstitialAd: 用于请求并显示插屏广告的小部件。

示例代码

初始化Xandr SDK并显示横幅广告

import 'package:flutter/material.dart';
import 'package:xandr/xandr.dart';
import 'package:xandr/ad_banner.dart';
import 'package:xandr/ad_size.dart';

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

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

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

class _XandrExampleState extends State<XandrExample> {
  late final XandrController _controller;

  [@override](/user/override)
  void initState() {
    super.initState();
    _controller = XandrController()..init(9517);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Xandr Example'),
      ),
      body: XandrBuilder(
        controller: _controller,
        memberId: 9517,
        builder: (context, snapshot) {
          if (snapshot.hasData) {
            debugPrint('Xandr SDK initialized, success=${snapshot.hasData}');
            return AdBanner(
              controller: _controller,
              inventoryCode: 'bunte_webdesktop_home_homepage_hor_1',
              adSizes: const [AdSize(728, 90)],
              customKeywords: {'kw': ['test-kw', 'demoads']},
              onBannerFinishLoading: ({
                required success,
                height,
                width,
                nativeAd,
              }) => print('on banner finish loading: success: $success'),
            );
          } else if (snapshot.hasError) {
            return Text('Error initializing Xandr SDK');
          } else {
            return Text('Initializing Xandr SDK...');
          }
        },
      ),
    );
  }
}

加载并显示插屏广告

import 'package:flutter/material.dart';
import 'package:xandr/xandr.dart';
import 'package:xandr/interstitial_ad.dart';

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

class _InterstitialExampleState extends State<InterstitialExample> {
  late final XandrController _controller;
  late final InterstitialAd _interstitialAd;

  [@override](/user/override)
  void initState() {
    super.initState();
    _controller = XandrController()..init(9517);
    _interstitialAd = InterstitialAd(
      controller: _controller,
      inventoryCode: 'bunte_webphone_news_gallery_oop_0',
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Interstitial Ad Example'),
      ),
      body: XandrInterstitialBuilder(
        interstitialAd: _interstitialAd,
        builder: (context, snapshot) {
          if (snapshot.hasData) {
            return Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                ElevatedButton(
                  onPressed: () async {
                    final result = await _interstitialAd.show(autoDismissDelay: 10);
                    print('Interstitial ad has been closed result=$result');
                  },
                  child: Text('Show Interstitial Ad'),
                ),
              ],
            );
          } else if (snapshot.hasError) {
            return Text('Error loading Xandr interstitial ad');
          } else {
            return Text('Loading Xandr interstitial ad...');
          }
        },
      ),
    );
  }
}

多广告请求示例

import 'package:flutter/material.dart';
import 'package:xandr/xandr.dart';
import 'package:xandr/ad_banner.dart';
import 'package:xandr/ad_size.dart';
import 'package:xandr/multi_ad_request_controller.dart';

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

class _MultiAdRequestExampleState extends State<MultiAdRequestExample> {
  late final XandrController _controller;
  late final MultiAdRequestController _multiAdRequestController;

  [@override](/user/override)
  void initState() {
    super.initState();
    _controller = XandrController()..init(9517);
    _multiAdRequestController = MultiAdRequestController();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Multi Ad Request Example'),
      ),
      body: FutureBuilder<bool>(
        future: _multiAdRequestController.init(),
        builder: (_, multiAdRequestSnapshot) {
          if (multiAdRequestSnapshot.hasData) {
            return SingleChildScrollView(
              child: Column(
                children: [
                  TextButton(
                    onPressed: () {
                      _multiAdRequestController.loadAds();
                    },
                    child: Text('Load Ads'),
                  ),
                  AdBanner(
                    controller: _controller,
                    inventoryCode: 'bunte_webdesktop_home_homepage_hor_1',
                    adSizes: const [AdSize(728, 90)],
                    customKeywords: {'kw': ['test-kw', 'demoads']},
                    resizeAdToFitContainer: true,
                    multiAdRequestController: _multiAdRequestController,
                  ),
                  AdBanner(
                    controller: _controller,
                    inventoryCode: 'bunte_webdesktop_home_homepage_hor_1',
                    adSizes: const [AdSize(728, 90)],
                    customKeywords: {'kw': ['test-kw', 'demoads']},
                    resizeAdToFitContainer: true,
                    multiAdRequestController: _multiAdRequestController,
                  ),
                ],
              ),
            );
          } else if (multiAdRequestSnapshot.hasError) {
            return Text('Error initializing multi ad request');
          } else {
            return Text('Initializing multi ad request...');
          }
        },
      ),
    );
  }
}