Release Flutter SDK 3.1.0

Author: GitHub Actions

CHANGELOG.md

@@ -1,3 +1,8 @@
+## 3.1.0 , 2025
+
+- Android SDK: 8.6.1
+- iOS SDK: 8.6.0
+
 ## 3.0.1 , 2024
 
 - Android SDK: 8.4.0

README.md

@@ -93,47 +93,48 @@ Read more about Apple's ATT and user privacy guideline [here](https://developer.
 
 ### Implement Listeners
 
-#### LevelPlayRewardedVideoListener
+#### LevelPlayRewardedAdListener
 ```dart
-class LevelPlayRewardedVideoListenerClass with LevelPlayRewardedVideoListener {
+class LevelPlayRewardedAdVideoListenerClass with LevelPlayRewardedVideoListener {
   @override
-  void onAdAvailable(IronSourceAdInfo? adInfo) {
-    // Indicates that there's an available ad. 
+  void onAdLoaded(LevelPlayAdInfo adInfo) {
+    // Provided when the ad is successfully loaded
   }
 
   @override
-  void onAdUnavailable() {
-    // Indicates that no ads are available to be displayed 
+  void onAdLoadFailed(LevelPlayAdError error) {
+    // Provided when the ad fails to load. Ad Unit information is included
   }
 
   @override
-  void onAdOpened(IronSourceAdInfo? adInfo) {
-    // The Rewarded Video ad view has opened. Your activity will loose focus
+  void onAdDisplayed(LevelPlayAdInfo adInfo) {
+    // Provided when the ad is displayed. This is equivalent to an impression
   }
-  
+
   @override
-  void onAdClosed(IronSourceAdInfo? adInfo) {
-    // The Rewarded Video ad view is about to be closed. Your activity will regain its focus
+  void onAdDisplayFailed(LevelPlayAdError error, LevelPlayAdInfo adInfo) {
+    // Provided when the ad fails to be displayed
   }
 
+  @override
+  void onAdClicked(LevelPlayAdInfo adInfo) {
+    // Provided when the user clicks on the ad
+  }
 
   @override
-  void onAdRewarded(IronSourceRewardedVideoPlacement? placement, IronSourceAdInfo? adInfo) {
-    // The user completed to watch the video, and should be rewarded. 
-    // The placement parameter will include the reward data.
-    // When using server-to-server callbacks, you may ignore this event and wait for the ironSource server callback
+  void onAdClosed(LevelPlayAdInfo adInfo) {
+    // Provided when the ad is closed
   }
 
   @override
-  void onAdShowFailed(IronSourceError? error, IronSourceAdInfo? adInfo) {
-    // The rewarded video ad was failed to show
+  void onAdInfoChanged(LevelPlayAdInfo adInfo) {
+    // Provided when the ad info is updated. Available when another ad has loaded, and includes a higher CPM/Rate
   }
 
   @override
-  void onAdClicked(IronSourceRewardedVideoPlacement? placement, IronSourceAdInfo? adInfo) {
-    // Invoked when the video ad was clicked. 
-    // This callback is not supported by all networks, and we recommend using it 
-    // only if it's supported by all networks you included in your build
+  void onAdRewarded(LevelPlayReward reward, LevelPlayAdInfo adInfo) {
+    // The user completed to watch the video, and should be rewarded. 
+    // The reward parameter will include the reward data.
   }
 }
 ```
