flutter_youni_gromore 1.0.1

穿山甲Gromore的Flutter插件（由你团队出品）

🔥🔥🔥穿山甲Gromore的Flutter插件（由你团队出品）

简介

Gromore最新版本的Flutter插件，我们是一个致力于服务独立开发者的团队，这个插件我们会一直维护。

创业过程中我们解决了各种大大小小的问题，我希望我们的创业经验能让你少走弯路，遇到任何和创业相关的问题都可以咨询我们，万一我们遇到过呢。

• 如果你想做一个小项目需要资金联系我们
• 如果你有个想法，需要开发者和运营联系我们
• 如果你已经有开发好了一个应用，需要一个公司上架联系我们
• 如果你想找个公司接广告，我们只收10%，这个价格全网也难找

为什么选择新版本的Gromore？

1、老版本会面临被下架的风险，老版本的穿上甲版本有过度获取隐私位置隐私的问题。

2、会提高收入，如果是大的活动，比如双11，gromore都会针对这个版本进行更新，新版本的cpm都会有10%的提升

支持平台

• ✅ Android
• ✅ iOS

支持广告

• ✅ 开屏广告
• ✅ 插屏广告
• ✅ 激励广告
• ✅ Banner广告
• ❎信息流广告

接入方法

下面将分成Android和iOS一些配置，Android和iOS接入Flutter的步骤都是相同的；

Android接入方法

Android的接入分成2个步骤

1、配置AndroidManifest，包括添加权限和provider；

2、Gradle需要的配置；

步骤1：配置AndroidManifest

1、需要再AndroidManifest文件中添加以下权限；

<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />   
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" /> 
<uses-permission android:name="android.permission.READ_PHONE_STATE" />  

2、资源文件配置，下面只包括了穿山甲和优量汇的配置，如果单独需要穿山甲或者优量汇，可以分别单独添加配置，如果需要配置快手、百度等平台请参考如何接入快手、百度等平台的广告

• 穿山甲和优量汇的provider配置，具体可以参考flutter_youni_gromore的Android demo

<!-- 穿山甲 start================== -->
        <provider
            android:name="com.bytedance.sdk.openadsdk.TTFileProvider"
            android:authorities="${applicationId}.TTFileProvider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/pangle_file_paths" />
        </provider>

        <provider
            android:name="com.bytedance.sdk.openadsdk.multipro.TTMultiProvider"
            android:authorities="${applicationId}.TTMultiProvider"
            android:exported="false" />
        <!-- 穿山甲 end================== -->

<!-- GDT start================== -->
<!-- targetSDKVersion >= 24时才需要添加这个provider。provider的authorities属性的值为${applicationId}.fileprovider，请开发者根据自己的${applicationId}来设置这个值，例如本例中applicationId为"com.qq.e.union.demo"。 -->
        <provider
            android:name="com.qq.e.comm.GDTFileProvider"
            android:authorities="${applicationId}.gdt.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/gdt_file_path" />
        </provider>    
<activity
        android:name="com.qq.e.ads.PortraitADActivity"
        android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
        android:screenOrientation="portrait" />
    <activity
        android:name="com.qq.e.ads.LandscapeADActivity"
        android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
        android:screenOrientation="landscape"
        tools:replace="android:screenOrientation" />

    <!-- 声明SDK所需要的组件 -->
    <service
        android:name="com.qq.e.comm.DownloadService"
        android:exported="false" />
    <!-- 请开发者注意字母的大小写，ADActivity，而不是AdActivity -->

    <activity
        android:name="com.qq.e.ads.ADActivity"
        android:configChanges="keyboard|keyboardHidden|orientation|screenSize" />
    <!-- GDT end================== -->

