arcadesindo-unityads-cordova 1.0.0

package/README.md

@@ -0,0 +1,38 @@
+# arcadesindo-unityads-cordova
+
+Standalone Unity Ads plugin for Cordova / Construct 3, built directly on the Unity LevelPlay SDK
+with **only the Unity Ads network adapter installed** -- no other mediated demand sources, and
+no dependency on any AdMob SDK or account. Ad requests never touch an AdMob pipeline, so this
+plugin's revenue is fully isolated from AdMob account-level enforcement.
+
+Companion Construct 3 addon: `Claude_UnityAds` (`.c3addon`).
+
+## Install
+
+```
+cordova plugin add arcadesindo-unityads-cordova
+```
+
+## Formats supported
+
+- Interstitial
+- Rewarded (with `rewardFailed` synthesized when the ad closes without a reward being earned)
+- Banner
+
+## Platforms
+
+- Android (Kotlin, `com.ironsource.mediationsdk` / LevelPlay Android SDK)
+- iOS (Swift, `IronSourceSDK` CocoaPod / LevelPlay iOS SDK)
+
+## Notes
+
+- Requires a LevelPlay App Key per platform, from the LevelPlay dashboard (platform.ironsrc.com)
+  -- not the same as a plain Unity Ads Monetize Game ID.
+- iOS build includes defensive `AVAudioSession` mitigations for the "game audio lost after
+  fullscreen ad" pattern (see `UAAudioSessionGuard.swift`). Best-effort, not a guarantee.
+- Some native class/method names should be re-verified against the exact LevelPlay SDK version
+  pinned in `plugin.xml` before your first production build.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "arcadesindo-unityads-cordova",
+    "version": "1.0.0",
+    "description": "Standalone Unity Ads plugin for Cordova, built on the Unity LevelPlay SDK with the Unity Ads network adapter only (no other mediated demand sources, fully isolated from any AdMob SDK/account in the same app).",
+    "cordova": {
+        "id": "arcadesindo-unityads-cordova",
+        "platforms": [
+            "android",
+            "ios"
+        ]
+    },
+    "keywords": [
+        "cordova",
+        "ecosystem:cordova",
+        "cordova-android",
+        "cordova-ios",
+        "unity",
+        "unityads",
+        "levelplay",
+        "ironsource",
+        "ads",
+        "monetization",
+        "interstitial",
+        "rewarded",
+        "banner"
+    ],
+    "author": "Arcadesindo Games",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/arcadesindo/arcadesindo-unityads-cordova.git"
+    },
+    "bugs": {
+        "url": "https://github.com/arcadesindo/arcadesindo-unityads-cordova/issues"
+    },
+    "engines": [
+        {
+            "name": "cordova",
+            "version": ">=9.0.0"
+        }
+    ],
+    "files": [
+        "src",
+        "www",
+        "plugin.xml",
+        "README.md"
+    ]
+}

package/plugin.xml

@@ -0,0 +1,102 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+        id="arcadesindo-unityads-cordova"
+        version="1.0.0">
+
+    <name>ArcadesindoUnityAds</name>
+    <description>
+        Standalone Unity Ads plugin for Cordova/Construct 3, built on the Unity LevelPlay SDK
+        with the Unity Ads network adapter only (no other mediated demand sources, no AdMob
+        pipeline). Fully isolated from any AdMob SDK/account in the same app.
+    </description>
+    <license>MIT</license>
+    <keywords>cordova,unity,levelplay,ads,interstitial,rewarded,banner</keywords>
+
+    <js-module src="www/ArcadesindoUnityAds.js" name="ArcadesindoUnityAds">
+        <clobbers target="cordova.plugins.ArcadesindoUnityAds" />
+    </js-module>
+
+    <!-- ============================== ANDROID ============================== -->
+    <platform name="android">
+        <config-file target="config.xml" parent="/*">
+            <feature name="ArcadesindoUnityAds">
+                <param name="android-package" value="com.arcadesindo.unityads.ArcadesindoUnityAds" />
+            </feature>
+        </config-file>
+
+        <config-file target="AndroidManifest.xml" parent="/manifest">
+            <!-- Required since LevelPlay SDK 4.1+ auto-declares AD_ID, kept explicit for older adapters -->
+            <uses-permission android:name="com.google.android.gms.permission.AD_ID" />
+        </config-file>
+
+        <source-file src="src/android/ArcadesindoUnityAds.kt" target-dir="src/com/arcadesindo/unityads" />
+        <source-file src="src/android/UAInterstitial.kt" target-dir="src/com/arcadesindo/unityads" />
+        <source-file src="src/android/UARewarded.kt" target-dir="src/com/arcadesindo/unityads" />
+        <source-file src="src/android/UABanner.kt" target-dir="src/com/arcadesindo/unityads" />
+        <source-file src="src/android/UAConsent.kt" target-dir="src/com/arcadesindo/unityads" />
+
+        <!-- LevelPlay core SDK -->
+        <framework src="com.unity3d.ads-mediation:mediation-sdk:9.5.0" />
+        <!-- Unity Ads network adapter for LevelPlay -- ONLY adapter installed, by design -->
+        <framework src="com.unity3d.ads-mediation:unityads-adapter:5.8.1" />
+        <!-- Kotlin stdlib required by both LevelPlay core and Unity Ads network SDK -->
+        <framework src="org.jetbrains.kotlin:kotlin-stdlib:2.1.0" />
+
+        <config-file target="AndroidManifest.xml" parent="/manifest/application">
+            <!-- placeholder: android:networkSecurityConfig etc. handled by app itself if needed -->
+        </config-file>
+    </platform>
+
+    <!-- ================================ iOS ================================ -->
+    <platform name="ios">
+        <config-file target="config.xml" parent="/*">
+            <feature name="ArcadesindoUnityAds">
+                <param name="ios-package" value="ArcadesindoUnityAds" />
+            </feature>
+        </config-file>
+
+        <source-file src="src/ios/ArcadesindoUnityAds.swift" />
+        <source-file src="src/ios/UAInterstitial.swift" />
+        <source-file src="src/ios/UARewarded.swift" />
+        <source-file src="src/ios/UABanner.swift" />
+        <source-file src="src/ios/UAConsent.swift" />
+        <source-file src="src/ios/UAAudioSessionGuard.swift" />
+
+        <!-- LevelPlay core SDK (still literally "IronSourceSDK" upstream) -->
+        <podspec>
+            <config>
+                <source url="https://cdn.cocoapods.org/" />
+            </config>
+            <pods use-frameworks="true">
+                <pod name="IronSourceSDK" spec="9.5.0.0" />
+                <!-- Unity Ads network adapter for LevelPlay -- ONLY adapter installed, by design -->
+                <pod name="IronSourceUnityAdsAdapter" spec="~> 5.8.1" />
+            </pods>
+        </podspec>
+
+        <config-file target="*-Info.plist" parent="NSAppTransportSecurity">
+            <dict>
+                <key>NSAllowsArbitraryLoads</key>
+                <true/>
+            </dict>
+        </config-file>
+
+        <config-file target="*-Info.plist" parent="SKAdNetworkItems">
+            <array>
+                <dict>
+                    <key>SKAdNetworkIdentifier</key>
+                    <string>su67r6k2v3.skadnetwork</string>
+                </dict>
+            </array>
+        </config-file>
+
+        <!-- Required so background/foreground audio-session reset notifications are observed
+             from plugin init, per brief section 4 mitigation -->
+        <config-file target="*-Info.plist" parent="UIBackgroundModes">
+            <array>
+                <string>audio</string>
+            </array>
+        </config-file>
+    </platform>
+
+</plugin>

