Skip to main content

BlueStack SDK for Unity version 6

· 3 min read
Ale Bles
Ale Bles
BlueStack SDK Lead

BlueStack SDK for Unity version 6 is now available. This release brings the Unity plugin in line with BlueStack SDK v6 on both iOS and Android, updates all bundled adapter dependencies to their v6 counterparts, and unifies the public C# API surface across ad formats.

Aligning with the native SDK​

Until now the Unity plugin followed its own 3.x version line while the underlying native SDKs were on 5.x. Going forward, framework integration packages will follow the same major version scheme as the native SDK, so there is no ambiguity about which native SDK version a given plugin release targets.

That means the Unity plugin jumps from 3.4.1 straight to 6.0.0 to match the BlueStack iOS and Android Core SDKs.

What's New in v6​

Upgraded native cores​

  • Android: BlueStack Core SDK upgraded to 6.0.1
  • iOS: BlueStack Core SDK upgraded to 6.0.0
  • All mediation adapters (In-App Bidding, Google Mobile Ads, Equativ) bumped to their v6 counterparts on both platforms

A unified, simplified API surface​

BlueStackAds.Initialize no longer takes a Settings snapshot or two separate callbacks. The new shape is a single completion callback that delivers per-adapter InitializationStatus, with debug logging toggled independently:

BlueStackAds.SetDebugMode(true);
BlueStackAds.Initialize(appId, status =>
{
    foreach (var kv in status.AdapterStatusMap)
        Debug.Log($"Adapter {kv.Key}: {kv.Value.InitializationState}");
});

RewardedVideoAd has been renamed to RewardedAd, and the per-format ad events now follow a unified OnAd* naming convention (OnAdLoaded, OnAdFailedToLoad, OnAdDisplayed, OnAdDismissed, …). A project-wide find-and-replace covers most of the migration; the full event-rename tables live in the migration guide.

New banner controls​

  • BannerAd(string, Transform, Camera) — anchor-driven positioning that follows a UI or world-space transform automatically
  • BannerAd(string, Vector2) — custom screen-space positioning
  • useSafeArea: false opt-out for sticky Top/Bottom banners
  • BannerAd.SetMask(RectTransform, Camera) / RemoveMask() for clipping the banner to an animated UI region
  • OnAdResized event delivering a PreferredBannerSize when the SDK reports a post-load size change

What ships with the native v6 release​

Because the Unity plugin now sits on top of Core v6, your apps automatically benefit from the work that landed in the v6 native release. See the v6 native announcement for the full picture:

Upgrading​

Update Packages/manifest.json:

{
  "dependencies": {
    "com.azerion.bluestack": "6.0.0"
  }
}

Then force-resolve native dependencies:

  • Android: Assets > External Dependency Manager > Android Resolver > Force Resolve
  • iOS: after the next Unity export, run pod install --repo-update in the exported Xcode project

For a step-by-step walkthrough with full code examples and per-event migration tables, see the dedicated guide: Migrate from v3.x to v6.0.0.

Prerequisites​

  • Unity 2020 or higher
  • Android: minimum API level 21, target API 34 or higher, JDK 17+
  • iOS: 13.0+, Xcode 15.3+, CocoaPods

What about the 3.x line?​

The previous 3.x documentation remains available under the version dropdown for publishers who are not ready to upgrade yet.

We recommend moving to v6 at your earliest convenience to stay aligned with future native SDK releases.

See it in action​

Our public demo app showcases the BlueStack Unity SDK across banner, interstitial, rewarded, and native ad formats: azerion/bluestack-demo-unity.

If you run into any issues or have questions, please reach out to us.