Skip to content

Latest commit

 

History

History
301 lines (282 loc) · 11.6 KB

README.md

File metadata and controls

301 lines (282 loc) · 11.6 KB
Raw

字节跳动穿山甲广告 Flutter版本

image

简介

flutter_unioad是一款集成了穿山甲Android和iOSSDK的Flutter插件,方便直接调用穿山甲SDK方法开发，0.1.1开始已支持null safety

官方文档

本地环境

[✓] Flutter (Channel stable, 2.0.6, on macOS 11.2.3 20D91 darwin-x64, locale zh-Hans-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 30.0.2)
[✓] Xcode - develop for iOS and macOS
[✓] Chrome - develop for the web
[✓] Android Studio (version 4.1)
[✓] VS Code (version 1.55.2)
[✓] Connected device (3 available)

集成步骤

1、pubspec.yaml

flutter_unionad: ^0.1.2

引入

import 'package:flutter_unionad/flutter_unionad.dart' as FlutterUnionad;

2、Android

aar文件已集成进插件中无需额外配置，只需要在android目录中AndroidManifest.xml配置

  <application
        tools:replace="android:label">

SDK版本 3.6.1.4

3、IOS

SDK已配置插件中，其余根据SDK文档配置，因为使用PlatformView，在Info.plist加入

 <key>io.flutter.embedded_views_preview</key>
    <true/>

SDK版本 3.6.1.3

使用

1、SDK初始化

await FlutterUnionad.register(
        androidAppId: "5098580", //穿山甲广告 Android appid 必填
        iosAppId:  "5098580", //穿山甲广告 ios appid 必填
        useTextureView: true, //使用TextureView控件播放视频,默认为SurfaceView,当有SurfaceView冲突的场景，可以使用TextureView 选填
        appName: "unionad_test", //appname 必填
        allowShowNotify: true, //是否允许sdk展示通知栏提示 选填
        allowShowPageWhenScreenLock: true, //是否在锁屏场景支持展示广告落地页 选填
        debug: true, //测试阶段打开，可以通过日志排查问题，上线时改为false 选填
        supportMultiProcess: true, //是否支持多进程，true支持 选填
        directDownloadNetworkType: [
          FlutterUnionad.NETWORK_STATE_2G,
          FlutterUnionad.NETWORK_STATE_3G,
          FlutterUnionad.NETWORK_STATE_4G,
          FlutterUnionad.NETWORK_STATE_WIFI
        ]); //允许直接下载的网络状态集合 选填

2、获取SDK版本

await FlutterUnionad.getSDKVersion();

3、请求权限

switch(await FlutterUnionad.requestPermissionIfNecessary()){
                  //未确定
                  case FlutterUnionad.notDetermined:
                    break;
                    //限制
                  case FlutterUnionad.restricted:
                    break;
                  //拒绝
                  case FlutterUnionad.denied:
                    break;
                  //同意
                  case FlutterUnionad.authorized:
                    break;
                }

Android获取定位、照片权限，只返回成功 Android相关权限为非必须权限，如果审核被拒可以在android目录下AndroidManifest.xml文件中参考以下申明，在打包时移除权限

<uses-permission
        android:name="android.permission.READ_PHONE_STATE"
        tools:node="remove" />

IOS 版本14及以上获取ATT权限，根据返回结果具体操作业务逻辑

4、开屏广告

FlutterUnionad.splashAdView(
        androidCodeId: "887367774", //android 开屏广告广告id 必填
        iosCodeId: "887367774", //ios 开屏广告广告id 必填
        supportDeepLink: true, //是否支持 DeepLink 选填
        expressViewWidth: 750, // 期望view 宽度 dp 必填
        expressViewHeight: 1334, //期望view高度 dp 必填
        callBack: (FlutterUnionad.FlutterUnionadState state) { //广告事件回调 选填
          //广告事件回调 选填
          //type onShow广告成功显示  onFail广告加载失败 onAplashClick开屏广告点击 onAplashSkip开屏广告跳过
          //  onAplashFinish开屏广告倒计时结束 onAplashTimeout开屏广告加载超时
          //params 详细说明
          print("到这里 ${state.tojson()}");
          switch (state.type) {
            case FlutterUnionad.onShow:
              print(state.tojson());
              break;
            case FlutterUnionad.onFail:
              print(state.tojson());
              Navigator.pop(context);
              break;
            case FlutterUnionad.onAplashClick:
              print(state.tojson());
              break;
            case FlutterUnionad.onAplashSkip:
              print(state.tojson());
              Navigator.pop(context);
              break;
            case FlutterUnionad.onAplashFinish:
              print(state.tojson());
              Navigator.pop(context);
              break;
            case FlutterUnionad.onAplashTimeout:
              print(state.tojson());
              Navigator.pop(context);
              break;
          }
        },
      ),

5、banner广告

