Lifecycle (Unity)

There is no FRVRSDK.Lifecycle.* surface in Unity

Compared with the Web SDK lifecycle — where a JS game registers five callbacks explicitly — the Unity wrapper does not ask you to wire pause/resume/audio handlers. The reason is mostly that Unity’s own runtime already covers most of it:

• When the browser tab loses focus (an ad iframe takes over, the player tabs away), Unity fires OnApplicationFocus(false) and OnApplicationPause(true) on every active MonoBehaviour, and stops running Update loops while the canvas is hidden.
• When focus comes back, Unity unpauses on its own.

You don’t have to subscribe — but you also don’t get anything FRVR-specific layered on top. The wrapper does not call Time.timeScale, AudioListener.pause, or any internal “ad started” pause hook.

Audio: manual control via FRVRSDK

For audio you may want to mute/unmute under your control (e.g. when the platform asks the game to mute, or when you want to silence audio while an ad shows). The SDK exposes a small audio API on the top-level FRVRSDK class — it manipulates Unity’s AudioListener.volume for you:

FRVRSDK.MuteVolume();             // saves current volume, sets AudioListener.volume = 0
FRVRSDK.UnmuteVolume();           // restores the saved volume
FRVRSDK.SetVolume(0.5f);          // clamped 0..1
float v   = FRVRSDK.GetVolume();
bool muted = FRVRSDK.IsMuted();

These calls don’t fire automatically — your code (or the channel host via SendMessage to the SDK singleton’s MuteVolumeInstance / UnmuteVolumeInstance / SetVolumeInstance) decides when to mute.

What you do still care about

• Audio imports. Mute compliance on iOS requires every AudioClip imported with specific settings — see Unity quickstart § 3. Audio. This is the one lifecycle‑adjacent thing that breaks if you skip it.
• Run in background must be OFF. Project Settings → Player → Resolution and Presentation. If it’s on, Unity will keep running under an ad overlay — double‑consuming audio channels and CPU, and breaking the focus-driven pause described above.
• Mute audio yourself around ads. Because the wrapper does not auto-mute, you may want to call FRVRSDK.MuteVolume() in your interstitial / reward onStart and UnmuteVolume() in onFinish / onError, especially if “Run in background” can’t be guaranteed off on every channel build.

If you need to react to pause/resume in game code

Use Unity’s built‑in hooks — they’ll fire because the wrapper is using the same signals:

void OnApplicationPause(bool paused)
{
    if (paused) StopAmbientLoops();
    else        ResumeAmbientLoops();
}

void OnApplicationFocus(bool hasFocus)
{
    // hasFocus == false means the tab/app was backgrounded or an ad opened
}

Don’t try to proxy these to FRVRSDK.Lifecycle.* — there’s no such API in the Unity wrapper, and it’d duplicate work the wrapper is already doing.