package/src/android/ArcadesindoUnityAds.kt

@@ -0,0 +1,155 @@
+package com.arcadesindo.unityads
+
+import android.media.AudioManager
+import android.os.SystemClock
+import org.apache.cordova.CallbackContext
+import org.apache.cordova.CordovaPlugin
+import org.apache.cordova.PluginResult
+import org.json.JSONObject
+import com.ironsource.mediationsdk.IronSource
+import com.ironsource.mediationsdk.IronSource.AD_UNIT
+import com.ironsource.mediationsdk.logger.IronSourceError
+
+/**
+ * Main Cordova bridge. Delegates per-format logic to UAInterstitial / UARewarded / UABanner
+ * so each ad format lives in its own file (mirrors the Claude_AdMob native plugin pattern).
+ *
+ * NOTE ON SDK SURFACE: this file targets the LevelPlay Android SDK (package com.ironsource.*,
+ * still literally "IronSource" under the hood -- see project notes). The exact class/method
+ * names below (IronSource.init, IronSource.loadInterstitial, listener interfaces, etc.) follow
+ * the long-documented IronSource Android API and should be re-verified against whichever
+ * mediation-sdk version is pinned in plugin.xml before first build, since LevelPlay has been
+ * migrating some APIs to newer LevelPlayInterstitialAd-style classes.
+ */
+class ArcadesindoUnityAds : CordovaPlugin() {
+
+    companion object {
+        const val TAG = "ArcadesindoUnityAds"
+    }
+
+    /** Single persistent listener callback -- events are pushed to it with keepCallback=true. */
+    private var listenerCallback: CallbackContext? = null
+
+    override fun execute(
+        action: String,
+        args: org.json.JSONArray,
+        callbackContext: CallbackContext
+    ): Boolean {
+        when (action) {
+            "initialize" -> initialize(args.optJSONObject(0) ?: JSONObject(), callbackContext)
+            "setAdListener" -> {
+                listenerCallback = callbackContext
+                // Keep the JS promise pending forever; events pushed via emitEvent().
+                val result = PluginResult(PluginResult.Status.NO_RESULT)
+                result.keepCallback = true
+                callbackContext.sendPluginResult(result)
+            }
+
+            "loadInterstitial" -> UAInterstitial.load(callbackContext, ::emitEvent)
+            "showInterstitial" -> UAInterstitial.show(cordova.activity, callbackContext)
+            "isInterstitialReady" -> UAInterstitial.isReady(callbackContext)
+
+            "loadRewarded" -> UARewarded.load(callbackContext, ::emitEvent)
+            "showRewarded" -> UARewarded.show(cordova.activity, callbackContext)
+            "isRewardedReady" -> UARewarded.isReady(callbackContext)
+
+            "loadBanner" -> UABanner.load(
+                cordova.activity, args.optJSONObject(0) ?: JSONObject(), callbackContext, ::emitEvent
+            )
+            "showBanner" -> UABanner.show(callbackContext)
+            "hideBanner" -> UABanner.hide(callbackContext)
+            "destroyBanner" -> UABanner.destroy(callbackContext)
+
+            "setConsent" -> UAConsent.setConsent(args.optBoolean(0), callbackContext)
+            "setDoNotSell" -> UAConsent.setDoNotSell(args.optBoolean(0), callbackContext)
+            "setChildDirected" -> UAConsent.setChildDirected(args.optBoolean(0), callbackContext)
+
+            "getAudioDiagnostics" -> getAudioDiagnostics(callbackContext)
+
+            else -> return false
+        }
+        return true
+    }
+
+    // ---- init --------------------------------------------------------------------------
+
+    private fun initialize(options: JSONObject, callbackContext: CallbackContext) {
+        val appKey = options.optString("appKey", "")
+        if (appKey.isEmpty()) {
+            callbackContext.error("appKey is required")
+            return
+        }
+
+        val activity = cordova.activity
+
+        // Register per-format listeners once, before init, per LevelPlay docs guidance.
+        UAInterstitial.registerListener(::emitEvent)
+        UARewarded.registerListener(::emitEvent)
+        UABanner.registerListener(::emitEvent)
+
+        // NOTE: init signature/ad-unit selection to verify against pinned SDK version --
+        // some LevelPlay versions accept AD_UNIT varargs to scope which formats initialize.
+        IronSource.setISDemandOnlyInterstitialListener(null) // ensure demand-only mode is off
+        IronSource.init(
+            activity,
+            appKey,
+            AD_UNIT.INTERSTITIAL,
+            AD_UNIT.REWARDED_VIDEO,
+            AD_UNIT.BANNER
+        )
+
+        if (options.optBoolean("isTesting", false)) {
+            // Test-ad mode: verify current flag name against SDK version at build time.
+            IronSource.setMetaData("is_test_suite", "enable")
+        }
+
+        val userId = options.optString("userId", "")
+        if (userId.isNotEmpty()) {
+            IronSource.setDynamicUserId(userId)
+        }
+
+        callbackContext.success()
+    }
+
+    // ---- event fan-out -------------------------------------------------------------------
+
+    /**
+     * Pushes a single ad lifecycle event to the JS listener registered via setAdListener().
+     * format: "interstitial" | "rewarded" | "banner"
+     * event:  "load" | "loadFailed" | "show" | "showFailed" | "click" | "dismiss"
+     *         | "rewarded" | "rewardFailed"
+     */
+    fun emitEvent(format: String, event: String, data: JSONObject = JSONObject()) {
+        val payload = JSONObject()
+        payload.put("format", format)
+        payload.put("event", event)
+        payload.put("data", data)
+
+        val cb = listenerCallback ?: return
+        val result = PluginResult(PluginResult.Status.OK, payload)
+        result.keepCallback = true
+        cb.sendPluginResult(result)
+    }
+
+    // ---- lifecycle passthrough (LevelPlay recommends forwarding these) ---------------------
+
+    override fun onResume(multitasking: Boolean) {
+        super.onResume(multitasking)
+        IronSource.onResume(cordova.activity)
+    }
+
+    override fun onPause(multitasking: Boolean) {
+        super.onPause(multitasking)
+        IronSource.onPause(cordova.activity)
+    }
+
+    // ---- diagnostics (brief section 4: instrumentation for the AdMob audio-loss bug) ------
+
+    private fun getAudioDiagnostics(callbackContext: CallbackContext) {
+        val payload = JSONObject()
+        payload.put("elapsedRealtimeMs", SystemClock.elapsedRealtime())
+        val am = cordova.activity.getSystemService(android.content.Context.AUDIO_SERVICE) as AudioManager
+        payload.put("isMusicActive", am.isMusicActive)
+        callbackContext.success(payload)
+    }
+}

