Goo.Audio 0.30.0

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.

Open and dispose on the UI thread, after Window.ConfigureApplication if used. Other operations are thread-safe. Owners of the same output share playback state. Completion means drained queues, not exact audible timing. See the audio API for statuses and controls.

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.