Flutter广告集成插件sydi_unity_ads的使用

SYDI Unity Ads 插件

SYDI Unity Ads 插件是一个用于在 Flutter 应用中集成广告功能的工具。它支持 Rewarded Ads（激励视频广告）和 Interstitial Ads（插屏广告）。本文将详细介绍如何使用该插件。

开始使用

项目初始化

本项目是一个 Flutter 插件包，包含 Android 和 iOS 平台的具体实现代码。要开始使用该插件，请确保你已经配置好 Flutter 环境，并且熟悉 Flutter 的基本开发流程。

如果你是第一次使用 Flutter，可以参考官方文档：

• Flutter 官方文档

示例代码详解

以下是一个完整的示例代码，展示了如何在 Flutter 中使用 sydi_unity_ads 插件来集成广告功能。

示例代码

// example/lib/main.dart
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:sydi_unity_ads/sydi_unity_ads.dart';

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

class UnityMediationAdsApp extends StatelessWidget {
  const UnityMediationAdsApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Unity Mediation Ads Example',
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Unity Mediation Ads Example'),
        ),
        body: const SafeArea(
          child: UnityAdsExample(),
        ),
      ),
    );
  }
}

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

  [@override](/user/override)
  _UnityAdsExampleState createState() => _UnityAdsExampleState();
}

class _UnityAdsExampleState extends State<UnityAdsExample> {
  String _platformVersion = 'Unknown';

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();

    UnityAdsBase.initialize(
      gameId: AdManager.gameId,
      onComplete: () => print('Initialization Complete ...'),
      onFailed: (error, message) =>
          print('Initialization Failed: $error $message'),
    );
  }

  // 初始化平台状态
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion =
          await SydiUnityAds.platformVersion ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return SizedBox(
      width: double.infinity,
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.center,
        mainAxisAlignment: MainAxisAlignment.spaceBetween,
        children: [
          Column(
            crossAxisAlignment: CrossAxisAlignment.center,
            children: [
              RewardedAdButton(
                placementId: AdManager.rewardedVideoAdPlacementId,
                title: 'Show Rewarded Video',
              ),
              InterstitialAdButton(
                placementId: AdManager.interstitialVideoAdPlacementId,
                title: 'Show Interstitial Video',
              ),
            ],
          ),
        ],
      ),
    );
  }
}

// 激励视频广告按钮
class RewardedAdButton extends StatefulWidget {
  const RewardedAdButton(
      {Key? key, required this.placementId, required this.title})
      : super(key: key);

  final String placementId;
  final String title;

  [@override](/user/override)
  _RewardedAdButtonState createState() => _RewardedAdButtonState();
}

class _RewardedAdButtonState extends State<RewardedAdButton> {
  bool _loaded = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    UnityRewardedAds.load(
      placementId: widget.placementId,
      onComplete: (placementId) {
        print('RewardedAd Load Complete $placementId');
        setState(() {
          _loaded = true;
        });
      },
      onFailed: (placementId, error, message) =>
          print('RewardedAd Load Failed $placementId: $error $message'),
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: _loaded
          ? () {
              UnityRewardedAds.show(
                placementId: widget.placementId,
                onRewardedShowed: (placementId) =>
                    print('Rewarded Ad $placementId was shown'),
                onRewardedFailedShow: (placementId, error, message) =>
                    print('Rewarded Ad $placementId failed: $error $message'),
                onRewardedClosed: (placementId) =>
                    print('Rewarded Ad $placementId closed'),
                onRewardedClicked: (placementId) =>
                    print('Rewarded Ad $placementId clicked'),
                onUserRewarded: (placementId) =>
                    print('Rewarded Ad $placementId user Rewarded'),
              );
            }
          : null,
      child: Text(widget.title),
    );
  }
}

// 插屏广告按钮
class InterstitialAdButton extends StatefulWidget {
  const InterstitialAdButton(
      {Key? key, required this.placementId, required this.title})
      : super(key: key);

  final String placementId;
  final String title;

  [@override](/user/override)
  _InterstitialAdButtonState createState() => _InterstitialAdButtonState();
}

class _InterstitialAdButtonState extends State<InterstitialAdButton> {
  bool _loaded = false;

  [@override](/user/override)
  void initState() {
    super.initState();

    UnityInterstitialAds.load(
      placementId: widget.placementId,
      onComplete: (placementId) {
        print('InterstitialAd Load Complete $placementId');
        setState(() {
          _loaded = true;
        });
      },
      onFailed: (placementId, error, message) =>
          print('InterstitialAd Load Failed $placementId: $error $message'),
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: _loaded
          ? () {
              UnityInterstitialAds.show(
                placementId: widget.placementId,
                onInterstitialShowed: (placementId) =>
                    print('Interstitial Ad $placementId was shown'),
                onInterstitialFailedShow: (placementId, error, message) =>
                    print('Interstitial Ad $placementId failed: $error $message'),
                onInterstitialClosed: (placementId) =>
                    print('Interstitial Ad $placementId closed'),
                onInterstitialClicked: (placementId) =>
                    print('Interstitial Ad $placementId clicked'),
              );
            }
          : null,
      child: Text(widget.title),
    );
  }
}

// 广告管理类
class AdManager {
  static String get gameId {
    if (defaultTargetPlatform == TargetPlatform.android) {
      return '4562192'; // 替换为你的 Android 游戏 ID
    }
    if (defaultTargetPlatform == TargetPlatform.iOS) {
      return 'your_ios_game_id'; // 替换为你的 iOS 游戏 ID
    }
    return '';
  }

  static String get interstitialVideoAdPlacementId {
    return 'Interstitial_Android'; // 替换为你的插屏广告放置 ID
  }

  static String get rewardedVideoAdPlacementId {
    return 'Rewarded_Android'; // 替换为你的激励视频广告放置 ID
  }
}