com.azerion.bluestack 6.0.0-beta.3 → 6.0.0-beta.5

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## [6.0.0-beta.3] - 2026-06-10
+## [6.0.0-beta.4] - 2026-06-15
 
 ### Native SDK upgrades
 
@@ -19,50 +19,50 @@
   `BlueStackAds.IsDebugModeEnabled` to read the cached state.
 - `BlueStackAds.IsInitialized` property to check native-side readiness.
 - `InterstitialAd.IsReady` and `RewardedAd.IsReady` properties.
-- `BannerAd` anchor-based positioning — new constructor
-  `BannerAd(string placementId, AdSize adSize, Transform anchor, Camera camera = null)`. The banner
-  follows the anchor's screen position automatically via the new `AdPlacementHandler` component.
-  The anchor's screen-space position is treated as the banner's **top-left corner** (matching
-  native iOS / Android frame placement).
-- `BannerAd` custom screen-space position constructor — `BannerAd(string placementId, AdSize adSize, Vector2 position)`.
+-  A new `BannerAd` constructor for anchor-based positioning,
+   `BannerAd(string placementId, AdSize adSize, Transform anchor, Camera camera = null)`. The banner
+   follows the anchor's screen position automatically via the `AdPlacementHandler` component.
+   The anchor's screen-space position is treated as the banner's **top-left corner** (matching
+   native iOS / Android frame placement).
+- A new `BannerAd` constructor for custom screen-space positioning,
+  `BannerAd(string placementId, AdSize adSize, Vector2 position)`.
   The `position` is the banner's **top-left corner** in Unity pixels (bottom-left origin).
-- Optional `useSafeArea` parameter on `BannerAd(string, AdSize, AdPosition, bool useSafeArea = true)`
+- Optional `useSafeArea` parameter on `BannerAd(string placementId, AdSize adSize, AdPosition adPosition, bool useSafeArea = true)`
   to opt out of safe-area insets for sticky Top/Bottom banners. Custom-positioned banners always
   ignore the safe area.
-- Banner masking — `BannerAd.SetMask(RectTransform, Camera)` / `BannerAd.RemoveMask()` clip the banner
-  to a UI region. The mask follows the `RectTransform` as it animates or resizes.
+- Banner masking, `BannerAd.SetMask(RectTransform, Camera)` / `BannerAd.RemoveMask()` clip the banner
+  to a UI region. The mask follows the `RectTransform` as it animates or resizes via the `AdMaskHandler` component.
 - `BannerAd.OnAdResized` event delivers a `PreferredBannerSize` (`Width`, `Height`) whenever the SDK
   reports a post-load size change.
 - `BannerAd.OnAdLoaded` payload changed to `PreferredBannerSize` carrying the SDK-preferred dimensions
   (was `EventArgs`).
 - `RewardedAd.OnAdRewardEarned` (renamed from `OnRewardEarned`) delivers a `RewardedItem`.
-- `UpdateInterval` and `ForceUpdate` API added to `AdMaskHandler` and `AdPlacementHandler`
 
 ### Changed
 
-- **Breaking** — `BlueStackAds.Initialize` signature simplified:
+- **Breaking**: `BlueStackAds.Initialize` signature simplified:
   - Before: `Initialize(string appId, Settings settings, Action<SDKInitializationStatus> sdkCallback, Action<IInitializationStatusClient> adaptersCallback)`
   - After: `Initialize(string appId, Action<InitializationStatus> initializationCompleteAction = null)`
-  - The `Settings`-based debug toggle is replaced by `BlueStackAds.SetDebugMode(bool)`.
+  - The `Settings` based debug toggle is replaced by `BlueStackAds.SetDebugMode(bool)`.
   - The separate success/fail `SDKInitializationStatus` callback is removed. The single completion
     callback now delivers `InitializationStatus.AdapterStatusMap` (per-adapter `AdapterStatus`).
   - The initialization callback is now consistently dispatched to the Unity main thread on both
     iOS and Android.
-- **Breaking** — `RewardedVideoAd` class renamed to `RewardedAd`.
-- **Breaking** — Banner event names renamed:
+- **Breaking**: `RewardedVideoAd` class renamed to `RewardedAd`.
+- **Breaking**: Banner event names renamed:
   - `OnBannerDidLoad` → `OnAdLoaded` (payload changed to `PreferredBannerSize`)
   - `OnBannerDidFailed` → `OnAdFailedToLoad`
   - `OnBannerDisplay` → `OnAdDisplayed`
   - `OnBannerHide` → `OnAdHidden`
   - `OnBannerDidRefresh` → `OnAdRefreshed`
   - `OnBannerDidFailToRefresh` → `OnAdFailedToRefresh`
