Skip to content

Add scoped and configurable Unity audio#10

Draft
liuzqk wants to merge 2 commits into
ze-time-kernel-p5from
codex/gallerykeeper-audio-timekernel
Draft

Add scoped and configurable Unity audio#10
liuzqk wants to merge 2 commits into
ze-time-kernel-p5from
codex/gallerykeeper-audio-timekernel

Conversation

@liuzqk

@liuzqk liuzqk commented Jul 19, 2026

Copy link
Copy Markdown
Owner

What changed

  • add addressable-friendly AudioBankSO assets with stable semantic event ids and scoped registration
  • add pooled SFX cooldowns, concurrency limits, priorities, loop stop, and configurable pool sizing
  • add two-source intro/loop music with manager defaults and per-track crossfade/fade-out timing
  • expose 3D cue pan, rolloff, min/max distance, Doppler, spread, and reverb settings
  • make AudioMixer volume conversion reusable and SaveManager persistence optional
  • add validation, EditMode/PlayMode coverage, and package setup documentation

Why

GalleryKeeper needs a dependency-light Unity audio backend whose banks can follow Addressables content lifetimes and whose routine content tuning is data-driven, without introducing FMOD or Wwise. The previous package lacked scoped bank registration and several playback controls needed for room content production.

Impact

Existing PlaySFX and PlayMusic entry points remain available. Consumers can load and register an AudioBankSO for a content scope, configure project playback policy through ConfigurePlayback, tune individual cue spatial behavior and music transitions, then stop/unregister the bank before releasing its Addressables handle.

Validation

  • Unity 6000.3.10f1, ZE Audio EditMode — 8/8 passed
  • Unity 6000.3.10f1, ZE Audio PlayMode batchmode — 5/5 passed
  • GalleryKeeper consumer EditMode — 43/43 passed
  • GalleryKeeper consumer PlayMode batchmode — 12/12 passed
  • repeated GalleryKeeper starter-asset generation changed 0 tuned asset hashes
  • git diff --check passed

@liuzqk
liuzqk changed the base branch from main to ze-time-kernel-p5 July 19, 2026 03:41
@liuzqk liuzqk changed the title Add scoped Unity audio banks Add scoped and configurable Unity audio Jul 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant