Démarrez avec le SDK de diffusion iOS IVS | Streaming en temps réel

Ce document explique les étapes nécessaires pour le démarrage avec le SDK de diffusion iOS IVS en temps réel.

Installer la bibliothèque

Nous vous recommandons d’intégrer le kit SDK de diffusion via Swift Package Manager. (Vous pouvez également intégrer via CocoaPods ou ajouter manuellement le cadre à votre projet.)

Recommandé : intégrer le kit SDK de diffusion (Swift Package Manager)

Important : le SDK de diffusion par streaming en temps réel IVS inclut toutes les fonctionnalités du kit SDK de diffusion par streaming à faible latence. Il n’est pas possible d’intégrer les deux kits SDK dans le même projet.

Autre approche : intégrer le kit SDK Broadcast (CocoaPods)

Important : CocoaPods est en mode maintenance (correctifs de sécurité uniquement) et après décembre 2026, aucun nouveau package ou mise à jour ne pourra être publié dans le référentiel CocoaPods. Les packages existants resteront disponibles, mais seront gelés. Nous recommandons d’utiliser Swift Package Manager pour tous les nouveaux projets.

La fonctionnalité temps réel est publiée en tant que sous-spécification du SDK de diffusion iOS par streaming à faible latence. Les clients peuvent ainsi choisir de l’inclure ou de l’exclure en fonction de leurs besoins en fonctionnalités. L’inclusion augmente la taille de l’emballage.

Les versions sont publiées via CocoaPods sous le nom AmazonIVSBroadcast. Ajoutez cette dépendance à votre Podfile :

pod 'AmazonIVSBroadcast/Stages'

Exécutez pod install et le kit SDK sera disponible dans votre .xcworkspace.

Important : le SDK de diffusion par streaming en temps réel IVS (c’est-à-dire avec la sous-spécification de scène) inclut toutes les fonctionnalités du SDK de diffusion par streaming à faible latence. Il n’est pas possible d’intégrer les deux kits SDK dans le même projet. Si vous ajoutez la sous-spécification d’étape via CocoaPods à votre projet, veillez à supprimer toutes les autres lignes du Podfile contenant AmazonIVSBroadcast. Par exemple, vous n’avez pas ces deux lignes dans votre Podfile :

pod 'AmazonIVSBroadcast'
pod 'AmazonIVSBroadcast/Stages'

Autre approche : installer manuellement le cadre

Demander des autorisations

Votre appli doit demander l’autorisation d’accéder à la caméra et au micro de l’utilisateur. (Ce n’est pas spécifique à Amazon IVS ; cette autorisation est requise pour toute application devant accéder aux caméras et aux micros.)

Ici, nous vérifions si l’utilisateur a déjà accordé des autorisations et, dans le cas contraire, nous les demandons :

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.
}

Vous devez demander des autorisations pour les types de médias .video et .audio si vous souhaitez accéder aux caméras et aux microphones, respectivement.

Vous devez également ajouter des entrées pour NSCameraUsageDescription et NSMicrophoneUsageDescription à votre Info.plist. Sinon, votre application se bloquera lorsque vous essayerez de demander des autorisations.

Désactiver le minuteur d’inactivité de l’application

Cette action est facultative, mais recommandée. Elle empêche votre appareil de se mettre en veille lors de l’utilisation du kit SDK de diffusion, ce qui pourrait interrompre la diffusion.

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