-- **Breaking** — Interstitial event names renamed:
+- **Breaking**: Interstitial event names renamed:
   - `OnInterstitialDidLoaded` → `OnAdLoaded`
   - `OnInterstitialDidFail` → `OnAdFailedToLoad`
   - `OnInterstitialClicked` → `OnAdClicked`
   - `OnInterstitialDidShown` → `OnAdDisplayed`
   - `OnInterstitialDisappear` → `OnAdDismissed`
-- **Breaking** — Rewarded event names renamed:
+- **Breaking**: Rewarded event names renamed:
   - `OnRewardedVideoAdLoaded` → `OnAdLoaded`
   - `OnRewardedVideoAdError` → `OnAdFailedToLoad`
   - `OnRewardedVideoAdAppeared` → `OnAdDisplayed`
@@ -70,30 +70,27 @@
   - `OnRewardedVideoAdClosed` → `OnAdDismissed`
   - `OnUserRewardEarned` → `OnAdRewardEarned`
 - To display banner ads, `BannerAd.Show()` must be called after the ad has been loaded.
-- **Breaking** — `BannerAd` constructors now take `AdSize` as a mandatory second parameter, and
+- **Breaking**: `BannerAd` constructors now take `AdSize` as a mandatory second parameter, and
   `BannerAd.Load` no longer takes one:
   - Before: `new BannerAd(placementId, adPosition); bannerAd.Load(adSize);`
   - After: `new BannerAd(placementId, adSize, adPosition); bannerAd.Load();`
   - Applies to all three constructor shapes (`AdPosition`, `Vector2`, `Transform` anchor).
   - `BannerAd.Load(AdSize)` and `BannerAd.Load(AdSize, Preference)` are replaced by parameterless
-    `Load()` and `Load(Preference)` — the ad size is now fixed for the lifetime of the `BannerAd`.
-- **Breaking** — `Preference` class renamed to `RequestOptions` and made **immutable**.
+    `Load()` and `Load(Preference)`, the ad size is now fixed for the lifetime of the `BannerAd`.
+- **Breaking**: `Preference` class is replaced with `RequestOptions` and made **immutable**.
   - Mutable `Set*` builder methods are replaced by a single optional-named-args constructor:
     `new RequestOptions(age: 25, gender: Gender.Male, location: ..., consentFlag: 1,
     language: "en", keyword: "...", contentUrl: "...")`.
   - A single `RequestOptions` instance is safe to reuse across multiple `Load(...)` calls.
-- **Breaking** — `Location` made immutable:
+- **Breaking**: `Location` made immutable:
   - Constructor now `new Location(double latitude, double longitude, string provider = NONE_PROVIDER)`
     instead of `new Location(provider)` + mutable `Latitude` / `Longitude` setters.
   - `getProvider()` method replaced by a `Provider` get-only property.
 
 ### Removed
 
-- **Breaking** — `Settings` parameter removed from `BlueStackAds.Initialize`. Use `BlueStackAds.SetDebugMode(bool)` instead of
+- **Breaking**: `Settings` parameter removed from `BlueStackAds.Initialize`. Use `BlueStackAds.SetDebugMode(bool)` instead of
   `new Settings(isDebugModeEnabled: ...)`.
-- **Breaking** — `Preference.Destroy()` removed — the new immutable `RequestOptions` holds no
-  native resources on the Unity side; the native intermediate is constructed and released inside
-  each `Load(...)` call.
 
 ## [3.4.1] - 2026-02-27
 

package/Editor/BlueStackDependenciesSource.xml

@@ -1,4 +1,4 @@
-<dependencies version="6.0.0-beta.3">
+<dependencies version="6.0.0-beta.5">
     <androidPackages>
         <androidPackage alias="BlueStack" spec="com.azerion:bluestack-sdk-core:6.0.1">
             <repositories>

package/Plugins/iOS/BSUBanner.swift