package/src/android/UABanner.kt

@@ -0,0 +1,87 @@
+package com.arcadesindo.unityads
+
+import android.app.Activity
+import android.view.Gravity
+import android.widget.FrameLayout
+import org.apache.cordova.CallbackContext
+import org.json.JSONObject
+import com.ironsource.mediationsdk.IronSource
+import com.ironsource.mediationsdk.logger.IronSourceError
+import com.ironsource.mediationsdk.sdk.BannerListener
+import com.ironsource.mediationsdk.model.IronSourceBannerLayout
+import com.ironsource.mediationsdk.ISBannerSize
+
+object UABanner {
+
+    private var emit: ((String, String, JSONObject) -> Unit)? = null
+    private var bannerView: IronSourceBannerLayout? = null
+
+    fun registerListener(emitter: (String, String, JSONObject) -> Unit) {
+        emit = emitter
+    }
+
+    fun load(
+        activity: Activity,
+        options: JSONObject,
+        callbackContext: CallbackContext,
+        emitter: (String, String, JSONObject) -> Unit
+    ) {
+        emit = emitter
+        destroyInternal()
+
+        val banner = IronSource.createBanner(activity, ISBannerSize.BANNER)
+        bannerView = banner
+
+        banner.setBannerListener(object : BannerListener {
+            override fun onBannerAdLoaded() = emit?.invoke("banner", "load", JSONObject()) ?: Unit
+            override fun onBannerAdLoadFailed(error: IronSourceError) =
+                emit?.invoke("banner", "loadFailed", errorPayload(error)) ?: Unit
+            override fun onBannerAdClicked() = emit?.invoke("banner", "click", JSONObject()) ?: Unit
+            override fun onBannerAdScreenPresented() = Unit
+            override fun onBannerAdScreenDismissed() = Unit
+            override fun onBannerAdLeftApplication() = Unit
+        })
+
+        val position = options.optString("position", "bottom")
+        val gravity = if (position == "top") Gravity.TOP or Gravity.CENTER_HORIZONTAL
+                      else Gravity.BOTTOM or Gravity.CENTER_HORIZONTAL
+
+        val params = FrameLayout.LayoutParams(
+            FrameLayout.LayoutParams.WRAP_CONTENT,
+            FrameLayout.LayoutParams.WRAP_CONTENT,
+            gravity
+        )
+        activity.addContentView(banner, params)
+        banner.visibility = android.view.View.GONE
+
+        IronSource.loadBanner(banner)
+        callbackContext.success()
+    }
+
+    fun show(callbackContext: CallbackContext) {
+        bannerView?.visibility = android.view.View.VISIBLE
+        callbackContext.success()
+    }
+
+    fun hide(callbackContext: CallbackContext) {
+        bannerView?.visibility = android.view.View.GONE
+        callbackContext.success()
+    }
+
+    fun destroy(callbackContext: CallbackContext) {
+        destroyInternal()
+        callbackContext.success()
+    }
+
+    private fun destroyInternal() {
+        bannerView?.let { IronSource.destroyBanner(it) }
+        bannerView = null
+    }
+
+    private fun errorPayload(error: IronSourceError): JSONObject {
+        val o = JSONObject()
+        o.put("code", error.errorCode)
+        o.put("message", error.errorMessage)
+        return o
+    }
+}

package/src/android/UAConsent.kt

