Inno.Adapter.Audio
Section titled “Inno.Adapter.Audio”
- 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.
Select a backend
Section titled “Select a backend”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.
Provider ownership contract
Section titled “Provider ownership contract”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.
API reference
Section titled “API reference”These are host composition contracts. Backend registration does not imply availability in every product or target.
Source project facts
Section titled “Source project facts”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. |