AVFoundation für Swift: Das komplette Tutorial mit Beispielen

Einführung in AVFoundation

AVFoundation ist ein leistungsstarkes Framework von Apple für die Arbeit mit Audio und Video auf iOS, macOS, tvOS und watchOS. Es bietet Entwicklern eine High-Level-API zum Aufnehmen, Verarbeiten, Abspielen und Bearbeiten von Multimedia-Inhalten. Im Gegensatz zu Low-Level-Lösungen (wie Core Audio oder Video Toolbox) abstrahiert AVFoundation die komplexen Details von Codecs, Containern und Synchronisation, sodass du dich auf die App-Logik konzentrieren kannst.

Wofür wird AVFoundation verwendet? Es deckt ein breites Spektrum an Aufgaben ab:

• Wiedergabe: Abspielen von Audiodateien (MP3, AAC, WAV) und Videodateien (MP4, MOV, M4V) mit Unterstützung für Untertitel und Kapitel.
• Aufnahme: Echtzeit-Videoaufnahme von der Kamera und Audio vom Mikrofon.
• Bearbeitung: Erstellen von Kompositionen aus mehreren Spuren, Hinzufügen von Effekten, Trimmen und Ändern der Geschwindigkeit.
• Verarbeitung: Extrahieren von Metadaten, Arbeiten mit Audio-Samples und Anwenden von Filtern.
• Streaming: Abspielen von HLS (HTTP Live Streaming) Inhalten.

AVFoundation ist der De-facto-Standard für die Apple-Entwicklung. Wenn du eine App schreibst, die Musik abspielen, Videos aufnehmen oder Podcasts bearbeiten soll, wirst du dieses Framework verwenden.

Installation (Einbindung ins Projekt)

AVFoundation wird nicht über pip oder npm installiert, da es sich um ein natives Apple-Framework handelt. Es ist in Xcode und das SDK integriert. Für die Nutzung reicht es aus, das Modul in deine Swift-Dateien zu importieren.

Schritte zur Einbindung:

1. Öffne dein Projekt in Xcode.
2. Füge in jeder Swift-Datei, die Multimedia-Funktionen benötigt, die folgende Import-Zeile hinzu:

import AVFoundation

Es sind keine weiteren Schritte erforderlich. Das Framework ist automatisch für alle iOS/macOS-Projekte verfügbar.

Berechtigungen einrichten (iOS)

Für den Zugriff auf Kamera und Mikrofon musst du folgende Einträge in deiner Info.plist hinzufügen:

• NSCameraUsageDescription — Beschreibung, warum die App die Kamera benötigt.
• NSMicrophoneUsageDescription — Beschreibung, warum die App das Mikrofon benötigt.

Ohne diese Schlüssel stürzt die App ab, wenn sie versucht, auf die Geräte zuzugreifen.

Schnellstart: Audio-Wiedergabe

Das einfachste Beispiel ist das Abspielen einer lokalen Audiodatei. Erstelle eine Instanz von AVAudioPlayer und rufe die Methode play() auf.

import AVFoundation
import UIKit

class ViewController: UIViewController {
    var audioPlayer: AVAudioPlayer?

    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 1. Pfad zur Datei im App-Bundle finden
        guard let path = Bundle.main.path(forResource: "sample", ofType: "mp3") else {
            print("Datei nicht gefunden")
            return
        }
        
        let url = URL(fileURLWithPath: path)
        
        do {
            // 2. Player initialisieren
            audioPlayer = try AVAudioPlayer(contentsOf: url)
            // 3. Für die Wiedergabe vorbereiten (optional, aber empfohlen)
            audioPlayer?.prepareToPlay()
            // 4. Starten
            audioPlayer?.play()
            print("Wiedergabe gestartet")
        } catch {
            print("Fehler bei der Player-Initialisierung: \(error.localizedDescription)")
        }
    }
}

Dieser Code erstellt einen Player, lädt die Datei sample.mp3 aus den App-Ressourcen und startet die Wiedergabe.

Wichtige Klassen und Methoden

Im Folgenden findest du die wichtigsten Klassen und Methoden von AVFoundation, die in 90% der Fälle verwendet werden. Für jede Methode gibt es eine Beschreibung, Parameter und ein funktionierendes Beispiel.

1. AVAudioPlayer

Funktion: Spielt Audiodateien aus dem Speicher oder dem Dateisystem ab. Unterstützt Formate wie MP3, AAC, WAV und mehr. Bietet Steuerungsmöglichkeiten wie Abspielen, Pausieren, Stoppen und Lautstärkeregelung.