@@ -0,0 +1,30 @@
+package com.arcadesindo.unityads
+
+import org.apache.cordova.CallbackContext
+import com.ironsource.mediationsdk.IronSource
+
+/**
+ * GDPR / CCPA / COPPA regulation settings. LevelPlay's setConsent() fans the choice out to
+ * every mediated network that supports a consent API -- for us that's just the Unity Ads
+ * adapter, since it's the only adapter installed (see plugin.xml).
+ */
+object UAConsent {
+
+    fun setConsent(consent: Boolean, callbackContext: CallbackContext) {
+        IronSource.setConsent(consent)
+        callbackContext.success()
+    }
+
+    fun setDoNotSell(value: Boolean, callbackContext: CallbackContext) {
+        IronSource.setMetaData("do_not_sell", if (value) "YES" else "NO")
+        callbackContext.success()
+    }
+
+    fun setChildDirected(value: Boolean, callbackContext: CallbackContext) {
+        // NOTE: verify exact flag/value semantics against SDK version + brief's earlier finding
+        // that "mixed"/"targeted" values were reported unreliable by some developers -- test
+        // thoroughly before relying on this for compliance.
+        IronSource.setMetaData("is_child_directed", if (value) "true" else "false")
+        callbackContext.success()
+    }
+}

package/src/android/UAInterstitial.kt

@@ -0,0 +1,80 @@
+package com.arcadesindo.unityads
+
+import android.app.Activity
+import org.apache.cordova.CallbackContext
+import org.json.JSONObject
+import com.ironsource.mediationsdk.IronSource
+import com.ironsource.mediationsdk.sdk.ISDemandOnlyInterstitialListener
+import com.ironsource.mediationsdk.logger.IronSourceError
+
+/** Interstitial ad format -- split into its own file per brief 3B convention. */
+object UAInterstitial {
+
+    private var emit: ((String, String, JSONObject) -> Unit)? = null
+    private var ready = false
+
+    fun registerListener(emitter: (String, String, JSONObject) -> Unit) {
+        emit = emitter
+        // NOTE: verify listener interface name against pinned SDK version --
+        // newer LevelPlay versions favor per-instance LevelPlayInterstitialAdListener.
+        IronSource.setInterstitialListener(object : com.ironsource.mediationsdk.sdk.InterstitialListener {
+            override fun onInterstitialAdReady() {
+                ready = true
+                emit?.invoke("interstitial", "load", JSONObject())
+            }
+
+            override fun onInterstitialAdLoadFailed(error: IronSourceError) {
+                ready = false
+                emit?.invoke("interstitial", "loadFailed", errorPayload(error))
+            }
+
+            override fun onInterstitialAdShowSucceeded() {
+                emit?.invoke("interstitial", "show", JSONObject())
+            }
+
+            override fun onInterstitialAdShowFailed(error: IronSourceError) {
+                ready = false
+                emit?.invoke("interstitial", "showFailed", errorPayload(error))
+            }
+
+            override fun onInterstitialAdClicked() {
+                emit?.invoke("interstitial", "click", JSONObject())
+            }
+
+            override fun onInterstitialAdOpened() { /* no-op, mirrors "show" */ }
+
+            override fun onInterstitialAdClosed() {
+                ready = false
+                emit?.invoke("interstitial", "dismiss", JSONObject())
+                // Proactively load the next one so isReady stays useful.
+                IronSource.loadInterstitial()
+            }
+        })
+    }
+
+    fun load(callbackContext: CallbackContext, emitter: (String, String, JSONObject) -> Unit) {
+        emit = emitter
+        IronSource.loadInterstitial()
+        callbackContext.success()
+    }
+
+    fun show(activity: Activity, callbackContext: CallbackContext) {
+        if (!IronSource.isInterstitialReady()) {
+            callbackContext.error("Interstitial not ready")
+            return
+        }
+        IronSource.showInterstitial()
+        callbackContext.success()
+    }
+
+    fun isReady(callbackContext: CallbackContext) {
+        callbackContext.success(if (IronSource.isInterstitialReady()) 1 else 0)
+    }
+
+    private fun errorPayload(error: IronSourceError): JSONObject {
+        val o = JSONObject()
+        o.put("code", error.errorCode)
+        o.put("message", error.errorMessage)
+        return o
+    }
+}

package/src/android/UARewarded.kt

@@ -0,0 +1,100 @@
+package com.arcadesindo.unityads
+
+import android.app.Activity
+import org.apache.cordova.CallbackContext
+import org.json.JSONObject
+import com.ironsource.mediationsdk.IronSource
+import com.ironsource.mediationsdk.logger.IronSourceError
+import com.ironsource.mediationsdk.model.Placement
+
+/**
+ * Rewarded ad format. Synthesizes a "rewardFailed" event when the ad is dismissed WITHOUT a
+ * prior "rewarded" event having fired -- exactly the pattern called out in brief 3B so we don't
+ * have to retrofit it later like Claude_AdMob did.
+ */
+object UARewarded {
+
+    private var emit: ((String, String, JSONObject) -> Unit)? = null
+    private var earnedThisSession = false
+
+    fun registerListener(emitter: (String, String, JSONObject) -> Unit) {
+        emit = emitter
+        // NOTE: verify against pinned SDK version -- newer LevelPlay favors
+        // LevelPlayRewardedAdListener with an AdInfo-based per-instance API.
+        IronSource.setLevelPlayRewardedVideoListener(object : com.ironsource.mediationsdk.sdk.LevelPlayRewardedVideoListener {
+            override fun onAdAvailable(adInfo: com.ironsource.mediationsdk.adunit.adapter.utility.AdInfo) {
+                emit?.invoke("rewarded", "load", JSONObject())
+            }
+
+            override fun onAdUnavailable() {
+                emit?.invoke("rewarded", "loadFailed", JSONObject())
+            }
+
+            override fun onAdOpened(adInfo: com.ironsource.mediationsdk.adunit.adapter.utility.AdInfo) {
+                earnedThisSession = false
+                emit?.invoke("rewarded", "show", JSONObject())
+            }
+
+            override fun onAdShowFailed(
+                error: IronSourceError,
+                adInfo: com.ironsource.mediationsdk.adunit.adapter.utility.AdInfo
+            ) {
+                emit?.invoke("rewarded", "showFailed", errorPayload(error))
+            }
+
+            override fun onAdRewarded(
+                placement: Placement,
+                adInfo: com.ironsource.mediationsdk.adunit.adapter.utility.AdInfo
+            ) {
+                earnedThisSession = true
+                val o = JSONObject()
+                o.put("placementName", placement.placementName)
+                o.put("rewardAmount", placement.rewardAmount)
+                o.put("rewardName", placement.rewardName)
+                emit?.invoke("rewarded", "rewarded", o)
+            }
+
+            override fun onAdClicked(
+                placement: Placement,
+                adInfo: com.ironsource.mediationsdk.adunit.adapter.utility.AdInfo
+            ) {
+                emit?.invoke("rewarded", "click", JSONObject())
+            }
+
+            override fun onAdClosed(adInfo: com.ironsource.mediationsdk.adunit.adapter.utility.AdInfo) {
+                if (!earnedThisSession) {
+                    // Synthesized -- player closed the ad before earning a reward.
+                    emit?.invoke("rewarded", "rewardFailed", JSONObject())
+                }
+                emit?.invoke("rewarded", "dismiss", JSONObject())
+            }
+        })
+    }
+
+    fun load(callbackContext: CallbackContext, emitter: (String, String, JSONObject) -> Unit) {
+        emit = emitter
+        // Rewarded video in classic IronSource API auto-loads; nothing to trigger explicitly,
+        // but we still ack the JS call so the promise resolves.
+        callbackContext.success()
+    }
+
+    fun show(activity: Activity, callbackContext: CallbackContext) {
+        if (!IronSource.isRewardedVideoAvailable()) {
+            callbackContext.error("Rewarded not ready")
+            return
+        }
+        IronSource.showRewardedVideo()
+        callbackContext.success()
+    }
+
+    fun isReady(callbackContext: CallbackContext) {
+        callbackContext.success(if (IronSource.isRewardedVideoAvailable()) 1 else 0)
+    }
+
+    private fun errorPayload(error: IronSourceError): JSONObject {
+        val o = JSONObject()
+        o.put("code", error.errorCode)
+        o.put("message", error.errorMessage)
+        return o
+    }
+}