@@ -59,7 +59,7 @@ public class BSUBanner: NSObject, BannerViewDelegate {
 
 
     private func createBannerAd() {
-        let initializeBannerFactory = {
+        BSUMainThreadDispatcher.run {
             self.destroy()
             guard let bannerAdSize = self.bannerAdSize else { return }
             self.bannerAdsFactory = BannerView(adSize: bannerAdSize.size)
@@ -69,55 +69,31 @@ public class BSUBanner: NSObject, BannerViewDelegate {
             // Auto refresh is on by default in the SDK and can be controlled from the console
             // self.bannerAdsFactory?.startAutoRefresh()
         }
-
-        if Thread.isMainThread {
-            initializeBannerFactory()
-        } else {
-            DispatchQueue.main.async {
-                initializeBannerFactory()
-            }
-        }
     }
 
     @objc public func loadAd() {
-        if Thread.isMainThread {
-            self.loadBannerAd(requestOptions: nil)
-        } else {
-            DispatchQueue.main.async { [weak self] in
-                self?.loadBannerAd(requestOptions: nil)
-            }
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.loadBannerAd(requestOptions: nil)
         }
     }
 
     @objc public func loadAd(withRequestOptions requestOptionsRef: BSUTypeRequestOptionsRef) {
         let bsuOptions = Unmanaged<BSURequestOptions>.fromOpaque(requestOptionsRef).takeUnretainedValue()
         let sdkOptions = bsuOptions.toSDKRequestOptions()
-        if Thread.isMainThread {
-            self.loadBannerAd(requestOptions: sdkOptions)
-        } else {
-            DispatchQueue.main.async { [weak self] in
-                self?.loadBannerAd(requestOptions: sdkOptions)
-            }
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.loadBannerAd(requestOptions: sdkOptions)
         }
     }
 
     @objc public func show() {
-        if Thread.isMainThread {
-            showBannerAd()
-        } else {
-            DispatchQueue.main.async { [weak self] in
-                self?.showBannerAd()
-            }
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.showBannerAd()
         }
     }
 
     @objc public func hide() {
-        if Thread.isMainThread {
-            hideBannerAd()
-        } else {
-            DispatchQueue.main.async { [weak self] in
-                self?.hideBannerAd()
-            }
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.hideBannerAd()
         }
     }
 
@@ -151,8 +127,11 @@ public class BSUBanner: NSObject, BannerViewDelegate {
             // Switching from Auto Layout to frame-based positioning
             self.switchPositioningMode()
         } else {
-            // Already in custom mode, just update position (fast path)
-            self.updateCustomPosition()
+            // Already in custom mode, just update position (fast path).
+            // Guarded because this path is hit on every position update from Unity.
+            BSUMainThreadDispatcher.run { [weak self] in
+                self?.updateCustomPosition()
+            }
         }
     }
     
@@ -202,7 +181,7 @@ public class BSUBanner: NSObject, BannerViewDelegate {
                 self.updateCustomPosition()
             }
         }
-        if Thread.isMainThread { work() } else { DispatchQueue.main.async(execute: work) }
+        BSUMainThreadDispatcher.run(work)
     }
 
     /// Removes the `MaskView` and moves `bannerContainerView` back to `unityView`.
@@ -227,7 +206,7 @@ public class BSUBanner: NSObject, BannerViewDelegate {
                 self.updateCustomPosition()
             }
         }
-        if Thread.isMainThread { work() } else { DispatchQueue.main.async(execute: work) }
+        BSUMainThreadDispatcher.run(work)
     }
 
     // MARK: - Private Methods
@@ -248,20 +227,16 @@ public class BSUBanner: NSObject, BannerViewDelegate {
                 self.updateCustomPosition()
             }
         }
-        if Thread.isMainThread { work() } else { DispatchQueue.main.async(execute: work) }
+        BSUMainThreadDispatcher.run(work)
     }
-    
+
     // bannerContainerView Positioning
     // - Auto Layout: Used for .topOfScreen and .bottomOfScreen (set once, iOS manages)
     // - Frame-based: Used for .custom positions (direct frame manipulation for frequent updates)
     
     private func switchPositioningMode() {
-        if Thread.isMainThread {
-            self.switchPositioningModeInternal()
-        } else {
-            DispatchQueue.main.async { [weak self] in
-                self?.switchPositioningModeInternal()
-            }
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.switchPositioningModeInternal()
         }
     }
     