FlutterUnionad.bannerAdView(
                androidCodeId: "945410197", //andrrid banner广告id 必填
                iosCodeId: "945410197", //ios banner广告id 必填
                supportDeepLink: true, //是否支持 DeepLink 选填
                expressAdNum: 3, //一次请求广告数量 大于1小于3 选填
                expressTime: 30, //轮播间隔事件 秒  选填
                expressViewWidth: 600.5, // 期望view 宽度 dp 必填
                expressViewHeight: 120.5, //期望view高度 dp 必填
                callBack: (FlutterUnionad.FlutterUnionadState state) { //广告事件回调 选填
                  //type onShow广告成功显示 onDislike不感兴趣 onFail广告加载失败
                  //params 详细说明
                  switch (state.type) {
                    case FlutterUnionad.onShow:
                      print(state.tojson());
                      break;
                    case FlutterUnionad.onFail:
                      print(state.tojson());
                      break;
                    case FlutterUnionad.onDislike:
                      print(state.tojson());
                      break;
                  }
                }),

6、信息流广告

FlutterUnionad.nativeAdView(
              androidCodeId: "945410197", //android banner广告id 必填
              iosCodeId: "945410197", //ios banner广告id 必填
              supportDeepLink: true, //是否支持 DeepLink 选填
              expressViewWidth: 600.5, // 期望view 宽度 dp 必填
              expressViewHeight: 120.5, //期望view高度 dp 必填
              expressNum: 2, //一次请求广告数量 大于1小于3 必填
              callBack: (FlutterUnionad.FlutterUnionadState state) { //广告事件回调 选填
                //广告事件回调 选填
                //type onShow广告成功显示 onDislike不感兴趣 onFail广告加载失败
                //params 详细说明
                switch (state.type) {
                  case FlutterUnionad.onShow:
                    print(state.tojson());
                    break;
                  case FlutterUnionad.onFail:
                    print(state.tojson());
                    break;
                  case FlutterUnionad.onDislike:
                    print(state.tojson());
                    break;
                }
              },
            ),

7、插屏广告

await FlutterUnionad.interactionAd(
                  androidCodeId: "945417892",//andrrid 插屏广告id 必填
                  iosCodeId: "945417892",//ios 插屏广告id 必填
                  supportDeepLink: true, //是否支持 DeepLink 选填
                  expressViewWidth: 300.0, // 期望view 宽度 dp 必填
                  expressViewHeight: 450.0, //期望view高度 dp 必填
                  expressNum: 2, //一次请求广告数量 大于1小于3 必填
                );

8、激励视频

FlutterUnionad.loadRewardVideoAd(
                    mIsExpress: true, //是否个性化 选填
                    androidCodeId: "945418088", //Android 激励视频广告id  必填
                    iosCodeId: "945418088", //ios 激励视频广告id  必填
                    supportDeepLink: true, //是否支持 DeepLink 选填
                    rewardName: "100金币", //奖励名称 选填
                    rewardAmount: 100, //奖励数量 选填
                    userID: "123",  //  用户id 选填
                    orientation: FlutterUnionad.VideoVERTICAL, //视屏方向 选填
                    mediaExtra: null, //扩展参数 选填
                );

监听激励视频状态

 StreamSubscription _adViewStream = FlutterUnionad.adeventEvent
       .receiveBroadcastStream()
       .listen((data) {
     if (data[FlutterUnionad.adType] == FlutterUnionad.rewardAd) {
       print("激励广告结果----->  rewardVerify=${data[FlutterUnionad.rewardVerify]} "
           "rewardName=${data[FlutterUnionad.rewardName]} "
           "rewardAmount=${data[FlutterUnionad.rewardAmount]} ");
     }
   });

9、draw视频广告

FlutterUnionad.drawFeedAdView(
                androidCodeId: "945426252", // Android draw视屏广告id 必填
                iosCodeId: "945426252", //ios draw视屏广告id 必填
                supportDeepLink: true, //是否支持 DeepLink 选填
                expressViewWidth: 600.5, // 期望view 宽度 dp 必填
                expressViewHeight: 800.5, //期望view高度 dp 必填
                callBack: (FlutterUnionad.FlutterUnionadState state) { //广告事件回调 选填
                  //type onShow显示广告 onFail广告加载失败
                  //params 详细说明
                  switch (state.type) {
                    case FlutterUnionad.onShow:
                      print(state.tojson());
                      break;
                    case FlutterUnionad.onFail:
                      print(state.tojson());
                      break;
                  }
                },
              ),

10、全屏视频广告

 FlutterUnionad.fullScreenVideoAd(
                  androidCodeId: "945491318", //android 全屏广告id 必填
                  iosCodeId: "945491318",//ios 全屏广告id 必填
                  supportDeepLink: true,  //是否支持 DeepLink 选填
                  orientation: FlutterUnionad.VideoVERTICAL,//视屏方向 选填
              );

结果监听

FlutterUnionad.adeventEvent
       .receiveBroadcastStream()
       .listen((data) {
     if(data[FlutterUnionad.adType] == FlutterUnionad.fullVideoAd){
        switch(data[FlutterUnionad.fullVideoType]){
          case FlutterUnionad.onAdShow:
            print("全屏广告显示");
            break;
          case FlutterUnionad.onAdVideoBarClick:
            print("全屏广告返回");
            break;
          case FlutterUnionad.onAdClose:
            print("全屏广告关闭");
            break;
          case FlutterUnionad.onVideoComplete:
            print("全屏广告继续");
            break;
          case FlutterUnionad.onSkippedVideo:
            print("全屏广告跳过");
            break;
        }
     }
   });

联系方式