package/src/ios/ArcadesindoUnityAds.swift

@@ -0,0 +1,145 @@
+import Foundation
+
+/**
+ Main Cordova bridge (iOS). Delegates per-format logic to UAInterstitial / UARewarded / UABanner,
+ mirroring the Android split and the Claude_AdMob native plugin convention (brief 3B).
+
+ NOTE ON SDK SURFACE: targets the LevelPlay iOS SDK (CocoaPod `IronSourceSDK`, header
+ `IronSource/IronSource.h` -- still literally IronSource under the hood, see project notes).
+ The exact class/method names below follow the long-documented classic `IronSource` static API
+ (IronSource.loadInterstitial(), IronSource.showInterstitial(with:), delegate protocols) for
+ consistency with the Android side. Re-verify against the exact IronSourceSDK version pinned in
+ plugin.xml before first build -- newer LevelPlay releases are migrating some formats to
+ `LPMInterstitialAd`-style per-instance classes.
+ */
+@objc(ArcadesindoUnityAds)
+class ArcadesindoUnityAds: CDVPlugin {
+
+    /// Command callback ID for the single persistent event listener.
+    var listenerCallbackId: String?
+
+    override func pluginInitialize() {
+        super.pluginInitialize()
+        // Audio-session mitigations must be wired up at plugin init, not lazily on first ad --
+        // see brief section 4.
+        UAAudioSessionGuard.shared.install()
+    }
+
+    // MARK: - lifecycle
+
+    @objc(initialize:)
+    func initialize(_ command: CDVInvokedUrlCommand) {
+        guard let options = command.argument(at: 0) as? [String: Any],
+              let appKey = options["appKey"] as? String, !appKey.isEmpty else {
+            send(command, error: "appKey is required")
+            return
+        }
+
+        UAInterstitial.shared.registerListener(emit: emitEvent)
+        UARewarded.shared.registerListener(emit: emitEvent)
+        UABanner.shared.registerListener(emit: emitEvent)
+
+        // NOTE: verify init entry point against pinned SDK version -- some releases expose
+        // `IronSource.initWithAppKey(_:adUnits:)`, others `LevelPlay.initWith(_:completion:)`
+        // via LPMInitRequestBuilder. Using the classic entry point here for parity with Android.
+        IronSource.initWithAppKey(appKey, adUnits: [IronSourceAdUnitsAdapter.interstitial, .rewardedVideo, .banner])
+
+        if (options["isTesting"] as? Bool) == true {
+            IronSource.setMetaDataWithKey("is_test_suite", value: "enable")
+        }
+        if let userId = options["userId"] as? String, !userId.isEmpty {
+            IronSource.setDynamicUserId(userId)
+        }
+
+        send(command, success: true)
+    }
+
+    @objc(setAdListener:)
+    func setAdListener(_ command: CDVInvokedUrlCommand) {
+        listenerCallbackId = command.callbackId
+        let result = CDVPluginResult(status: CDVCommandStatus_NO_RESULT)
+        result?.setKeepCallbackAs(true)
+        commandDelegate.send(result, callbackId: command.callbackId)
+    }
+
+    // MARK: - dispatch helpers used by format files
+
+    func emitEvent(format: String, event: String, data: [String: Any] = [:]) {
+        guard let callbackId = listenerCallbackId else { return }
+        let payload: [String: Any] = ["format": format, "event": event, "data": data]
+        let result = CDVPluginResult(status: CDVCommandStatus_OK, messageAs: payload)
+        result?.setKeepCallbackAs(true)
+        commandDelegate.send(result, callbackId: callbackId)
+    }
+
+    func send(_ command: CDVInvokedUrlCommand, success: Bool = true, payload: Any? = nil, error: String? = nil) {
+        let result: CDVPluginResult
+        if let error = error {
+            result = CDVPluginResult(status: CDVCommandStatus_ERROR, messageAs: error)
+        } else if let payload = payload {
+            result = CDVPluginResult(status: CDVCommandStatus_OK, messageAs: payload)
+        } else {
+            result = CDVPluginResult(status: success ? CDVCommandStatus_OK : CDVCommandStatus_ERROR)
+        }
+        commandDelegate.send(result, callbackId: command.callbackId)
+    }
+
+    // MARK: - format entry points (thin forwards, actual logic lives in UAInterstitial etc.)
+
+    @objc(loadInterstitial:)
+    func loadInterstitial(_ command: CDVInvokedUrlCommand) { UAInterstitial.shared.load(command, plugin: self) }
+
+    @objc(showInterstitial:)
+    func showInterstitial(_ command: CDVInvokedUrlCommand) { UAInterstitial.shared.show(command, plugin: self) }
+
+    @objc(isInterstitialReady:)
+    func isInterstitialReady(_ command: CDVInvokedUrlCommand) { UAInterstitial.shared.isReady(command, plugin: self) }
+
+    @objc(loadRewarded:)
+    func loadRewarded(_ command: CDVInvokedUrlCommand) { UARewarded.shared.load(command, plugin: self) }
+
+    @objc(showRewarded:)
+    func showRewarded(_ command: CDVInvokedUrlCommand) { UARewarded.shared.show(command, plugin: self) }
+
+    @objc(isRewardedReady:)
+    func isRewardedReady(_ command: CDVInvokedUrlCommand) { UARewarded.shared.isReady(command, plugin: self) }
+
+    @objc(loadBanner:)
+    func loadBanner(_ command: CDVInvokedUrlCommand) { UABanner.shared.load(command, plugin: self) }
+
+    @objc(showBanner:)
+    func showBanner(_ command: CDVInvokedUrlCommand) { UABanner.shared.show(command, plugin: self) }
+
+    @objc(hideBanner:)
+    func hideBanner(_ command: CDVInvokedUrlCommand) { UABanner.shared.hide(command, plugin: self) }
+
+    @objc(destroyBanner:)
+    func destroyBanner(_ command: CDVInvokedUrlCommand) { UABanner.shared.destroy(command, plugin: self) }
+
+    @objc(setConsent:)
+    func setConsent(_ command: CDVInvokedUrlCommand) {
+        let consent = (command.argument(at: 0) as? Bool) ?? false
+        IronSource.setConsent(consent)
+        send(command, success: true)
+    }
+
+    @objc(setDoNotSell:)
+    func setDoNotSell(_ command: CDVInvokedUrlCommand) {
+        let value = (command.argument(at: 0) as? Bool) ?? false
+        IronSource.setMetaDataWithKey("do_not_sell", value: value ? "YES" : "NO")
+        send(command, success: true)
+    }
+
+    @objc(setChildDirected:)
+    func setChildDirected(_ command: CDVInvokedUrlCommand) {
+        let value = (command.argument(at: 0) as? Bool) ?? false
+        // NOTE: same reliability caveat as Android -- verify against current SDK docs/testing.
+        IronSource.setMetaDataWithKey("is_child_directed", value: value ? "true" : "false")
+        send(command, success: true)
+    }
+
+    @objc(getAudioDiagnostics:)
+    func getAudioDiagnostics(_ command: CDVInvokedUrlCommand) {
+        send(command, payload: UAAudioSessionGuard.shared.diagnosticsSnapshot())
+    }
+}