@@ -253,9 +254,13 @@ class LevelPlayNativeAdListenerClass with LevelPlayNativeAdListener {
 ```dart
 Future<void> init() async {
   final appKey = '[YOUR_APP_KEY]';
+  final userId = '[YOUR_USER_ID]';
   try {
     List<AdFormat> legacyAdFormats = [AdFormat.BANNER, AdFormat.REWARDED, AdFormat.INTERSTITIAL, AdFormat.NATIVE_AD];
-    final initRequest = LevelPlayInitRequest(appKey: appKey, legacyAdFormats: legacyAdFormats);
+    final initRequest = LevelPlayInitRequest.builder(configState.appKey)
+        .withLegacyAdFormats(legacyAdFormats)
+        .withUserId(userId)
+        .build();
     await LevelPlay.init(initRequest: initRequest, initListener: this);
   } on PlatformException catch (e) {
     print(e);
@@ -267,118 +272,110 @@ Future<void> init() async {
 
 #### LevelPlayRewardedVideo
 ```dart
-Future<void> _showRewardedVideoOnClick() async {
-  if (await IronSource.isRewardedVideoAvailable()) {
-    IronSource.showRewardedVideo();
+final LevelPlayRewardedAd _rewardedAd = LevelPlayRewardedAd(adUnitId: [YOUR_AD_UNIT]);
+
+@override
+void initState() {
+  super.initState();
+  _rewardedAd.setListener([YOUR_LISTENER]);
+}
+
+void _loadRewarded() {
+  _rewardedAd.loadAd();
+}
+
+Future<void> _showRewarded() async {
+  if (await _rewardedAd.isAdReady()) {
+    _rewardedAd.showAd(placement: [YOUR_PLACEMENT]);
   }
 }
+
+// Rest of the class
 ```
 
 #### LevelPlayInterstitial
 
 ```dart
-LevelPlayInterstitialAd? _interstitialAd;
+final LevelPlayInterstitialAd _interstitialAd = LevelPlayInterstitialAd(adUnitId: [YOUR_AD_UNIT]);
 
 @override
 void initState() {
   super.initState();
-  _createInterstitialAd();
-}
-
-void _createInterstitialAd() {
-  _intersitialAd = LevelPlayInterstitialAd(adUnitId: [YOUR_AD_UNIT]);
-  _interstitialAd!.setListener([YOUR_LISTENER]);
+  _interstitialAd.setListener([YOUR_LISTENER]);
 }
 
 void _loadInterstitial() {
-  _interstitialAd?.loadAd();
+  _interstitialAd.loadAd();
 }
 
 Future<void> _showInterstitial() async {
-  if (await __interstitialAd?.isAdReady()) {
-    _interstitialAd?.showAd(placement: [YOUR_PLACEMENT]);
+  if (await _interstitialAd.isAdReady()) {
+    _interstitialAd.showAd(placement: [YOUR_PLACEMENT]);
   }
 }
+
+// Rest of the class
 ```
 
 #### LevelPlayBanner
 
 ```dart
-LevelPlayBannerAdView? _bannerAdView;
-
-@override
-void initState() {
-  super.initState();
-  _createBannerAdView();
+final _bannerKey = GlobalKey<LevelPlayBannerAdViewState>();
+final _adSize = LevelPlayAdSize.BANNER;
+final _adUnitId = 'YOUR_AD_UNIT_ID';
+final _placementName = 'YOUR_PLACEMENT';
+
+void _loadAd() {
+  _bannerKey.currentState?.loadAd();
+  // or store LevelPlayBannerAdView in variable and call '_bannerAdView.loadAd();'
 }
 
-void _createBannerAdView() {
-  final _bannerkey = GlobalKey<LevelPlayBannerAdViewState>();
-  _bannerAdView = LevelPlayBannerAdView(
+@override
+Widget build(BuildContext context) {
+  return
+    LevelPlayBannerAdView(
       key: _bannerKey,
-      adUnitId: [YOUR_AD_UNIT_ID],
-      adSize:[YOUR_AD_SIZE],
-      listener: [YOUR_LISTENER],
-      placementName: [YOUR_PLACEMENT],
-      onPlatformViewCreated: _loadBanner
-  );
-}
-
-void _loadBanner() {
-  _bannerAdView?.loadAd();
-  // or store and use key - _bannerKey.currentState?.loadAd();
+      adUnitId: _adUnitId,
+      adSize: _adSize,
+      listener: this,
+      placementName: _placementName,
+      onPlatformViewCreated: () {
+        _loadAd();
+      },
+    );
 }
 ```
 
 #### LevelPlayNativeAd
 ```dart
-class _LevelPlayNativeAdsSection extends State<LevelPlayNativeAdsSection> with LevelPlayNativeAdListener {
-  LevelPlayNativeAd? _nativeAd;
-  LevelPlayNativeAdView? _nativeAdView;
+LevelPlayNativeAd? _nativeAd;
 
-  @override
-  void initState() {
-    super.initState();
-    _createNativeAd();
-    _createNativeAdView();
-  }
+@override
+void initState() {
+  super.initState();
+  _nativeAd = LevelPlayNativeAd.builder()
+      .withPlacementName(_placementName)
+      .withListener(this)
+      .build();
+}
 
-  /// Initialize native ad object
-  void _createNativeAd() {
-    _nativeAd = LevelPlayNativeAd.builder()
-        .withPlacementName('YOUR_PLACEMENT_NAME') // Your placement name string
-        .withListener(LevelPlayNativeAdListenerClass()) // Your level play native ad listener
-        .build();
-  }
+/// Load native ad
+void _loadAd() {
+  _nativeAd?.loadAd();
+}
 
-  /// Initialize native ad view widget with native ad
-  void _createNativeAdView() {
-    _nativeAdView = LevelPlayNativeAdView(
-      key: GlobalKey(),
-      // Unique key to force recreation of widget
-      height: 150,
-      // Your chosen height
-      width: double.infinity,
-      // Your chosen width
+@override
+Widget build(BuildContext context) {
+  return
+    LevelPlayNativeAdView(
+      height: _height,
+      width: _width,
       nativeAd: _nativeAd,
-      // Native ad object
-      templateType: LevelPlayTemplateType.SMALL,
-      // Built-in native ad template(not required when implementing custom template)
-      templateStyle: LevelPlayNativeAdTemplateStyle( // Level play native ad styling(optional)
-          callToActionStyle: LevelPlayNativeAdElementStyle(
-              backgroundColor: Colors.white,
-              textColor: Colors.lightBlue
-          )
-      ),
+      templateType: _templateType,
+      onPlatformViewCreated: () {
+        _loadAd();
+      },
     );
-  }
-
-  /// Load native ad
-  void _loadAd() {
-    _nativeAd?.loadAd();
-  }
-
-  // Rest of the class
 }
 ```
 
@@ -389,8 +386,8 @@ Note:
 - Make sure to read the official documents at [ironSource Knowledge Center](TODO: replace with the real KC link) for proper usage.
 - Some configurations must be done before initialization.
 - LevelPlayBannerListener is deprecated - Please use LevelPlayBannerAdViewListener with LevelPlayBannerAdView instead.
-
-
+- LevelPlayInterstitialListener is deprecated - Please use LevelPlayInterstitialAdListener with LevelPlayInterstitialAd instead.
+- 
 # Mediation
 
 - You can use the ironSource LevelPlay's mediation feature by adding adapters/SDKs to your project.

android/build.gradle

@@ -18,7 +18,6 @@ rootProject.allprojects {
     repositories {
         google()
         mavenCentral()
-        maven { url 'https://android-sdk.is.com/' }
     }
 }
 
@@ -39,5 +38,5 @@ android {
 dependencies {
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
     // ironSource SDK
-    implementation 'com.ironsource.sdk:mediationsdk:8.4.0'
+    implementation 'com.unity3d.ads-mediation:mediation-sdk:8.6.1'
 }

android/src/main/kotlin/com/ironSource/ironsource_mediation/Extensions.kt

@@ -14,6 +14,7 @@ import com.unity3d.mediation.LevelPlayAdInfo
 import com.unity3d.mediation.LevelPlayAdSize
 import com.unity3d.mediation.LevelPlayConfiguration
 import com.unity3d.mediation.LevelPlayInitError
+import com.unity3d.mediation.rewarded.LevelPlayReward
 import java.io.ByteArrayOutputStream
 
 /**
@@ -243,4 +244,11 @@ fun LevelPlayAdError.toMap(): HashMap<String, Any?> {
         "errorCode" to this.getErrorCode(),
         "errorMessage" to this.getErrorMessage()
     )
+}
+
+fun LevelPlayReward.toMap(): HashMap<String, Any?> {
+    return hashMapOf(
+        "name" to this.name,
+        "amount" to this.amount
+    )
 }

android/src/main/kotlin/com/ironSource/ironsource_mediation/IronSourceMediationPlugin.kt

@@ -24,6 +24,7 @@ import com.unity3d.mediation.LevelPlay
 import com.unity3d.mediation.LevelPlayAdSize
 import com.unity3d.mediation.LevelPlayInitRequest
 import com.unity3d.mediation.interstitial.LevelPlayInterstitialAd
+import com.unity3d.mediation.rewarded.LevelPlayRewardedAd
 import io.flutter.embedding.android.FlutterActivity
 import io.flutter.embedding.android.FlutterFragmentActivity
 import io.flutter.embedding.engine.FlutterEngine
@@ -207,6 +208,11 @@ class IronSourceMediationPlugin : FlutterPlugin, MethodCallHandler, ActivityAwar
       "disposeAllAds" -> disposeAllAds(result)
       /** LevelPlayAdSize API ===============================================================================*/
       "createAdaptiveAdSize" -> createAdaptiveAdSize(call, result)
+      /** LevelPlayRewardedAd API ===============================================================================*/
+      "isRewardedAdPlacementCapped" -> isRewardedAdPlacementCapped(call, result)
+      "loadRewardedAd" -> loadRewardedAd(call, result)
+      "showRewardedAd" -> showRewardedAd(call, result)
+      "isRewardedAdReady" -> isRewardedAdReady(call, result)
       else -> result.notImplemented()
     }
   }
@@ -962,6 +968,35 @@ class IronSourceMediationPlugin : FlutterPlugin, MethodCallHandler, ActivityAwar
 
   // endregion
 
+  /** region LevelPlayRewardedAd API =================================================================*/
+  private fun isRewardedAdPlacementCapped(call: MethodCall, result: Result) {
+    val placementName: String = call.argument("placementName")!!
+    val isCapped = LevelPlayRewardedAd.isPlacementCapped(placementName)
+    result.success(isCapped)
+  }
+
+  private fun loadRewardedAd(call: MethodCall, result: Result) {
+    val adObjectId: Int = call.argument("adObjectId")!!
+    val adUnitId: String = call.argument("adUnitId")!!
+    levelPlayAdObjectManager.loadRewardedAd(adObjectId, adUnitId)
+    result.success(null)
+  }
+
+  private fun showRewardedAd(call: MethodCall, result: Result) {
+    val adObjectId: Int = call.argument("adObjectId")!!
+    val placementName: String? = call.argument("placementName")
+    levelPlayAdObjectManager.showRewardedAd(adObjectId, placementName)
+    result.success(null)
+  }
+
+  private fun isRewardedAdReady(call: MethodCall, result: Result) {
+    val adObjectId: Int = call.argument("adObjectId")!!
+    val isReady = levelPlayAdObjectManager.isRewardedAdReady(adObjectId)
+    result.success(isReady)
+  }
+
+  // endregion
+
   /** region ActivityAware =======================================================================*/
   override fun onAttachedToActivity(binding: ActivityPluginBinding) {
     activity = binding.activity