SplitScript reference / UnityScenes / active

UnityScenes.active

Method

UnityScenes.active() -> UnityScene!

Reads the currently active scene as an immutable snapshot.

The snapshot owns the scene's address, build index, asset path, and derived name. A missing scene or failed component read returns an error, allowing a state field to retain its preceding accepted value.

Effects: allocates, reads process memory, requires an attached process

Runtime behavior: available while a process is attached, except in onDetach; synchronous

Examples

Poll the active scene

split {
    return old.activeScene.name != current.activeScene.name
}