package/src/ios/UAAudioSessionGuard.swift

@@ -0,0 +1,83 @@
+import Foundation
+import AVFoundation
+
+/**
+ Defensive mitigations for the "game audio lost after fullscreen ad on iOS" pattern that hit
+ Claude_AdMob (root cause still unconfirmed at the time this was written). Unity Ads/LevelPlay
+ also presents a native fullscreen ad view over the WKWebView, so the same failure mode is
+ plausible here too. These are best-effort preventions, NOT a guaranteed fix -- see brief
+ section 4, point 5.
+
+ Applied from plugin init (not lazily on first ad), per brief instruction.
+ */
+final class UAAudioSessionGuard {
+
+    static let shared = UAAudioSessionGuard()
+    private init() {}
+
+    private var installed = false
+    private var lastKnownCurrentTime: TimeInterval = 0
+
+    func install() {
+        guard !installed else { return }
+        installed = true
+
+        configureSessionForAppManagedPlayback()
+
+        // 1. Observe media-services-reset -- iOS can silently reset the whole audio subsystem;
+        //    without this, session category/activation state is lost with no other signal.
+        NotificationCenter.default.addObserver(
+            self,
+            selector: #selector(handleMediaServicesReset),
+            name: AVAudioSession.mediaServicesWereResetNotification,
+            object: nil
+        )
+
+        // NOTE: if the Unity Ads / LevelPlay SDK exposes an equivalent of AdMob's
+        // `isAudioSessionApplicationManaged`, set it here so the SDK does not fight the app
+        // for control of AVAudioSession. As of this writing no such flag was confirmed in
+        // LevelPlay's public iOS docs -- verify against the current SDK reference and, if
+        // found, wire it in before first release.
+    }
+
+    private func configureSessionForAppManagedPlayback() {
+        let session = AVAudioSession.sharedInstance()
+        do {
+            // .playback (not .ambient) -- .ambient was a contributing factor in the
+            // Claude_AdMob investigation.
+            try session.setCategory(.playback, options: [.mixWithOthers])
+            try session.setActive(true)
+        } catch {
+            NSLog("[ArcadesindoUnityAds] AVAudioSession configure failed: \(error)")
+        }
+    }
+
+    @objc private func handleMediaServicesReset() {
+        NSLog("[ArcadesindoUnityAds] AVAudioSession media services were reset -- reconfiguring")
+        configureSessionForAppManagedPlayback()
+    }
+
+    /// Call from the ad's dismiss delegate callback (mirrors AdMob's
+    /// `adDidDismissFullScreenContent` pattern) to reassert session state after the SDK's own
+    /// fullscreen ad view tears down.
+    func reactivateAfterAdDismiss() {
+        configureSessionForAppManagedPlayback()
+    }
+
+    // MARK: - diagnostics (brief 4.5: instrumentation so a recurrence is fast to investigate)
+
+    /// currentTime delta polling snapshot, same technique used to diagnose the Claude_AdMob bug.
+    func diagnosticsSnapshot() -> [String: Any] {
+        let session = AVAudioSession.sharedInstance()
+        let now = ProcessInfo.processInfo.systemUptime
+        let delta = now - lastKnownCurrentTime
+        lastKnownCurrentTime = now
+        return [
+            "systemUptime": now,
+            "deltaSinceLastSnapshot": delta,
+            "sessionCategory": session.category.rawValue,
+            "isOtherAudioPlaying": session.isOtherAudioPlaying,
+            "outputVolume": session.outputVolume
+        ]
+    }
+}

