AmbientAudio
16 tools in this family (folder Editor/Tools/AmbientAudio/ in the bridge package). Effect: writes changes the project or the scene, read-only does not, destructive deletes or overwrites and the client asks before running it.
| Tool | Effect | Description |
|---|---|---|
ambient_audio_add_loop_layer | writes | Add an ambient loop layer to a soundscape — a continuous looping clip (or weighted list that |
ambient_audio_add_oneshot_layer | writes | Add a random-one-shot layer — clips fire at random intervals (e.g. bird calls every 10–60s). |
ambient_audio_add_positional_layer | writes | Add a 3D positional source — a clip pinned to a world position or following a named Transform. |
ambient_audio_add_procedural_mix_layer | writes | Add a procedural mix layer whose volume tracks a parameter through a curve. Examples: wind that |
ambient_audio_apply_preset | writes | Load a built-in soundscape preset into the runtime. Presets are fully composed (5–12 layers) |
ambient_audio_create_soundscape | writes | Create an empty soundscape (named bundle of layers) in the runtime registry. After creation, |
ambient_audio_create_zone | writes | Create an AudioZone GameObject in the scene. The zone activates the named soundscape when the |
ambient_audio_export_setup | read-only | Export the entire ambient audio runtime — all registered soundscapes (layers, conditions, |
ambient_audio_hook_audio_bus | writes | Route a soundscape's voices through a named audio_master_* bus. The runtime multiplies each |
ambient_audio_hook_biome | writes | Toggle the reflective bridge to gaia_*. When enabled, layers with Biome conditions resolve the |
ambient_audio_hook_weather | writes | Toggle the reflective bridge to weather_*. When enabled, layers with Weather conditions resolve |
ambient_audio_list_presets | read-only | List the 10 built-in soundscape presets with their description, default bus, and recommended |
ambient_audio_preview | writes | Start an editor preview of a soundscape. The runtime is ticked from EditorApplication.update so |
ambient_audio_set_layer_conditions | writes | Replace the conditions list on a layer. Conditions filter when the layer is eligible to play. |
ambient_audio_set_zone_priority | writes | Update an existing AudioZone's priority and/or hysteresis. Higher priority wins when zones |
ambient_audio_stop_preview | writes | Stop any active editor preview. Removes the transient preview zone, shuts down the runtime tick |