SDK de diffusion IVS (Streaming en temps réel)

Le SDK de diffusion par streaming en temps réel Amazon Interactive Video Services (IVS) est destiné aux développeurs qui créent des applications avec Amazon IVS. Ce kit SDK est conçu pour tirer parti de l’architecture Amazon IVS et nous y apporterons continuellement des améliorations et de nouvelles fonctionnalités, en plus d’Amazon IVS. En tant que kit SDK de diffusion natif, il est conçu pour minimiser l’impact sur les performances de votre application et sur les périphériques avec lesquels vos utilisateurs accèdent à votre application.

Notez que le SDK de diffusion est utilisé à la fois pour envoyer et recevoir des vidéos ; c’est-à-dire que vous utilisez le même SDK pour les hôtes et les spectateurs. Aucun SDK de lecteur distinct n’est nécessaire.

Votre application peut tirer parti des fonctionnalités clés du kit SDK de diffusion Amazon IVS :

• Streaming haute qualité : le kit SDK de diffusion prend en charge le streaming haute qualité. Capturez des vidéos à partir de votre caméra et encodez-les jusqu’à 720p.

• Ajustements automatiques du débit binaire : les utilisateurs de smartphones sont mobiles, de sorte que les conditions de leur réseau peuvent changer tout au long de la diffusion. Le kit SDK de diffusion Amazon IVS ajuste automatiquement le débit binaire de la vidéo pour s’adapter aux conditions changeantes du réseau.

• Support des formats portrait et paysage : quelle que soit la façon dont vos utilisateurs tiennent leurs appareils, l’image apparaît dans le bon sens et à la bonne échelle. Le kit SDK de diffusion prend en charge les tailles de canevas portrait et paysage. Il gère automatiquement les proportions lorsque les utilisateurs font pivoter leur appareil et quittent l’orientation configurée.

• Streaming sécurisé : les diffusions de vos utilisateurs sont chiffrées à l’aide de TLS ; ils peuvent donc sécuriser leurs flux.

• Périphériques audio externes : le kit SDK de diffusion Amazon IVS prend en charge les microphones externes à prise audio, USB et Bluetooth SCO.

Exigences de la plateforme

Plateformes natives

Plateforme	Versions prises en charge
Android	9.0 et versions ultérieures : notez que les clients peuvent créer avec la version 5.0 mais ne pourront pas utiliser la fonctionnalité de diffusion en temps réel.
iOS	14 et versions ultérieures

IVS prend en charge au moins 4 versions majeures d’iOS et 6 versions majeures d’Android. Notre prise en charge des versions actuelles peut s’étendre au-delà de ces minimums. Si une version majeure n’est plus prise en charge, les clients seront informés par des notes de mise à jour du SDK au moins 3 mois à l’avance.

Navigateurs de bureau

Navigateur	Plateformes prises en charge	Versions prises en charge
Chrome	Windows, macOS	Deux versions principales (la version actuelle et la version la plus récente)
Firefox	Windows, macOS	Deux versions principales (la version actuelle et la version la plus récente)
Edge	(Windows 8.1 et versions ultérieures)	Deux versions principales (la version actuelle et la version la plus récente) Exclut Edge Legacy
Safari	macOS	Deux versions principales (la version actuelle et la version la plus récente)

Navigateurs mobiles (iOS et Android)

Navigateur	Plateformes prises en charge	Versions prises en charge
Chrome	iOS, Android	Deux versions principales (la version actuelle et la version la plus récente)
Firefox	Android	Deux versions principales (la version actuelle et la version la plus récente)
Safari	iOS	Deux versions principales (la version actuelle et la version la plus récente)

Limitations connues

• Sur tous les appareils mobiles, nous vous déconseillons de diffuser ou de vous abonner à quatre participants ou plus en même temps. Cela pourrait entrainer des problèmes liés aux artefacts vidéo et aux écrans noirs. Si vous avez besoin de plus de participants, configurez la diffusion et l’abonnement audio uniquement.

• Nous vous déconseillons de composer une scène et de la diffuser sur une chaîne avec Android Mobile Web. Cela pourrait réduire les performances et provoquer d’éventuels plantage. Si une fonctionnalité de diffusion est requise, intégrez le SDK de diffusion Android par diffusion en temps réel IVS.

Webview

Le SDK de diffusion Web ne prend pas en charge les Webview ou les environnements similaires au Web (téléviseurs, consoles, etc.). Pour les implémentations mobiles, consultez le guide du SDK de diffusion par streaming en temps réel pour Android et pour iOS.

Accès requis à l’appareil

Le kit SDK de diffusion nécessite l’accès aux caméras et microphones de l’appareil, à la fois ceux intégrés à l’appareil et ceux connectés via Bluetooth, USB ou prise audio.

Support

Remarque : le SDK de diffusion est en constante amélioration. Consultez la rubrique Notes de mise à jour Amazon IVS pour connaître les versions disponibles et les problèmes résolus. Le cas échéant, avant de contacter le support technique, mettez à jour la version du kit SDK de diffusion et vérifiez si cela résout votre problème.

Contrôle de version

Les kits SDK de diffusion Amazon IVS utilisent la gestion sémantique des versions.

Pour ce sujet, supposons que :

• la dernière version est la version 4.1.3 ;

• la dernière version de la version majeure précédente est la version 3.2.4 ;

• la dernière version de la version 1.x est la version 1.5.6.

De nouvelles fonctions rétrocompatibles sont ajoutées en tant que versions mineures de la dernière version. Dans ce cas, la prochaine série de nouvelles fonctions sera ajoutée dans la version 4.2.0.

Des corrections de bogues mineurs rétrocompatibles sont ajoutées en tant que versions de correctifs de la dernière version. Ici, la prochaine série de corrections de bogues mineurs sera ajoutée en tant que version 4.1.4.

Les corrections de bogues majeurs rétrocompatibles sont traitées différemment. Elles sont ajoutées à plusieurs versions :

• Version de correctifs de la dernière version. Ici, il s’agit de la version 4.1.4.

• Version de correctifs de la version mineure précédente. Ici, il s’agit de la version 3.2.5.

• Version de correctifs de la dernière version 1.x. Ici, il s’agit de la version 1.5.7.

Les principales corrections de bogues sont définies par l’équipe produit d’Amazon IVS. Des exemples typiques sont les mises à jour de sécurité critiques et d’autres correctifs nécessaires pour les clients.

Remarque : dans les exemples ci-dessus, les versions publiées s’incrémentent sans ignorer de numéros (par exemple, de 4.1.3 à 4.1.4). En réalité, un ou plusieurs numéros de correctifs peuvent rester internes et ne pas être publiés, de sorte que la version publiée peut s’incrémenter de 4.1.3 à 4.1.6, par exemple.