package/src/ios/UABanner.swift

@@ -0,0 +1,72 @@
+import Foundation
+
+final class UABanner: NSObject {
+
+    static let shared = UABanner()
+    private override init() {}
+
+    private var emit: ((String, String, [String: Any]) -> Void)?
+    private var bannerView: ISBannerView?
+
+    func registerListener(emit: @escaping (String, String, [String: Any]) -> Void) {
+        self.emit = emit
+    }
+
+    func load(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        let options = command.argument(at: 0) as? [String: Any] ?? [:]
+        let position = options["position"] as? String ?? "bottom"
+
+        destroyInternal()
+
+        let banner = IronSource.createBanner(with: .BANNER, viewController: plugin.viewController)
+        bannerView = banner
+        banner?.delegate = self
+        banner?.isHidden = true
+
+        if let banner = banner, let view = plugin.viewController.view {
+            view.addSubview(banner)
+            banner.translatesAutoresizingMaskIntoConstraints = false
+            NSLayoutConstraint.activate([
+                banner.centerXAnchor.constraint(equalTo: view.centerXAnchor),
+                position == "top"
+                    ? banner.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor)
+                    : banner.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)
+            ])
+        }
+
+        IronSource.loadBanner(with: banner)
+        plugin.send(command, success: true)
+    }
+
+    func show(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        bannerView?.isHidden = false
+        plugin.send(command, success: true)
+    }
+
+    func hide(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        bannerView?.isHidden = true
+        plugin.send(command, success: true)
+    }
+
+    func destroy(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        destroyInternal()
+        plugin.send(command, success: true)
+    }
+
+    private func destroyInternal() {
+        bannerView?.removeFromSuperview()
+        bannerView = nil
+    }
+}
+
+extension UABanner: ISBannerDelegate {
+    func bannerDidLoad(_ bannerView: ISBannerView!) { emit?("banner", "load", [:]) }
+    func bannerDidFailToLoadWithError(_ error: Error!) {
+        let nsError = error as NSError
+        emit?("banner", "loadFailed", ["code": nsError.code, "message": nsError.localizedDescription])
+    }
+    func didClickBanner() { emit?("banner", "click", [:]) }
+    func bannerWillPresentScreen() {}
+    func bannerDidDismissScreen() {}
+    func bannerWillLeaveApplication() {}
+}

package/src/ios/UAConsent.swift

@@ -0,0 +1,7 @@
+import Foundation
+
+/// Placeholder file kept in sync with UAConsent.kt on Android. All three consent methods
+/// (setConsent / setDoNotSell / setChildDirected) are currently implemented directly in
+/// ArcadesindoUnityAds.swift for brevity -- moved here if the consent logic grows
+/// (e.g. per-network granular consent map, TCF string passthrough).
+enum UAConsent {}

package/src/ios/UAInterstitial.swift

@@ -0,0 +1,75 @@
+import Foundation
+
+/// Interstitial ad format -- split into its own file per brief 3B convention.
+final class UAInterstitial: NSObject {
+
+    static let shared = UAInterstitial()
+    private override init() {}
+
+    private var emit: ((String, String, [String: Any]) -> Void)?
+    private var ready = false
+
+    func registerListener(emit: @escaping (String, String, [String: Any]) -> Void) {
+        self.emit = emit
+        // NOTE: verify delegate protocol name against pinned SDK version -- classic API is
+        // `IronSourceInterstitialDelegate` set via `IronSource.setInterstitialDelegate(self)`.
+        IronSource.setInterstitialDelegate(self)
+    }
+
+    func load(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        IronSource.loadInterstitial()
+        plugin.send(command, success: true)
+    }
+
+    func show(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        guard IronSource.hasInterstitial() else {
+            plugin.send(command, error: "Interstitial not ready")
+            return
+        }
+        IronSource.showInterstitial(with: plugin.viewController)
+        plugin.send(command, success: true)
+    }
+
+    func isReady(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        plugin.send(command, payload: IronSource.hasInterstitial())
+    }
+}
+
+extension UAInterstitial: IronSourceInterstitialDelegate {
+
+    func interstitialDidLoad() {
+        ready = true
+        emit?("interstitial", "load", [:])
+    }
+
+    func interstitialDidFailToLoadWithError(_ error: Error) {
+        ready = false
+        emit?("interstitial", "loadFailed", errorPayload(error))
+    }
+
+    func interstitialDidOpen() {
+        emit?("interstitial", "show", [:])
+    }
+
+    func interstitialDidFailToShowWithError(_ error: Error) {
+        ready = false
+        emit?("interstitial", "showFailed", errorPayload(error))
+    }
+
+    func interstitialDidClick() {
+        emit?("interstitial", "click", [:])
+    }
+
+    func interstitialDidClose() {
+        ready = false
+        // Mirror AdMob's adDidDismissFullScreenContent pattern -- brief section 4, point 4.
+        UAAudioSessionGuard.shared.reactivateAfterAdDismiss()
+        emit?("interstitial", "dismiss", [:])
+        IronSource.loadInterstitial()
+    }
+
+    private func errorPayload(_ error: Error) -> [String: Any] {
+        let nsError = error as NSError
+        return ["code": nsError.code, "message": nsError.localizedDescription]
+    }
+}

package/src/ios/UARewarded.swift

