Goo.Audio 0.28.4

Optional audio

using let file = File.OpenRead("notification.wav")
let cue = SoundSource.LoadWav(file)
let opened = SoundPlayer.TryOpen()
let audio = opened.Player
let queued = audio?.TryPlay(cue, 0.5F)

Add Goo.Audio alongside Goo with the same package version. Types use namespace Goo. Keep the player at application scope.

All operations except open and dispose are thread-safe. Invalid arguments and disposed-owner play calls throw. Completion means drained queues, not exact audible timing.

Sources

• The reader gets a reusable 1024-frame buffer and a requested frame count.
• Return frames written. Zero means permanent end. Short reads continue on the next request.
• Do not retain the buffer, block, call playback controls, or access UI state.
• Invalid counts, non-finite samples, and reader exceptions become SourceFailure.
• Consumer code owns compressed decoders, decoder synchronization, looping, seek, and stereo pan.
• Android uses AAudio without SDL. Desktop uses SDL.
• Applications own mute and notification policy.

System UI sounds

let status = SystemSounds.TryPlay(SystemSound.Alert)

• Windows uses system sound aliases. macOS supports alerts through NSBeep.
• Linux uses the optional system libcanberra.so.0 and the installed sound theme.
• Android, macOS clicks and missing platform APIs return Unsupported.
• Queued means the platform accepted the request. Sound settings can keep it silent.
• A native API failure returns NativeFailure. No PCM device or SoundPlayer is needed.

Output selection

using let outputs = SoundPlayer.EnumerateOutputDevices()
if outputs.Status == SoundDeviceStatus.Enumerated && outputs.Devices.Count > 0 {
    using let player = SoundPlayer.TryOpen(outputs.Devices[0]).Player
}

• Desktop enumeration uses SDL. Android returns Unsupported and an empty list.
• Open a choice before disposing the list. Existing players remain usable after list disposal.
• Names are display labels, not persistent identifiers. Do not retain entries from a disposed list.
• Enumeration returns Enumerated, Unsupported, SubsystemUnavailable or NativeFailure.
• A device unplugged before open returns DeviceUnavailable. The default open still follows platform routing.