Flutter广告展示插件cs_okspin_ad的使用

A new Flutter plugin project.

使用步骤

1. 添加依赖

在 pubspec.yaml 文件中添加 cs_okspin_ad 插件依赖：

dependencies:
  cs_okspin_ad: ^版本号

运行以下命令以获取依赖：

flutter pub get

2. 初始化插件

在 main.dart 文件中初始化插件并设置监听器。

import 'dart:developer';

import 'package:cs_okspin_ad/cs_okspin_ad_listener.dart';
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:cs_okspin_ad/cs_okspin_ad.dart';
import 'package:flutter/services.dart';

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

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with CsOkSpinAdListener {
  final _csOkspinAdPlugin = CsOkspinAd();

  var showIconView = false;

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 初始化插件
  Future<void> initPlatformState() async {
    try {
      // 设置监听器
      await _csOkspinAdPlugin.setOkSpinAdListener(this);
      // 开启调试模式
      await _csOkspinAdPlugin.setDebug(true);
      // 初始化插件，传入您的广告位ID
      await _csOkspinAdPlugin.initialize("xxxxxxx");

      if (!mounted) return;

      setState(() {});
    } catch (e) {
      debugPrint("初始化失败: $e");
    }
  }

  /// 初始化成功回调
  @override
  void onInitSuccess() {
    debugPrint("cs_okspin onInitSuccess");
  }

  /// 初始化失败回调
  @override
  void onInitFailed(int errCode, String errMsg) {
    debugPrint("cs_okspin onInitFailed - code:$errCode; msg:$errMsg");
  }

  /// 广告位加载成功回调
  @override
  void onIconReady(String placement) {
    debugPrint("cs_okspin onIconReady - placement:$placement");
    showIconView = true;
    setState(() {});
  }

  /// 广告位加载失败回调
  @override
  void onIconLoadFailed(String placement, int errCode, String errMsg) {
    debugPrint("cs_okspin onIconLoadFailed - placement:$placement; code:$errCode; msg:$errMsg");
  }

  /// 广告展示失败回调
  @override
  void onIconShowFailed(String placementId, int errCode, String errMsg) {
    debugPrint("cs_okspin onIconShowFailed - placement:$placementId; code:$errCode; msg:$errMsg");
  }

  /// 广告被点击回调
  @override
  void onIconClick(String placement) {
    debugPrint("cs_okspin onIconClick - placement:$placement");
  }

  /// 互动广告页面打开回调
  @override
  void onInteractiveOpen(String placement) {
    debugPrint("cs_okspin onInteractiveOpen - placement:$placement");
  }

  /// 互动广告页面打开失败回调
  @override
  void onInteractiveOpenFailed(String placementId, int errCode, String errMsg) {
    debugPrint("cs_okspin onInteractiveOpenFailed - placement:$placementId; code:$errCode; msg:$errMsg");
  }

  /// 互动广告页面关闭回调
  @override
  void onInteractiveClose(String placement) {
    debugPrint("cs_okspin onInteractiveClose - placement:$placement");
  }

  /// 互动墙页面打开回调
  @override
  void onOfferWallOpen(String placementId) {
    debugPrint("cs_okspin onOfferWallOpen - placement:$placementId");
  }

  /// 互动墙页面打开失败回调
  @override
  void onOfferWallOpenFailed(String placementId, int errCode, String errMsg) {
    debugPrint("cs_okspin onOfferWallOpenFailed - placement:$placementId; code:$errCode; msg:$errMsg");
  }

  /// 互动墙页面关闭回调
  @override
  void onOfferWallClose(String placementId) {
    debugPrint("cs_okspin onOfferWallClose - placement:$placementId");
  }

  /// GSpace页面打开回调
  @override
  void onGSpaceOpen(String placementId) {
    debugPrint("cs_okspin onGSpaceOpen - placement:$placementId");
  }

  /// GSpace页面打开失败回调
  @override
  void onGSpaceOpenFailed(String placementId, int errCode, String errMsg) {
    debugPrint("cs_okspin onGSpaceOpenFailed - placement:$placementId; code:$errCode; msg:$errMsg");
  }

  /// GSpace页面关闭回调
  @override
  void onGSpaceClose(String placementId) {
    debugPrint("cs_okspin onGSpaceClose - placement:$placementId");
  }

  /// 用户交互行为回调
  @override
  void onUserInteraction(String placementId, String interaction) {
    debugPrint("cs_okspin onUserInteraction - placement:$placementId; interaction:$interaction");
  }

  @override
  Widget build(BuildContext context) {
    final children = <Widget>[
      Positioned(
        child: TextButton(
          onPressed: () {
            log("点击加载 icon");
            _csOkspinAdPlugin.loadIcon("9214");
          },
          child: const Text("加载Icon", style: TextStyle(color: Colors.black, fontSize: 20)),
        ),
      )
    ];

    if (showIconView) {
      log("加载 okspin icon");
      children.add(
        const Positioned(
          bottom: 20,
          width: 300,
          height: 120,
          child: AndroidView(
            viewType: "com.cangshengnian.cs_okspin_ad/customAd",
            creationParams: <String, dynamic>{
              "placementId": "9214",
              "width": 300,
              "height": 120
            },
            creationParamsCodec: StandardMessageCodec(),
          ),
        ),
      );
    }

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Container(
          width: 300,
          height: 400,
          color: Colors.pink,
          child: Stack(
            alignment: Alignment.center,
            children: children,
          ),
        ),
      ),
    );
  }
}

3. 运行示例

将上述代码保存到 lib/main.dart 文件中，并运行应用：

flutter run