Flutter插件yodo1_mas_flutter_plugin的介绍与使用详解

Flutter插件yodo1_mas_flutter_plugin的介绍与使用详解

插件简介

yodo1_mas_flutter_plugin 是一款官方支持的 Flutter 插件，用于集成最新的 Yodo1 MAS SDK。该插件支持多种广告类型，并遵循 Flutter 的最佳实践。

特性

该插件支持以下广告类型及其对应的常量：

初始化插件

要初始化插件，您需要调用 initSdk 方法并传入您的应用密钥和监听器方法。以下是初始化插件的示例代码：

// 初始化插件变量
final _yodo1MasFlutterPlugin = Yodo1MasFlutterPlugin();

// 初始化插件
@override
void initState() {
  super.initState();
  
  /**
   * 初始化 MAS SDK 参数：
   * appKey - 您的应用密钥（来自 MAS 仪表板）
   * privacy (bool) - 是否使用 MAS 隐私对话框或自定义
   * ccpa (bool) - 参见 https://developers.yodo1.com/docs/sdk/getting_started/legal/ccpa
   * coppa (bool) - 参见 https://developers.yodo1.com/docs/sdk/getting_started/legal/coppa
   * gdpr (bool) - 参见 https://developers.yodo1.com/docs/sdk/getting_started/legal/gdpr
   */
  yodo1MasFlutterPlugin.initSdk("<your appKey>", true, true, false, false);
  
  // 监听插件初始化状态
  yodo1MasFlutterPlugin.setInitListener((bool successful) {
    print('Yodo1 Flutter 初始化状态: $successful');
  });
}

加载广告

要加载广告，可以使用 loadAd 方法并传入广告类型作为参数。例如，加载一个 App Open 广告：

await yodo1MasFlutterPlugin.loadAd(Yodo1MasFlutterPlugin.adTypeAppOpen);

检查广告是否已加载

可以通过 isAdLoaded 方法检查广告是否已成功加载。例如：

bool isLoaded = await yodo1MasFlutterPlugin.isAdLoaded(Yodo1MasFlutterPlugin.adTypeAppOpen);

显示广告

要显示广告，可以使用 showAd 方法并传入广告类型作为参数。例如：

await yodo1MasFlutterPlugin.showAd(Yodo1MasFlutterPlugin.adTypeAppOpen);

添加监听器

您可以为不同的广告类型和初始化过程添加监听器。以下是不同类型的监听器示例：

• 初始化监听器：

_yodo1MasFlutterPlugin.setInitListener((bool successful) {
  print('Yodo1 Flutter 初始化成功: $successful');
});

• 插屏广告监听器：

_yodo1MasFlutterPlugin.setInterstitialListener((int code, String message) {
  print('Yodo1 Flutter 回调插屏广告: $code $message');
});

• 奖励广告监听器：

_yodo1MasFlutterPlugin.setRewardListener((int code, String message) {
  print('Yodo1 Flutter 回调奖励广告: $code $message');
});

• 应用打开广告监听器：

_yodo1MasFlutterPlugin.setAppOpenListener((int code, String message) {
  print('Yodo1 Flutter 回调应用打开广告: $code $message');
});

广告事件

广告事件通过代码表示，以下是事件名称及其对应的代码：

这些常量可以在 Yodo1MasConstants 中使用：

import 'package:yodo1_mas_flutter_plugin/constants.dart';

Banner 广告

要加载和显示 Banner 广告，可以使用以下方法：

// 加载 Banner 广告
await yodo1MasFlutterPlugin.loadAd(Yodo1MasFlutterPlugin.adTypeBanner);

// 检查 Banner 广告是否已加载
bool isBannerLoaded = await yodo1MasFlutterPlugin.isAdLoaded(Yodo1MasFlutterPlugin.adTypeBanner);

// 显示 Banner 广告
await yodo1MasFlutterPlugin.showAd(Yodo1MasFlutterPlugin.adTypeBanner);

添加 Banner 广告监听器

可以通过设置 Banner 广告监听器来监听广告事件：

_yodo1MasFlutterPlugin.setBannerListener((int code, String message) {
  if (code == Yodo1MasConstants.adEventLoaded) {
    print('Banner 广告加载成功: $message');
  } else if (code == Yodo1MasConstants.adEventFailedToLoad) {
    print('Banner 广告加载失败: $message');
  }
});

Native 广告

要加载和显示 Native 广告，可以使用以下方法：

// 加载 Native 广告
await yodo1MasFlutterPlugin.loadAd(Yodo1MasFlutterPlugin.adTypeNative);

// 检查 Native 广告是否已加载
bool isNativeLoaded = await yodo1MasFlutterPlugin.isAdLoaded(Yodo1MasFlutterPlugin.adTypeNative);

// 显示 Native 广告
await yodo1MasFlutterPlugin.showAd(Yodo1MasFlutterPlugin.adTypeNative);

添加 Native 广告监听器

可以通过设置 Native 广告监听器来监听广告事件：

_yodo1MasFlutterPlugin.setNativeListener((int code, String message) {
  if (code == Yodo1MasConstants.adEventLoaded) {
    print('Native 广告加载成功: $message');
  } else if (code == Yodo1MasConstants.adEventFailedToLoad) {
    print('Native 广告加载失败: $message');
  }
});