字节跳动 穿山甲广告SDK Bytedance-UnionAD flutter版本插件.zip

# 字节跳动穿山甲广告 Flutter版本 <p> <a href="https://pub.flutter-io.cn/packages/flutter_unionad"><img src=https://img.shields.io/pub/v/flutter_unionad?color=orange></a> <a href="https://pub.flutter-io.cn/packages/flutter_unionad"><img src=https://img.shields.io/pub/likes/flutter_unionad></a> <a href="https://pub.flutter-io.cn/packages/flutter_unionad"><img src=https://img.shields.io/pub/points/flutter_unionad></a> <a href="https://github.com/gstory0404/flutter_unionad/commits"><img src=https://img.shields.io/github/last-commit/gstory0404/flutter_unionad></a> <a href="https://github.com/gstory0404/flutter_unionad"><img src=https://img.shields.io/github/stars/gstory0404/flutter_unionad></a> </p> <p> <a href="http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=VhD0AZSmzvsD3fu7CeQFkzpBQHMHANb1&authKey=W7JGJ0HKklyhP1jyBvbTF2Dkw0cq4UmhVSx2zXVdIm6n48Xrto%2B7%2B1n9jbkAadyF&noverify=0&group_code=649574038"><img src=https://img.shields.io/badge/flutter%E4%BA%A4%E6%B5%81%E7%BE%A4-649574038-blue></a> <a href="http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=9I9lyXewEsEnx0f00EOF_9hEcFmG5Bmg&authKey=AJfQ8%2FhOLcoJ0p5B16EITjFav1IIs3UAerZSUsWZfa0evuklgxibHti51AYlZgI3&noverify=0&group_code=769626410"><img src=https://img.shields.io/badge/flutter%E4%BA%A4%E6%B5%81%E7%BE%A42-769626410-blue></a> </p> <img src="https://github.com/gstory0404/flutter_unionad/blob/master/image/demo.gif" width="30%"> ## 简介 flutter_unioad是一款集成了穿山甲Android和iOSSDK的Flutter插件,方便直接调用穿山甲SDK方法开发，已支持null safety,[体验demo](https://www.pgyer.com/j7YB)，可通过[GTAds](https://github.com/gstory0404/GTAds)实现多个广告平台接入、统一管理。 ## 官方文档 * [Android](https://partner.oceanengine.com/union/media/union/download/detail?id=4&osType=android) * [IOS](https://partner.oceanengine.com/union/media/union/download/detail?id=16&osType=ios) ## 版本更新 [更新日志](https://github.com/gstory0404/flutter_unionad/blob/master/CHANGELOG.md) ## 注意事项 ⚠️ 版本更新必看，不然可能广告加载可能会出现异常 [插件更新调整](https://github.com/gstory0404/flutter_unionad/blob/master/notice.md) ## 本地开发环境 ``` [✓] Flutter (Channel stable, 3.16.6, on macOS 14.2.1 23C71 darwin-x64, locale zh-Hans-CN) [✓] Android toolchain - develop for Android devices (Android SDK version 33.0.1) [✓] Xcode - develop for iOS and macOS (Xcode 15.2) [✓] Chrome - develop for the web [✓] Android Studio (version 2022.1) [✓] Android Studio (version 2023.1) [✓] IntelliJ IDEA Ultimate Edition (version 2023.3.2) [✓] VS Code (version 1.85.2) [✓] Connected device (4 available) [✓] Network resources ``` ## 集成步骤 #### 1、pubspec.yaml ```Dart flutter_unionad: ^latest ``` 引入 ```Dart import 'package:flutter_unionad/flutter_unionad.dart'; ``` #### 2、Android [SDK](https://www.csjplatform.com/union/media/union/download/log?id=4)已配置插件中无需额外配置，只需要在android目录中AndroidManifest.xml配置 ```Java <manifest ··· xmlns:tools="http://schemas.android.com/tools" ···> <application tools:replace="android:label"> ``` #### 3、IOS [SDK](https://www.csjplatform.com/union/media/union/download/log?id=16)已配置插件中，其余根据SDK文档配置，因为使用PlatformView，在Info.plist加入 ``` <key>io.flutter.embedded_views_preview</key> <true/> ``` ## 使用 #### 1、SDK初始化 ⚠️如果要修改个性化，重新调用初始化方法 ```Dart await FlutterUnionad.register( //穿山甲广告 Android appid 必填 androidAppId: "5098580", //穿山甲广告 ios appid 必填 iosAppId: "5098580", //使用TextureView控件播放视频,默认为SurfaceView,当有SurfaceView冲突的场景，可以使用TextureView 选填 useTextureView: true, //appname 必填 appName: "unionad_test", //是否允许sdk展示通知栏提示 选填 allowShowNotify: true, //是否在锁屏场景支持展示广告落地页 选填 allowShowPageWhenScreenLock: true, //是否显示debug日志 debug: true, //是否支持多进程，true支持 选填 supportMultiProcess: true, //是否开启个性化推荐 选填 默认开启 personalise: FlutterUnionadPersonalise.close, //主题模式 默认FlutterUnionAdTheme.DAY,修改后需重新调用初始化 themeStatus: FlutterUnionAdTheme.DAY, //允许直接下载的网络状态集合 选填 directDownloadNetworkType: [ FlutterUnionadNetCode.NETWORK_STATE_2G, FlutterUnionadNetCode.NETWORK_STATE_3G, FlutterUnionadNetCode.NETWORK_STATE_4G, FlutterUnionadNetCode.NETWORK_STATE_WIFI ] ); ``` #### 2、获取SDK版本 ```Dart await FlutterUnionad.getSDKVersion(); ``` #### 3、请求权限 ```Dart FlutterUnionad.requestPermissionIfNecessary( callBack: FlutterUnionadPermissionCallBack( notDetermined: () { print("权限未确定"); }, restricted: () { print("权限限制"); }, denied: () { print("权限拒绝"); }, authorized: () { print("权限同意"); }, ), ); ``` Android获取定位、照片权限，只返回成功 Android相关权限为非必须权限，可选择在AndroidManifest.xml中声明 IOS 版本14及以上获取ATT权限，根据返回结果具体操作业务逻辑 #### 4、开屏广告 ```Dart FlutterUnionad.splashAdView( //是否使用个性化模版 设定widget宽高 mIsExpress: true, //android 开屏广告广告id 必填 androidCodeId: "887367774", //ios 开屏广告广告id 必填 iosCodeId: "887367774", //是否支持 DeepLink 选填 supportDeepLink: true, // 期望view 宽度 dp 选填 mIsExpress=true必填 expressViewWidth: 750, //期望view高度 dp 选填 mIsExpress=true必填 expressViewHeight: 800, //控制下载APP前是否弹出二次确认弹窗 downloadType: FlutterUnionadDownLoadType.DOWNLOAD_TYPE_POPUP, //用于标注此次的广告请求用途为预加载（当做缓存）还是实时加载， adLoadType: FlutterUnionadLoadType.LOAD, //是否影藏跳过按钮(当影藏的时候显示自定义跳过按钮) 默认显示 hideSkip: false, callBack: FlutterUnionadSplashCallBack( onShow: () { print("开屏广告显示"); }, onClick: () { print("开屏广告点击"); Navigator.pop(context); }, onFail: (error) { print("开屏广告失败 $error"); }, onFinish: () { print("开屏广告倒计时结束"); Navigator.pop(context); }, onSkip: () { print("开屏广告跳过"); Navigator.pop(context); }, onTimeOut: () { print("开屏广告超时"); }, ), ), ``` #### 5、banner广告 ```Dart FlutterUnionad.bannerAdView( //andrrid banner广告id 必填 androidCodeId: "945410197", //ios banner广告id 必填 iosCodeId: "945410197", //是否使用个性化模版 mIsExpress: true, //是否支持 DeepLink 选填 supportDeepLink: true, //一次请求广告数量 大于1小于3 必填 expressAdNum: 3, //轮播间隔事件 30-120秒 选填 expressTime: 30, // 期望view 宽度 dp 必填 expressViewWidth: 600.5, //期望view高度 dp 必填