@@ -277,21 +252,13 @@ public class BSUBanner: NSObject, BannerViewDelegate {
     }
     
     private func positionBannerView() {
-        if Thread.isMainThread {
-            if adPosition == .custom {
+        BSUMainThreadDispatcher.run { [weak self] in
+            guard let self = self else { return }
+            if self.adPosition == .custom {
                 self.updateCustomPosition()
             } else {
                 self.updateAutoLayoutPosition()
             }
-        } else {
-            DispatchQueue.main.async { [weak self] in
-                guard let self = self else { return }
-                if self.adPosition == .custom {
-                    self.updateCustomPosition()
-                } else {
-                    self.updateAutoLayoutPosition()
-                }
-            }
         }
     }
     
@@ -510,46 +477,28 @@ public class BSUBanner: NSObject, BannerViewDelegate {
 
     private func removeBannerView() {
         guard let _ = self.bannerView else { return }
-
-        if Thread.isMainThread {
-            self.bannerView?.removeFromSuperview()
-            self.bannerView = nil
-        } else {
-            DispatchQueue.main.async { [weak self] in
-                guard let strongSelf = self else { return }
-                strongSelf.bannerView?.removeFromSuperview()
-                strongSelf.bannerView = nil
-            }
+        BSUMainThreadDispatcher.run { [weak self] in
+            guard let strongSelf = self else { return }
+            strongSelf.bannerView?.removeFromSuperview()
+            strongSelf.bannerView = nil
         }
     }
 
     private func removeBannerContainerView() {
         guard let _ = self.bannerContainerView else { return }
-
-        if Thread.isMainThread {
-            self.bannerContainerView?.removeFromSuperview()
-            self.bannerContainerView = nil
-        } else {
-            DispatchQueue.main.async { [weak self] in
-                guard let strongSelf = self else { return }
-                strongSelf.bannerContainerView?.removeFromSuperview()
-                strongSelf.bannerContainerView = nil
-            }
+        BSUMainThreadDispatcher.run { [weak self] in
+            guard let strongSelf = self else { return }
+            strongSelf.bannerContainerView?.removeFromSuperview()
+            strongSelf.bannerContainerView = nil
         }
     }
-    
+
     private func removeBannerMaskView() {
         guard let _ = self.bannerMaskView else { return }
-
-        if Thread.isMainThread {
-            self.bannerMaskView?.removeFromSuperview()
-            self.bannerMaskView = nil
-        } else {
-            DispatchQueue.main.async { [weak self] in
-                guard let strongSelf = self else { return }
-                strongSelf.bannerMaskView?.removeFromSuperview()
-                strongSelf.bannerMaskView = nil
-            }
+        BSUMainThreadDispatcher.run { [weak self] in
+            guard let strongSelf = self else { return }
+            strongSelf.bannerMaskView?.removeFromSuperview()
+            strongSelf.bannerMaskView = nil
         }
     }
     // MARK: - Constraint References (only used for Auto Layout mode)
@@ -602,37 +551,35 @@ public class BSUBanner: NSObject, BannerViewDelegate {
     // MARK: - BannerViewDelegate
 
     public func onLoad(_ bannerView: BlueStackSDK.BannerView, _ preferredHeight: CGFloat) {
-//      print("Banner successfully loaded with preferredHeight: \(preferredHeight)")
-        self.removeBannerView()
-        self.bannerView = bannerView
-        self.bannerContainerView?.addSubview(bannerView)
-        self.bannerView?.translatesAutoresizingMaskIntoConstraints = false
-
-        // var target = CGSize(width: adFrame.width, height: preferredHeight)
-
-        // Resolve the final container size:
-        //   - height: always the SDK-reported preferredHeight
-        //   - width:  prefer bannerView.frame.width if non-zero, else originally requested width
-        let resolvedWidth = bannerView.frame.size.width
-        let target = CGSize(
-            width: resolvedWidth > 0 ? resolvedWidth : adFrame.width,
-            height: preferredHeight
-        )
-        if let containerView = self.bannerContainerView {
-            self.setupBannerViewConstraints(with: containerView)
-            containerView.layoutIfNeeded()
-            adjustContainerSize(to: target)
-        }
-        BSULogger.debug("Banner", message: "ad loaded \(Int(target.width))x\(Int(target.height))")
-        // Forward the final container size (preferredWidth, preferredHeight) to Unity.
-        self.onBannerDidLoadCallback?(
-            self.bannerClient,
-            Int32(target.width),
-            Int32(target.height)
-        )
-        
-        // Auto show on load
-        // showBannerAd()
+        // Delegate callback may arrive off the main thread; all work below touches UIKit.
+        BSUMainThreadDispatcher.run { [weak self] in
+            guard let self = self else { return }
+            self.removeBannerView()
+            self.bannerView = bannerView
+            self.bannerContainerView?.addSubview(bannerView)
+            self.bannerView?.translatesAutoresizingMaskIntoConstraints = false
+
+            // Resolve the final container size:
+            //   - height: always the SDK-reported preferredHeight
+            //   - width:  prefer bannerView.frame.width if non-zero, else originally requested width
+            let resolvedWidth = bannerView.frame.size.width
+            let target = CGSize(
+                width: resolvedWidth > 0 ? resolvedWidth : self.adFrame.width,
+                height: preferredHeight
+            )
+            if let containerView = self.bannerContainerView {
+                self.setupBannerViewConstraints(with: containerView)
+                containerView.layoutIfNeeded()
+                self.adjustContainerSize(to: target)
+            }
+            BSULogger.debug("Banner", message: "ad loaded \(Int(target.width))x\(Int(target.height))")
+            // Forward the final container size (preferredWidth, preferredHeight) to Unity.
+            self.onBannerDidLoadCallback?(
+                self.bannerClient,
+                Int32(target.width),
+                Int32(target.height)
+            )
+        }
     }
     
     public func onFailedToLoad(_ bannerView: BlueStackSDK.BannerView, _ error: any Error) {
@@ -666,15 +613,19 @@ public class BSUBanner: NSObject, BannerViewDelegate {
     }
     
     public func onResize(_ bannerView: BlueStackSDK.BannerView, _ size: CGSize) {
-        BSULogger.debug("Banner", message: "ad resized")
-        adjustContainerSize(to: size)
-        // Forward the final size (preferredWidth, preferredHeight) to Unity.
-        // adFrame is updated by adjustContainerSize and reflects the size actually applied.
-        self.onBannerResizeCallback?(
-            self.bannerClient,
-            Int32(adFrame.width),
-            Int32(adFrame.height)
-        )
+        // Delegate callback may arrive off the main thread; adjustContainerSize touches UIKit.
+        BSUMainThreadDispatcher.run { [weak self] in
+            guard let self = self else { return }
+            BSULogger.debug("Banner", message: "ad resized")
+            self.adjustContainerSize(to: size)
+            // Forward the final size (preferredWidth, preferredHeight) to Unity.
+            // adFrame is updated by adjustContainerSize and reflects the size actually applied.
+            self.onBannerResizeCallback?(
+                self.bannerClient,
+                Int32(self.adFrame.width),
+                Int32(self.adFrame.height)
+            )
+        }
     }
 
     /// Updates `adFrame` and Resizes `bannerContainerView` so it wraps `bannerView` exactly.

package/Plugins/iOS/BSUInterstitialAd.swift

@@ -32,24 +32,24 @@ public class BSUInterstitialAd: NSObject {
     }
 
     @objc public func loadAd() {
-        DispatchQueue.main.async {
-            self.interstitialAdFactory?.load()
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.interstitialAdFactory?.load()
         }
     }
 
     @objc public func loadAd(withRequestOptions requestOptionsRef: BSUTypeRequestOptionsRef) {
         let bsuOptions = Unmanaged<BSURequestOptions>.fromOpaque(requestOptionsRef).takeUnretainedValue()
         let sdkOptions = bsuOptions.toSDKRequestOptions()
-        DispatchQueue.main.async {
-            self.interstitialAdFactory?.load(requestOptions: sdkOptions)
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.interstitialAdFactory?.load(requestOptions: sdkOptions)
         }
     }
 
     @objc public func show() {
         if let interstitialAd = self.interstitialAdFactory {
             if interstitialAd.isReady {
-                DispatchQueue.main.async {
-                    interstitialAd.show(fromRootViewController: self.interstitialAdFactory?.viewController)
+                BSUMainThreadDispatcher.run { [weak self] in
+                    interstitialAd.show(fromRootViewController: self?.interstitialAdFactory?.viewController)
                 }
             } else {
                 BSULogger.warning("Interstitial", message: "cannot show: ad not ready")

package/Plugins/iOS/BSUMainThreadDispatcher.swift

@@ -0,0 +1,25 @@
+//
+//  BSUMainThreadDispatcher.swift
+//  UnityFramework
+//
+//  Encapsulates the "run on the main thread" guard used across the iOS bridge.
+//  WebView (WKWebView) and UIKit must only be touched on the main thread.
+//
+
+import Foundation
+
+@objc(BSUMainThreadDispatcher)
+public class BSUMainThreadDispatcher: NSObject {
+    /// Executes `work` on the main thread.
+    /// Runs synchronously when the caller is already on the main thread, 
+    /// otherwise hops to the main queue async.
+    @objc public static func run(_ work: @escaping () -> Void) {
+        if Thread.isMainThread {
+            work()
+        } else {
+            DispatchQueue.main.async {
+                work()
+            }
+        }
+    }
+}

package/Plugins/iOS/BSUMainThreadDispatcher.swift.meta

@@ -0,0 +1,37 @@
+fileFormatVersion: 2
+guid: 7bdea4bf7c6344c3f9bcb393fa36d210
+PluginImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  iconMap: {}
+  executionOrder: {}
+  defineConstraints: []
+  isPreloaded: 0
+  isOverridable: 1
+  isExplicitlyReferenced: 0
+  validateReferences: 1
+  platformData:
+  - first:
+      Any:
+    second:
+      enabled: 0
+      settings: {}
+  - first:
+      Editor: Editor
+    second:
+      enabled: 0
+      settings:
+        DefaultValueInitialized: true
+  - first:
+      iPhone: iOS
+    second:
+      enabled: 1
+      settings: {}
+  - first:
+      tvOS: tvOS
+    second:
+      enabled: 1
+      settings: {}
+  userData:
+  assetBundleName:
+  assetBundleVariant:

package/Plugins/iOS/BSUNativeAd.swift

@@ -40,29 +40,37 @@ public class BSUNativeAd: NSObject, AdsAdapterNativeDelegate, AdClickDelegate, N
     }
 
     @objc public func loadAd() {
-        nativeAdsFactory?.loadNative()
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.nativeAdsFactory?.loadNative()
+        }
     }
 
     @objc public func loadAd(withRequestOptions requestOptionsRef: BSUTypeRequestOptionsRef) {
         let bsuOptions = Unmanaged<BSURequestOptions>.fromOpaque(requestOptionsRef).takeUnretainedValue()
         let sdkOptions = bsuOptions.toSDKRequestOptions()
-        
+
         // RequestOptions to Preference
         var requestOptionsToPreferenceTransformer = RequestOptionsToPreferenceTransformer()
         let preference = requestOptionsToPreferenceTransformer.transform(sdkOptions)
-        
-        nativeAdsFactory?.loadNative(withPreferences: preference, withCover: false)
+
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.nativeAdsFactory?.loadNative(withPreferences: preference, withCover: false)
+        }
     }
 
     @objc public func recordImpression(_ args: [AnyHashable: Any]) {
-        if let nativeAdsObject = self.nativeAdsObject {
+        // Drives the OMID/measurement session and WebView, so it must run on the main thread.
+        BSUMainThreadDispatcher.run { [weak self] in
+            guard let self = self, let nativeAdsObject = self.nativeAdsObject else { return }
             nativeAdsObject.setNativeAdImpressionListener(self)
             nativeAdsObject.recordImpression(args)
         }
     }
 
     @objc public func performClick(_ args: [AnyHashable: Any]) {
-        if let nativeAdsObject = self.nativeAdsObject {
+        // Routes through the OMID session like recordImpression, so it must run on the main thread.
+        BSUMainThreadDispatcher.run { [weak self] in
+            guard let nativeAdsObject = self?.nativeAdsObject else { return }
             nativeAdsObject.performClick(args)
         }
     }

package/Plugins/iOS/BSURewardedAd.swift

@@ -32,24 +32,24 @@ public class BSURewardedAd: NSObject {
     }
 
     @objc public func loadAd() {
-        DispatchQueue.main.async {
-            self.rewardedAdFactory?.load()
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.rewardedAdFactory?.load()
         }
     }
 
     @objc public func loadAd(withRequestOptions requestOptionsRef: BSUTypeRequestOptionsRef) {
         let bsuOptions = Unmanaged<BSURequestOptions>.fromOpaque(requestOptionsRef).takeUnretainedValue()
         let sdkOptions = bsuOptions.toSDKRequestOptions()
-        DispatchQueue.main.async {
-            self.rewardedAdFactory?.load(requestOptions: sdkOptions)
+        BSUMainThreadDispatcher.run { [weak self] in
+            self?.rewardedAdFactory?.load(requestOptions: sdkOptions)
         }
     }
-    
+
     @objc public func show() {
         if let rewardedAd = self.rewardedAdFactory {
             if rewardedAd.isReady {
-                DispatchQueue.main.async {
-                    rewardedAd.show(fromRootViewController: self.rewardedAdFactory?.viewController)
+                BSUMainThreadDispatcher.run { [weak self] in
+                    rewardedAd.show(fromRootViewController: self?.rewardedAdFactory?.viewController)
                 }
             } else {
                 BSULogger.warning("Rewarded", message: "cannot show: ad not ready")

package/README.md

@@ -15,17 +15,21 @@ This SDK supports four types of Ads:
 
 ## Prerequisites
 
--   Use Unity 2020.3 or higher
+-   Use Unity 2020.3 or higher (Unity 6 or higher recommended and tested)
 -   Android
-    - Minimum Android API level of 21 or higher  
-    - Target Android API level 31 or higher
+    - Minimum Android API level of 21 or higher
+    - Target Android API level 34 or higher
+    - JDK 17 or higher
 -   iOS
-    - Xcode 15.3 or higher  
-    - iOS 12.2 or higher
+    - Xcode 15.3 or higher
+    - iOS 13.0 or higher
     - [CocoaPods](https://guides.cocoapods.org/using/getting-started.html)
 
-:::info
-Android API level can be set in `Project Settings > Player > Android > Other Settings > Other Settings.`
+:::note
+- Android API level can be set in `Project Settings > Player > Android > Other Settings > Other Settings.`
+- Set your AdMob App ID in `Azerion > BlueStack > Settings` when the Google Mobile Ads adapter is enabled
+- Requires **External Dependency Manager for Unity (EDM4U)**, It resolves all native Android/iOS dependencies
+- AndroidX enabled; enable the Custom Main Gradle Template and Custom Gradle Properties Template, then resolve via `External Dependency Manager > Android Resolver`
 :::
 
 ## Import the package

package/Runtime/API/Banner/AdPosition.cs

@@ -1,16 +1,11 @@
 namespace Azerion.BlueStack.API.Banner
 {
     /// <summary>
-    /// Anchoring mode for a banner ad. Top/Bottom snap the banner to a screen edge
-    /// (with optional safe-area respect); <see cref="Custom"/> uses an explicit screen-space
-    /// position supplied via <see cref="BannerAd.SetPosition(UnityEngine.Vector2)"/> or the
-    /// <c>Vector2</c> / anchor constructor.
+    /// Anchoring mode for a sticky banner ad: Top or Bottom snaps the banner to a screen edge
+    /// (with optional safe-area respect).
     /// </summary>
     public enum AdPosition
     {
-        /// <summary>Banner is positioned at an explicit screen-space coordinate. Ignores the safe area.</summary>
-        Custom = -1,
-
         /// <summary>Banner is anchored to the top of the screen.</summary>
         Top = 0,
 

package/Runtime/Common/BlueStackSdkInfo.cs

@@ -5,6 +5,6 @@ namespace Azerion.BlueStack.Common
 {
     public static class BlueStackSdkInfo
     {
-        public const string Version = "6.0.0-beta.3";
+        public const string Version = "6.0.0-beta.5";
     }
 }

package/Runtime/Platforms/Android/NativeAdClient.cs

@@ -30,21 +30,30 @@ namespace Azerion.BlueStack.Platforms.Android
         public void Create(string placementId)
         {
             _placementId = placementId;
-            _unityNativeAd.Call("create", placementId);
+            AndroidJavaObjectFactory.Instance.RunOnUiThread(() =>
+            {
+                _unityNativeAd.Call("create", placementId);
+            });
         }
 
         public void Load()
         {
             BlueStackLogger.Debug("NativeAd", "Load requested for " + _placementId);
-            _unityNativeAd.Call("load");
+            AndroidJavaObjectFactory.Instance.RunOnUiThread(() =>
+            {
+                _unityNativeAd.Call("load");
+            });
         }
 
         public void Load(RequestOptions options)
         {
             BlueStackLogger.Debug("NativeAd", "Load requested for " + _placementId);
-            using AndroidJavaObject unityOptions = RequestOptionsClient.CreateUnityRequestOptions(options);
-            using AndroidJavaObject sdkOptions = unityOptions.Call<AndroidJavaObject>("getRequestOptions");
-            _unityNativeAd.Call("load", sdkOptions);
+            AndroidJavaObjectFactory.Instance.RunOnUiThread(() =>
+            {
+                using AndroidJavaObject unityOptions = RequestOptionsClient.CreateUnityRequestOptions(options);
+                using AndroidJavaObject sdkOptions = unityOptions.Call<AndroidJavaObject>("getRequestOptions");
+                _unityNativeAd.Call("load", sdkOptions);
+            });
         }
         
         public string GetTitle()
@@ -91,18 +100,28 @@ namespace Azerion.BlueStack.Platforms.Android
 
         public void RecordImpression()
         {
-            _unityNativeAd.Call("recordImpression");
+            AndroidJavaObjectFactory.Instance.RunOnUiThread(() =>
+            {
+                _unityNativeAd.Call("recordImpression");
+            });
         }
-        
+
         public void PerformClick()
         {
-            _unityNativeAd.Call("performClick");
+            AndroidJavaObjectFactory.Instance.RunOnUiThread(() =>
+            {
+                _unityNativeAd.Call("performClick");
+            });
         }
         
         public void Destroy()
         {
             BlueStackLogger.Debug("NativeAd", "Destroy requested");
-            _unityNativeAd.Call("destroy");
+            AndroidJavaObjectFactory.Instance.RunOnUiThread(() =>
+            {
+                _unityNativeAd.Call("destroy");
+                _unityNativeAd.Dispose();
+            });
         }
 
         public void onNativeAdDidLoad()
@@ -130,7 +149,6 @@ namespace Azerion.BlueStack.Platforms.Android
         public void onNativeAdClose()
         {
             OnNativeAdClosed?.Invoke(this, EventArgs.Empty);
-            _unityNativeAd.Dispose();
         }
     }
 }

package/Runtime/Platforms/Unity/BannerAdClient.cs

@@ -15,6 +15,7 @@ namespace Azerion.BlueStack.Platforms.UnityEditor
     {
         private string _placementId;
         private AdPosition _adPosition;
+        private bool _isCustomPosition;
         private AdSize _adSize;
         private Vector2 _customPosition;
         private Rect _maskBounds;
@@ -54,6 +55,7 @@ namespace Azerion.BlueStack.Platforms.UnityEditor
             _placementId = placementId;
             _adSize = adSize;
             _adPosition = adPosition;
+            _isCustomPosition = false;
         }
 
         public void CreateBannerAd(string placementId, AdSize adSize, Vector2 adPosition)
@@ -61,7 +63,7 @@ namespace Azerion.BlueStack.Platforms.UnityEditor
             _placementId = placementId;
             _adSize = adSize;
             _customPosition = adPosition;
-            _adPosition = AdPosition.Custom;
+            _isCustomPosition = true;
         }
 
         public void Load()
@@ -169,6 +171,7 @@ namespace Azerion.BlueStack.Platforms.UnityEditor
         public void SetPosition(AdPosition adPosition)
         {
             _adPosition = adPosition;
+            _isCustomPosition = false;
             if (dummyAd == null)
             {
                 return;
@@ -179,7 +182,7 @@ namespace Azerion.BlueStack.Platforms.UnityEditor
         public void SetPosition(Vector2 adPosition)
         {
             _customPosition = adPosition;
-            _adPosition = AdPosition.Custom;
+            _isCustomPosition = true;
             if (dummyAd == null)
             {
                 return;
@@ -219,7 +222,7 @@ namespace Azerion.BlueStack.Platforms.UnityEditor
         private void PositionBannerContainer()
         {
             if (_bannerContainer == null) return;
-            if (_adPosition == AdPosition.Custom)
+            if (_isCustomPosition)
             {
                 AnchorBannerContainerToScreenPoint(_customPosition);
             }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "com.azerion.bluestack",
-  "version": "6.0.0-beta.3",
+  "version": "6.0.0-beta.5",
   "displayName": "BlueStack",
   "description": "BlueStack SDK has been designed to give developers options for showing Ads from different ad networks.",
   "unity": "2020.3",
   "documentationUrl": "https://developers.bluestack.app/unity",
-  "changelogUrl": "https://developers.bluestack.app/unity/changelog",
+  "changelogUrl": "https://developers.bluestack.app/unity/release-notes",
   "dependencies": {
     "com.google.external-dependency-manager": "1.2.187"
   },