@@ -0,0 +1,78 @@
+import Foundation
+
+/**
+ Rewarded ad format. Synthesizes a "rewardFailed" event when the ad closes WITHOUT a prior
+ "rewarded" event -- built in from the start per brief 3B, rather than retrofitted later like
+ Claude_AdMob's OnRewardedFailed had to be.
+ */
+final class UARewarded: NSObject {
+
+    static let shared = UARewarded()
+    private override init() {}
+
+    private var emit: ((String, String, [String: Any]) -> Void)?
+    private var earnedThisSession = false
+
+    func registerListener(emit: @escaping (String, String, [String: Any]) -> Void) {
+        self.emit = emit
+        // NOTE: verify against pinned SDK version -- classic API is
+        // `IronSourceRewardedVideoDelegate` via `IronSource.setRewardedVideoDelegate(self)`.
+        IronSource.setRewardedVideoDelegate(self)
+    }
+
+    func load(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        // Classic rewarded-video API auto-loads in the background; just ack the JS call.
+        plugin.send(command, success: true)
+    }
+
+    func show(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        guard IronSource.hasRewardedVideo() else {
+            plugin.send(command, error: "Rewarded not ready")
+            return
+        }
+        IronSource.showRewardedVideo(with: plugin.viewController)
+        plugin.send(command, success: true)
+    }
+
+    func isReady(_ command: CDVInvokedUrlCommand, plugin: ArcadesindoUnityAds) {
+        plugin.send(command, payload: IronSource.hasRewardedVideo())
+    }
+}
+
+extension UARewarded: IronSourceRewardedVideoDelegate {
+
+    func rewardedVideoHasChangedAvailability(_ available: Bool) {
+        emit?("rewarded", available ? "load" : "loadFailed", [:])
+    }
+
+    func rewardedVideoDidOpen() {
+        earnedThisSession = false
+        emit?("rewarded", "show", [:])
+    }
+
+    func rewardedVideoDidFailToShowWithError(_ error: Error) {
+        let nsError = error as NSError
+        emit?("rewarded", "showFailed", ["code": nsError.code, "message": nsError.localizedDescription])
+    }
+
+    func rewardedVideoDidClick() {
+        emit?("rewarded", "click", [:])
+    }
+
+    func rewardedVideoDidClose() {
+        UAAudioSessionGuard.shared.reactivateAfterAdDismiss()
+        if !earnedThisSession {
+            emit?("rewarded", "rewardFailed", [:])
+        }
+        emit?("rewarded", "dismiss", [:])
+    }
+
+    func didReceiveReward(forPlacement placementInfo: ISPlacementInfo) {
+        earnedThisSession = true
+        emit?("rewarded", "rewarded", [
+            "placementName": placementInfo.placementName ?? "",
+            "rewardName": placementInfo.rewardName ?? "",
+            "rewardAmount": placementInfo.rewardAmount
+        ])
+    }
+}

package/www/ArcadesindoUnityAds.js

@@ -0,0 +1,106 @@
+var exec = require('cordova/exec');
+
+var PLUGIN_NAME = 'ArcadesindoUnityAds';
+
+/**
+ * Thin JS bridge over the native LevelPlay (Unity Ads adapter only) wrapper.
+ * Every method returns nothing synchronously; results/events arrive via the
+ * registered listener callback (see `setAdListener`), matching the async
+ * load/show/dismiss/reward lifecycle of ad SDKs.
+ */
+var ArcadesindoUnityAds = {
+
+    // ---- lifecycle -------------------------------------------------------
+
+    /**
+     * @param {Object} options
+     * @param {string} options.appKey          LevelPlay App Key (platform.ironsrc.com)
+     * @param {boolean} [options.isTesting]    Show test ads only
+     * @param {string} [options.userId]        For server-to-server rewarded callbacks
+     */
+    initialize: function (options, successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'initialize', [options || {}]);
+    },
+
+    /**
+     * Registers a single persistent listener that receives every ad lifecycle
+     * event as { format, event, data }. format: 'interstitial'|'rewarded'|'banner'.
+     * event: 'load'|'loadFailed'|'show'|'showFailed'|'click'|'dismiss'|'rewarded'|'rewardFailed'.
+     */
+    setAdListener: function (eventCb) {
+        exec(eventCb, null, PLUGIN_NAME, 'setAdListener', []);
+    },
+
+    // ---- interstitial ------------------------------------------------------
+
+    loadInterstitial: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'loadInterstitial', []);
+    },
+
+    showInterstitial: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'showInterstitial', []);
+    },
+
+    isInterstitialReady: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'isInterstitialReady', []);
+    },
+
+    // ---- rewarded ------------------------------------------------------
+
+    loadRewarded: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'loadRewarded', []);
+    },
+
+    showRewarded: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'showRewarded', []);
+    },
+
+    isRewardedReady: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'isRewardedReady', []);
+    },
+
+    // ---- banner ------------------------------------------------------
+
+    /** @param {Object} options { position: 'top'|'bottom' } */
+    loadBanner: function (options, successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'loadBanner', [options || {}]);
+    },
+
+    showBanner: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'showBanner', []);
+    },
+
+    hideBanner: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'hideBanner', []);
+    },
+
+    destroyBanner: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'destroyBanner', []);
+    },
+
+    // ---- consent / privacy ------------------------------------------------
+
+    /** @param {boolean} consent GDPR consent */
+    setConsent: function (consent, successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'setConsent', [!!consent]);
+    },
+
+    /** @param {boolean} value CCPA "do not sell" flag */
+    setDoNotSell: function (value, successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'setDoNotSell', [!!value]);
+    },
+
+    /** @param {boolean} value COPPA child-directed flag */
+    setChildDirected: function (value, successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'setChildDirected', [!!value]);
+    },
+
+    // ---- diagnostics (audio bug investigation, see brief section 4) ------
+
+    /** Returns { currentTime } for delta-polling diagnostics around fullscreen ads. */
+    getAudioDiagnostics: function (successCb, errorCb) {
+        exec(successCb, errorCb, PLUGIN_NAME, 'getAudioDiagnostics', []);
+    }
+};
+
+module.exports = ArcadesindoUnityAds;