Repository Public
1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: Core/Audio/AudioOutputManager.swift3// Description: Audio output devices from the Core Audio HAL: list, sample rates, change notifications.4import Foundation5import CoreAudio67public struct OutputDevice: Identifiable, Hashable, Sendable {8 public var id: AudioDeviceID9 public var uid: String10 public var name: String11 public var sampleRate: Double12 public var availableSampleRates: [Double]13 public var transport: String14 public var isDefault: Bool15}1617/// The Mac's audio outputs, straight from the Core Audio HAL: listing, current sample rate, change notifications,18/// and (when the listener asks for it) switching a device's sample rate to the track's.19public final class AudioOutputManager: @unchecked Sendable {20 private var listeners: [(AudioObjectID, AudioObjectPropertyAddress, AudioObjectPropertyListenerBlock)] = []21 private let queue = DispatchQueue(label: "spmusic.audio.devices")22 private let lock = NSLock()23 private var onChange: (@Sendable () -> Void)?2425 public init() {}26 deinit { for (obj, addr, block) in listeners { var a = addr; AudioObjectRemovePropertyListenerBlock(obj, &a, queue, block) } }2728 private static func address(_ selector: AudioObjectPropertySelector, scope: AudioObjectPropertyScope = kAudioObjectPropertyScopeGlobal) -> AudioObjectPropertyAddress {29 AudioObjectPropertyAddress(mSelector: selector, mScope: scope, mElement: kAudioObjectPropertyElementMain)30 }31 private static func get<T>(_ object: AudioObjectID, _ selector: AudioObjectPropertySelector, scope: AudioObjectPropertyScope = kAudioObjectPropertyScopeGlobal, default value: T) -> T {32 var addr = address(selector, scope: scope); var v = value; var size = UInt32(MemoryLayout<T>.size)33 return AudioObjectGetPropertyData(object, &addr, 0, nil, &size, &v) == noErr ? v : value34 }35 private static func string(_ object: AudioObjectID, _ selector: AudioObjectPropertySelector) -> String {36 var addr = address(selector); var size = UInt32(MemoryLayout<CFString?>.size)37 var ref: Unmanaged<CFString>?38 guard AudioObjectGetPropertyData(object, &addr, 0, nil, &size, &ref) == noErr, let ref else { return "" }39 return ref.takeRetainedValue() as String40 }4142 public static var defaultOutputID: AudioDeviceID { Self.get(AudioObjectID(kAudioObjectSystemObject), kAudioHardwarePropertyDefaultOutputDevice, default: AudioDeviceID(0)) }4344 public static func outputDevices() -> [OutputDevice] {45 var addr = address(kAudioHardwarePropertyDevices); var size: UInt32 = 046 guard AudioObjectGetPropertyDataSize(AudioObjectID(kAudioObjectSystemObject), &addr, 0, nil, &size) == noErr else { return [] }47 var ids = [AudioDeviceID](repeating: 0, count: Int(size) / MemoryLayout<AudioDeviceID>.size)48 guard AudioObjectGetPropertyData(AudioObjectID(kAudioObjectSystemObject), &addr, 0, nil, &size, &ids) == noErr else { return [] }49 let def = defaultOutputID50 return ids.compactMap { id in51 // Only devices that have output channels.52 var cfg = address(kAudioDevicePropertyStreamConfiguration, scope: kAudioDevicePropertyScopeOutput); var cfgSize: UInt32 = 053 guard AudioObjectGetPropertyDataSize(id, &cfg, 0, nil, &cfgSize) == noErr, cfgSize > 0 else { return nil }54 let raw = UnsafeMutableRawPointer.allocate(byteCount: Int(cfgSize), alignment: MemoryLayout<AudioBufferList>.alignment); defer { raw.deallocate() }55 guard AudioObjectGetPropertyData(id, &cfg, 0, nil, &cfgSize, raw) == noErr else { return nil }56 let list = UnsafeMutableAudioBufferListPointer(raw.assumingMemoryBound(to: AudioBufferList.self))57 guard list.reduce(0, { $0 + Int($1.mNumberChannels) }) > 0 else { return nil }58 let transport: UInt32 = get(id, kAudioDevicePropertyTransportType, default: 0)59 let kind = switch transport {60 case kAudioDeviceTransportTypeBuiltIn: "Intégré"61 case kAudioDeviceTransportTypeUSB: "USB"62 case kAudioDeviceTransportTypeBluetooth, kAudioDeviceTransportTypeBluetoothLE: "Bluetooth"63 case kAudioDeviceTransportTypeAirPlay: "AirPlay"64 case kAudioDeviceTransportTypeHDMI, kAudioDeviceTransportTypeDisplayPort: "HDMI / DisplayPort"65 case kAudioDeviceTransportTypeThunderbolt: "Thunderbolt"66 case kAudioDeviceTransportTypeVirtual, kAudioDeviceTransportTypeAggregate: "Virtuel"67 default: ""68 }69 return OutputDevice(id: id, uid: string(id, kAudioDevicePropertyDeviceUID), name: string(id, kAudioObjectPropertyName), sampleRate: get(id, kAudioDevicePropertyNominalSampleRate, default: 0.0),70 availableSampleRates: availableRates(id), transport: kind, isDefault: id == def)71 }72 }7374 public static func availableRates(_ id: AudioDeviceID) -> [Double] {75 var addr = address(kAudioDevicePropertyAvailableNominalSampleRates); var size: UInt32 = 076 guard AudioObjectGetPropertyDataSize(id, &addr, 0, nil, &size) == noErr, size > 0 else { return [] }77 var ranges = [AudioValueRange](repeating: AudioValueRange(), count: Int(size) / MemoryLayout<AudioValueRange>.size)78 guard AudioObjectGetPropertyData(id, &addr, 0, nil, &size, &ranges) == noErr else { return [] }79 let common: [Double] = [44100, 48000, 88200, 96000, 176400, 192000, 352800, 384000]80 return common.filter { r in ranges.contains { $0.mMinimum <= r && r <= $0.mMaximum } }81 }8283 public static func device(uid: String) -> OutputDevice? { outputDevices().first { $0.uid == uid } }84 public static func sampleRate(of id: AudioDeviceID) -> Double { get(id, kAudioDevicePropertyNominalSampleRate, default: 0.0) }8586 /// Asks the device to run at `rate`. Returns false when the device does not offer it or refuses.87 @discardableResult88 public static func setSampleRate(_ rate: Double, on id: AudioDeviceID) -> Bool {89 guard availableRates(id).contains(rate) else { return false }90 if sampleRate(of: id) == rate { return true }91 var addr = address(kAudioDevicePropertyNominalSampleRate); var r = rate92 return AudioObjectSetPropertyData(id, &addr, 0, nil, UInt32(MemoryLayout<Double>.size), &r) == noErr93 }9495 /// Calls `handler` when devices appear or disappear, or when the default output changes.96 public func observe(_ handler: @escaping @Sendable () -> Void) {97 lock.withLock { onChange = handler }98 guard listeners.isEmpty else { return }99 for selector in [kAudioHardwarePropertyDevices, kAudioHardwarePropertyDefaultOutputDevice] {100 var addr = Self.address(selector)101 let block: AudioObjectPropertyListenerBlock = { [weak self] _, _ in let h = self?.lock.withLock { self?.onChange }; h?() }102 if AudioObjectAddPropertyListenerBlock(AudioObjectID(kAudioObjectSystemObject), &addr, queue, block) == noErr { listeners.append((AudioObjectID(kAudioObjectSystemObject), addr, block)) }103 }104 }105}106