SwiftUI/MacOS: Manage/Configure Audio Device (Microphone) Inputs
Zusammenfassung
Kurz
Der Beitrag erklärt, wie macOS-Mikrofone mit `AVCaptureDevice` und Core Audio gefunden, über eine Geräte-ID ausgewählt und mit `AVAudioEngine` genutzt werden können. Als zentrale Einschränkung warnt der Autor vor einem möglicherweise veralteten Eingabeformat nach dem Gerätewechsel, das beim Einrichten eines Audio-Taps zum Absturz führen könne; er nennt drei mögliche Abhilfen.
Mittel
Der Artikel zeigt, wie eine macOS-App Mikrofone auflistet, ein Gerät auswählt und dessen Audiodaten mit SwiftUI und `AVAudioEngine` erfasst. Anders als unter iOS stehe dafür laut Autor keine `AVAudioSession`-Schnittstelle bereit. Zur Geräteerkennung stellt er `AVCaptureDevice.DiscoverySession` und Core Audio vor: Die erste Methode liefert Mikrofonobjekte, aber nicht die benötigte numerische `AudioObjectID`; Core Audio kann Gerätekennungen und Eigenschaften wie UID oder Namen bereitstellen, listet dabei jedoch auch Lautsprecher auf. Eine UID lässt sich laut Beitrag über `kAudioHardwarePropertyTranslateUIDToDevice` in eine Geräte-ID übersetzen.
Für die Aufnahme wird die ID über `audioEngine.inputNode.auAudioUnit.setDeviceID` gesetzt. Das Beispiel ergänzt Geräteauswahl, Berechtigungsprüfung und eine Anzeige der Audiopegel. Der Autor betont eine Formatfalle: Nach dem Gerätewechsel kann `outputFormat(forBus:)` veraltet sein. Ein Tap mit diesem Format könne bei abweichendem Geräteformat zum Absturz führen. Als Lösungen nennt er eine Formatabfrage über Core Audio, `nil` beim Installieren des Taps oder eine neue `AVAudioEngine`. Die Geräteabfrage im Beispiel erfolgt vereinfachend per Timer; alternativ könne man Konfigurationsänderungen der Engine beobachten. Der Artikel enthält Beispielcode, aber keine systematische Prüfung verschiedener macOS-Versionen oder Geräte.
Ausführlich lesen
Der Artikel beschreibt, wie sich unter macOS in einer SwiftUI-App verfügbare Mikrofone auflisten, ein ausgewähltes Gerät als Audioeingang verwenden und Audiodaten erfassen lassen. Der Autor stellt dies dem iOS-Ablauf gegenüber: Dort könne man über `AVAudioSession` verfügbare Eingänge abfragen und mit `setPreferredInput(_:)` auswählen; macOS biete diese Schnittstelle laut Artikel nicht.
Zum Finden von Mikrofonen zeigt der Beitrag zwei Wege. Mit `AVCaptureDevice.DiscoverySession` lassen sich laut Autor Geräte der Typen Mikrofon und externes Audiogerät abfragen. Die gelieferten `AVCaptureDevice`-Objekte enthalten unter anderem eindeutige Kennung, Modellkennung, Anzeigenamen, Hersteller, Verbindungs- und Nutzungsstatus sowie den Transporttyp. Der Artikel nennt eine Einschränkung: Diese Schnittstelle liefert nicht die `AudioObjectID`, die später zum Festlegen des Eingabegeräts benötigt wird.
Als zweite Möglichkeit stellt der Autor Core Audio vor. Über `kAudioHardwarePropertyDevices` werden Gerätekennungen ausgelesen; weitere Eigenschaften wie UID und Name lassen sich über eigene Property-Abfragen ermitteln. Diese Abfrage umfasst laut Beitrag auch Lautsprecher, weshalb Ausgabegeräte herausgefiltert werden müssen. Um beide Ansätze zu verbinden, kann man die UID eines `AVCaptureDevice` mit `kAudioHardwarePropertyTranslateUIDToDevice` in eine Gerätekennung übersetzen oder UIDs und Kennungen anderweitig zuordnen. Der Autor weist außerdem darauf hin, dass Gerätekennungen als Zeichenketten vorliegen und nicht mit der numerischen Core-Audio-ID gleichzusetzen sind.
Zum Verwenden des gewählten Mikrofons schlägt der Beitrag die Kette `AVAudioEngine` → `AVAudioInputNode` → `AUAudioUnit` vor. Über `setDeviceID(_:)` wird dort die Audio-Gerätekennung gesetzt. Ein längeres Swift-Beispiel verbindet die Erkennung und Auswahl mit einer SwiftUI-Ansicht, startet und stoppt die Aufnahme über `AVAudioEngine` und zeigt durchschnittliche sowie Spitzenpegel je Kanal an. Es prüft außerdem die Mikrofonberechtigung und fordert dazu auf, den Schlüssel „Privacy — Microphone Usage Description“ in die `Info.plist` aufzunehmen.
Als wichtige technische Grenze nennt der Autor, dass sich das Ausgabeformat des Eingabeknotens nach `setDeviceID` nicht automatisch aktualisiert. Wird anschließend mit einem veralteten Format ein Tap eingerichtet und weicht das neue Geräteformat vom alten ab, könne die App abstürzen. Vorgeschlagene Abhilfen sind, das Format mit Core Audio abzufragen, beim Installieren des Taps `nil` zu übergeben oder vor dem Setzen der Geräte-ID eine neue `AVAudioEngine` anzulegen. Der Beispielcode fragt Geräte regelmäßig per Timer ab; der Autor beschreibt das als Vereinfachung für seine Ansicht und nennt `AVAudioEngineConfigurationChange` als mögliche Alternative, wenn Konfigurationsänderungen überwacht werden sollen. Der Bericht liefert Code und Empfehlungen, aber keine systematische Kompatibilitätsprüfung oder Messergebnisse.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Lunas Einordnung enthält weder Sammel- noch Teilfragen, daher wurden keine Fragen bewertet. Die Zusammenfassung wurde gegen den Bericht geprüft; der Satz zur fehlenden systematischen Prüfung ist eine Bewertung Lunas und kein Berichtsinhalt.
Im Bericht, aber nicht in der Zusammenfassung
- Der Autor merkt an, dass `AVCaptureDevice` Eigenschaften wie `isVirtualDevice` auf macOS nicht bereitstellt und dass die Kennung der Geräte über Core Audio unterschiedlich abgefragt wird
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Der Artikel enthält keine systematische Prüfung verschiedener macOS-Versionen oder Geräte (Aussage steht so nicht im Bericht)
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.