Erste Schritte mit dem IVS iOS Broadcast SDK | Streaming in Echtzeit

Dieses Dokument führt Sie durch die Schritte zum Einstieg in das iOS Broadcast SDK von IVS-Streaming in Echtzeit.

Bibliothek installieren

Wir empfehlen Ihnen, das SDK über Swift Package Manager zu integrieren. (Alternativ können Sie die Integration über CocoaPods vornehmen oder das Framework manuell zu Ihrem Projekt hinzufügen.)

Empfohlen: Integrieren Sie das Broadcast-SDK (Swift Package Manager)

Wichtig: Das IVS-Echtzeit-Streaming-Broadcast-SDK beinhaltet alle Feature des IVS-Streaming-Broadcast-SDK mit niedriger Latenz. Es ist nicht möglich, beide SDKs in dasselbe Projekt zu integrieren.

Alternative Methode: Integrieren Sie das Broadcast-SDK (CocoaPods)

Wichtig: CocoaPods befindet sich im Wartungsmodus (nur Sicherheitskorrekturen) und nach Dezember 2026 können keine neuen Pakete oder Updates im CocoaPods veröffentlicht werden. Bestehende Pakete bleiben verfügbar, werden aber eingefroren. Wir empfehlen die Verwendung von Swift Package Manager für alle neuen Projekte.

Die Echtzeitfunktionalität wird als Unterspezifikation des iOS-Streaming-Broadcast-SDK mit niedriger Latenz veröffentlicht. So können Kunden je nach ihren Feature-Ánforderungen wählen, ob sie sie einbeziehen oder ausschließen möchten. Wenn die Funktionalität einbezogen wird, erhöht sich die Paketgröße.

Veröffentlichungen erfolgen über CocoaPods unter dem Namen AmazonIVSBroadcast. Fügen Sie diese Abhängigkeit zu Ihrem Podfile hinzu:

pod 'AmazonIVSBroadcast/Stages'

Führen Sie pod install aus und das SDK wird in Ihrem .xcworkspace verfügbar sein.

Wichtig: Das IVS-Echtzeit-Streaming-Broadcast-SDK (d. h. mit der Stage-Unterspezifikation) beinhaltet alle Features des IVS-Streaming-Broadcast-SDK mit niedriger Latenz. Es ist nicht möglich, beide SDKs in dasselbe Projekt zu integrieren. Wenn Sie Ihrem Projekt die Stage-Unterspezifikation über CocoaPods hinzufügen, müssen Sie alle anderen Zeilen in der Podfile mit AmazonIVSBroadcast entfernen. Zum Beispiel darf Ihre Podfile nicht beide der folgenden Zeilen enthalten:

pod 'AmazonIVSBroadcast'
pod 'AmazonIVSBroadcast/Stages'

Manuelles Installieren der Framework

Berechtigungen anfordern

Ihre App muss die Berechtigung für den Zugriff auf die Kamera und das Mikrofon des Benutzers anfordern. (Dies ist nicht spezifisch für Amazon IVS; es ist für jede Anwendung erforderlich, die Zugriff auf Kameras und Mikrofone benötigt.)

Hier prüfen wir, ob der Benutzer bereits Berechtigungen erteilt hat und wenn nicht, fragen wir nach ihnen:

switch AVCaptureDevice.authorizationStatus(for: .video) {
case .authorized: // permission already granted.
case .notDetermined:
   AVCaptureDevice.requestAccess(for: .video) { granted in
       // permission granted based on granted bool.
   }
case .denied, .restricted: // permission denied.
@unknown default: // permissions unknown.
}

Sie müssen dies sowohl für .video- als auch für .audio-Medientypen tun, wenn Sie auf Kameras bzw. Mikrofone zugreifen möchten.

Sie müssen außerdem Einträge für NSCameraUsageDescription und NSMicrophoneUsageDescription zu Ihrem Info.plist hinzufügen. Andernfalls stürzt Ihre App ab, wenn Sie versuchen, Berechtigungen anzufordern.

Deaktivieren des Idle-Timers der Anwendung

Dies ist zwar optional, wird aber empfohlen. Es verhindert, dass Ihr Gerät in den Ruhezustand versetzt, während Sie das Broadcast-SDK verwenden, was die Übertragung unterbrechen würde.

override func viewDidAppear(_ animated: Bool) {
   super.viewDidAppear(animated)
   UIApplication.shared.isIdleTimerDisabled = true
}
override func viewDidDisappear(_ animated: Bool) {
   super.viewDidDisappear(animated)
   UIApplication.shared.isIdleTimerDisabled = false
}