bevy_ios_toolkit 0.3.1

Native iOS integrations for Bevy as ECS resources and messages: StoreKit IAP, Google AdMob ads, App Tracking Transparency, Game Center, review prompts, haptics and safe-area — each behind a feature, over a polled C-ABI Swift bridge with a testable desktop fake.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

// Audio-session shim for bevy_ios_toolkit's `platform` feature.
//
// @_cdecl C-ABI called FROM Rust; no callbacks. Behind #if canImport(UIKit)
// with a linking stub otherwise. Symbol prefix `platform_`.

import Foundation

#if canImport(UIKit)
import AVFoundation
import UIKit

// Retained so the foreground-reassert observer is installed at most once.
@MainActor private var audioSessionObserver: NSObjectProtocol?

/// Own the app's audio session so nothing else — a full-screen video ad
/// reconfiguring it, the OS default — can leave the game muted. `playback` != 0
/// keeps sound on with the ring switch off (audio as a game feature, gated by
/// an in-app toggle); otherwise `.ambient` respects the switch. `mixWithOthers`
/// != 0 lets the player's own music keep playing. Re-asserted on every
/// foreground return, which covers cold boot AND a full-screen ad dismissing.
@_cdecl("platform_configure_audio_session")
public func platform_configure_audio_session(_ playback: Int32, _ mixWithOthers: Int32) {
    let usePlayback = playback != 0
    let mix = mixWithOthers != 0
    DispatchQueue.main.async {
        applyAudioSession(playback: usePlayback, mix: mix)
        if audioSessionObserver == nil {
            audioSessionObserver = NotificationCenter.default.addObserver(
                forName: UIApplication.didBecomeActiveNotification,
                object: nil,
                queue: .main
            ) { _ in applyAudioSession(playback: usePlayback, mix: mix) }
        }
    }
}

private func applyAudioSession(playback: Bool, mix: Bool) {
    let session = AVAudioSession.sharedInstance()
    let category: AVAudioSession.Category = playback ? .playback : .ambient
    let options: AVAudioSession.CategoryOptions = mix ? [.mixWithOthers] : []
    do {
        try session.setCategory(category, options: options)
        try session.setActive(true)
    } catch {
        // Non-fatal: worst case the OS default session stands.
    }
}

#else
@_cdecl("platform_configure_audio_session") public func platform_configure_audio_session(_ playback: Int32, _ mixWithOthers: Int32) {}
#endif