Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • Explicit audio backend selection and composition-owned provider catalogs.

This project selects backend-neutral audio devices from explicit provider registrations. It has no native bindings and does not define music, dialogue or scene-component policy.

Host composition supplies AudioBackendProvider instances to an immutable AudioBackendCatalog. AudioBackendId is an open, ordinal identity; it must be assigned and contain no whitespace. The built-in MiniAudio identity names a registration, not a request to scan the process for an implementation.

Validate the product’s adapter selection before creating services. CreateDevice receives a selected backend and AudioBackendOptions. The noDevice option supports explicitly hardwareless operation and tests; it is not evidence that a physical output device worked.

The composition owner retains providers and their resources. A successfully returned device belongs to the caller, which must transfer it to a runtime or dispose it under the device’s lifetime contract. Building a catalog does not create devices or transfer provider ownership.

Null provider sequences, null entries, invalid IDs and duplicate registrations are rejected. An unregistered backend throws NotSupportedException; a provider returning no device throws InvalidOperationException. Selection failures are explicit rather than silently choosing another backend.

The concrete native integration stays in its backend project. Game scripts use the audio facade, not backend factories or native handles. See runtime composition and device replacement ownership.

These are host composition contracts. Backend registration does not imply availability in every product or target.

Browse audio adapter types.

Project: Inno.Adapter.Audio
Source: src/adapters/audio/Inno.Adapter.Audio/Inno.Adapter.Audio.csproj

Type API Description
AudioBackendCatalog engine Resolves audio providers from one immutable, composition-owned registration snapshot.
AudioBackendId engine Identifies a audio implementation without closing the set of supported backends.
AudioBackendOptions engine Configures backend-neutral audio device creation.
AudioBackendProvider engine Describes one explicitly composed audio implementation and its creation boundary.
IAudioBackendFactory engine Creates backend-neutral audio devices from explicit backend selections.