• 这个步骤是配置android.support.FILE_PROVIDER_PATHS需要额xml文件，res/xml目录下添加两个个文件，文件名称是pangle_file_paths.xml和gdt_file_path.xml

  下面是pangle_file_paths.xml文件内容

   <?xml version="1.0" encoding="utf-8"?>
   <paths>
       <external-path name="tt_external_root" path="." />
       <external-path name="tt_external_download" path="Download" />
       <external-files-path name="tt_external_files_download" path="Download" />
       <files-path name="tt_internal_file_download" path="Download" />
       <cache-path name="tt_internal_cache_download" path="Download" />
   </paths>
  

  下面是gdt_file_path.xml文件内容

  <paths>
      <!-- 这个下载路径也不可以修改，必须为com_qq_e_download -->
      <external-cache-path
          name="gdt_sdk_download_path1"
          path="com_qq_e_download" />
      <cache-path
          name="gdt_sdk_download_path2"
          path="com_qq_e_download" />
  </paths>
  

  步骤2：配置Gradle

  1、在rallprojects和buildscript下面添穿上甲的maven

  buildscript {
      repositories {
          maven {
              url "https://artifact.bytedance.com/repository/pangle"
          }
      }
  }
    
  rootProject.allprojects {
      repositories {
          maven {
              url "https://artifact.bytedance.com/repository/pangle"
          }
      }
  }
  

  2、添加依赖库

  dependencies {
      implementation "com.pangle.cn:mediation-sdk:5.9.2.8"//融合基础包，必须引入
      
      implementation "com.qq.e.union:union:4.540.1410"// 添加优量汇的广告SDK
    	implementation "com.pangle.cn:mediation-gdt-adapter:4.540.1410.3"//添加优量汇的adapter
  } 
  

  iOS接入方法

  Android的接入分成2个步骤

  1、添加pod依赖；

  2、在Info.plist文件中添加权限；

  步骤1：添加pod依赖

  在Podfile文件中添加穿山甲和优量汇的pod依赖，可以参考flutter_youni_gromore下的iOSdemo

  target 'Runner' do
    pod 'CSJMGdtAdapter', '4.14.63.0'
    pod 'GDTMobSDK','4.14.63'
  end
  

  步骤2：添加权限

  在iOS14.5以后想要依旧能使用IDFA，建议开发者在初始化聚合SDK之前获取ATT授权，以便允许用户授权跟踪权限。

  首先，需要在App层级的info.plist里添加ATT权限描述：

  <key>NSUserTrackingUsageDescription</key>
  	<string>ATT权限使用说明，需要开发者自行设置描述</string>
  

  Flutter集成步骤

  pubspec.yaml

  flutter_youni_gromore: ^1.0.0
  

  引入

  import 'package:flutter_youni_gromore/flutter_youni_gromore.dart';
  

  使用

  SDK初始化

  WidgetsFlutterBinding.ensureInitialized();
  setGromoreEvent();//设置广告监听事情，这个事件包括一些错误事件、激励视频事件
  init().then((value) {
      if (value) {
         //广告初始化成功了执行的一些动作和方法
      }
  });
    
   Future<bool> init() async {
      try {
        //这个是广告的初始化事件
        bool result = await FlutterYouniGromore.init(
          "广告id"
        );
        return result;
      } on PlatformException catch (e) {
      }
      return false;
    }
  

  广告监听

  Future<void> setGromoreEvent() async {
      FlutterYouniGromore.onEventListener((event) {
        //event中最重要的两个属性是adId和action，adId就是广告位的id，action对应是广告位的行为
        //行为包括：广告错误、广告加载成功、广告填充、广告曝光、广告关闭（计时结束或者用户点击关闭）、广告点击、广告跳过、广告播放或计时完毕、获得广告激励 9个行为
        if (event is GromoreErrorEvent) {
          
        } else if (event is GromoreRewardEvent) {
     
        }
      });
    }
  

  下面是广告行为对应的名称：

  	///广告错误
    static const String onAdError = 'onAdError';
    ///广告加载成功
    static const String onAdLoaded = 'onAdLoaded';
    ///广告填充
    static const String onAdPresent = 'onAdPresent';
    ///广告曝光
    static const String onAdExposure = 'onAdExposure';
    ///广告关闭（计时结束或者用户点击关闭）
    static const String onAdClosed= 'onAdClosed';
    ///广告点击
    static const String onAdClicked = 'onAdClicked';
    ///广告跳过
    static const String onAdSkip = 'onAdSkip';
    ///广告播放或计时完毕
    static const String onAdComplete = 'onAdComplete';
    ///获得广告激励
    static const String onAdReward = 'onAdReward';
  

  下面是利用广告监听，展示完闪屏跳转到首页的示例代码

  Future<void> setAdEvent() async {
      FlutterYouniGromore.onEventListener((event) {
        if (event.adId == "开屏广告位id") {//先判断是开屏的广告广告位
          if (event.action == GromoreEventActions.onAdClosed ||
              event.action == GromoreEventActions.onAdSkip ||
              event.action == GromoreEventActions.onAdComplete ||
              event.action == GromoreEventActions.onAdError) {//判断各种的事件类型，符合这些条件的情况跳转到首页
            gotoMain();//跳转到首页
          }
        }
      });
    }
  

  开屏广告

  Future<void> showSplash() async {
      try {
        bool result = await FlutterYouniGromore.showSplash("广告位id");
      } on PlatformException catch (e) {
      }
    }
  

  插屏广告

   Future<void> showInterstitial() async {
      try {
        bool result = await FlutterYouniGromore.showInterstitial("广告位id");
      } on PlatformException catch (e) {
      }
    }
  

  激励视频广告

    Future<void> showReward() async {
      if (!jumpCondition()) {
        return;
      }
      try {
        bool result = await FlutterYouniGromore.showReward(
           "广告位id",
        );
      } on PlatformException catch (e) {
      }
    }
  

  Banner(横幅)广告

   GromoreBannerWidget(
                  codeId: "广告位id",
                  width: 300,//广告的宽度
                  height: 150,//广告的高度
                ),