Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Kit SDK du lecteur Amazon IVS
Pour utiliser Amazon Interactive Video Service (IVS), vous devez utiliser le lecteur Amazon IVS. Le lecteur est une suite multiplateforme de kits SDK pour la lecture des flux Amazon IVS. Il est conçu pour tirer parti de l’architecture Amazon IVS et est optimisé pour la lecture d’Amazon IVS.
Le seul lecteur dont nous pouvons garantir les performances est le lecteur Amazon IVS. Le lecteur Amazon IVS est requis pour obtenir une faible latence.
Les principales caractéristiques du lecteur Amazon IVS sont les suivantes :
-
ltra-low-latency Streaming U — Une faible latence est un élément essentiel pour créer de bonnes expériences utilisateur interactives qui enrichissent l'expérience du public. La latence se glisse de manière incrémentielle tout au long du chemin de transmission entre le diffuseur et l’utilisateur, ce qui influe sur la réactivité.
La nd-to-end latence E est le délai entre le moment où une diffusion en direct est capturée par la caméra et le moment où elle apparaît sur l'écran du spectateur. Amazon IVS est conçu pour offrir une end-to-end latence extrêmement faible (moins de cinq secondes, selon le lieu de diffusion et les paramètres du diffuseur). Le lecteur Amazon IVS est requis pour obtenir une faible latence..
-
Cohérence multiplateforme — Les utilisateurs regardent des émissions sur des plateformes diverses et variées. Le lecteur Amazon IVS offre à tous les utilisateurs une expérience similaire aussi bien sur les appareils mobiles que sur les navigateurs web. Cette cohérence est possible car chaque plateforme utilise la même bibliothèque de fonctions de lecteur. La bibliothèque du lecteur fait partie intégrante de l’architecture Amazon IVS. L’utilisation d’une pile de vidéos garantit que tous les comportements de lecture vidéo, y compris le mode à faible latence, les métadonnées temporisées, l’analytique, le suivi des erreurs, les rapports et la journalisation, sont disponibles de manière cohérente sur toutes les plateformes prises en charge.
-
Streaming à débit adaptatif : le lecteur Amazon IVS utilise des algorithmes de streaming à débit adaptatif optimisés pour les environnements à faible latence. Il mesure la qualité du service et la disponibilité de la bande passante en temps réel et adapte la qualité de la vidéo et les niveaux de mémoire tampon afin de fournir une lecture ininterrompue. Lorsque la qualité de la connexion baisse, le streaming à débit adaptatif passe à un débit binaire inférieur. Lorsque la qualité de la connexion s’améliore, il passe à un débit plus élevé.
-
Métadonnées temporisées : le lecteur Amazon IVS prend en charge les métadonnées temporisées, qui peuvent être utilisées pour créer des éléments interactifs tels que des sondages et des questionnaires. Les métadonnées sont un ensemble de données qui décrit et fournit des informations sur d’autres données. Avec les métadonnées « temporisées », un code horaire accompagne la donnée sur le flux. Pendant la lecture, le code horaire sert de point de repère pour déclencher une action basée sur les données, par exemple :
-
envoi des statistiques d’un lecteur pour un flux sportif ;
-
envoi des détails produit pour un flux de vente en direct ;
-
envoi de questions pour un flux de quiz en direct.
-
-
Gestion des erreurs robuste — La gestion des erreurs transitoires évite les interruptions dans l’expérience de l’utilisateur. La gestion robuste des erreurs du lecteur Amazon IVS détecte de nombreuses erreurs de streaming potentielles et bascule automatiquement vers un rendu alternatif. Les utilisateurs continuent de regarder la diffusion sans interruption, sans avoir à prendre d’action corrective.
-
Intégration simple : l’API du lecteur Amazon IVS comble le fossé entre les applications des clients Amazon IVS et la bibliothèque du lecteur. L’API a des liaisons pour toutes les plateformes prises en charge, ce qui facilite l’intégration du lecteur dans les applications lors de l’utilisation d’environnements et de techniques de codage courants. Les clients disposent d’un contrôle total sur les éléments de l’interface utilisateur. Ils peuvent ainsi personnaliser les aspects de la marque et de la présentation de leurs applications.
Le lecteur Amazon IVS ne prend pas en charge la projection via Airplay. La projection avec Chromecast peut être implémentée en dehors du lecteur à l’aide des applications de récepteur Chromecast par défaut. Cependant, la latence de ces applications est supérieure à celle du SDK du lecteur Amazon IVS, donc le basculement risque de provoquer quelques à-coups. Consultez également notre documentation sur le SDK de diffusion Amazon IVS : pour le streaming à faible latence et pour streaming en temps réel.
Prérequis pour le navigateur et la plateforme
Pour plus de détails sur les dernières versions de différents navigateurs, voir :
Bien qu’Amazon IVS puisse fonctionner avec certains navigateurs plus anciens, nous ne corrigeons pas les bogues liés aux anciens navigateurs.
Le SDK du lecteur Web IVS (y compris les intégrations Video.js et Player JW) n’est pas pris en charge dans les environnements de type navigateur. Cela inclut les appareils natifs WebViews et les « appareils de 10 pieds » (téléviseurs, consoles, décodeurs) compatibles avec les applications Web. Veuillez contacter le support IVS si vous n’êtes pas sûr de la prise en charge d’un navigateur spécifique qui ne se trouve pas dans les tableaux ci-dessous.
Navigateurs de bureau
| Navigateur de bureau | 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) | 44.0 et versions ultérieures (En mode qualité automatique sur l’ancienne version Microsoft Edge |
| Safari | macOS | Deux versions principales (la version actuelle et la version la plus récente) (En mode qualité automatique sur Safari pour macOS 14 et versions ultérieures, le lecteur IVS 1.3.0 et versions ultérieures prend en charge la lecture à ultra-faible latence. Pour les versions antérieures de Safari et du lecteur IVS, seule la lecture à latence normale est prise en charge. Voir ci-dessus pour le « mode qualité automatique ».) |
Navigateurs mobiles
| Navigateur mobiles | Versions prises en charge |
|---|---|
| Chrome pour iOS, Safari pour iOS | Deux versions principales (la version actuelle et la version la plus récente) (La lecture à latence ultra-faible n’est pas prise en charge. La lecture à latence normale est prise en charge. Cette contrainte s’applique à tous les navigateurs pour iOS.) (Les métadonnées temporisées sont prises en charge uniquement dans les versions 1.3.0 et ultérieures du lecteur.) |
| Chrome pour iPadOS, Safari pour iPadOS | Deux versions principales (la version actuelle et la version la plus récente) (Lorsque « Version pour mobile » est sélectionné :
|
| Chrome pour Android | Deux versions principales (la version actuelle et la version la plus récente) |
Plateformes natives
| Plateforme | Versions prises en charge | Appareils pris en charge |
|---|---|---|
| Android | 5.0 (Lollipop) et une versions ultérieures | Téléphones et tablettes |
| iOS | 12.0 et versions ultérieures | Tous |
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.
Réduire la latence des lecteurs tiers
Pour les types de canaux de base et standard : pour la latence la plus faible possible, vous devez utiliser le lecteur Amazon IVS. Dans les lecteurs tiers (y compris iOS Safari), vous pouvez réduire la latence à environ 10 secondes en utilisant la configuration suivante :
-
Réglez l’intervalle d’images-clés de votre encodeur (par exemple OBS) sur deux secondes ou moins.
-
Ajoutez
?keyframeInterval=2à l’URL RTMP(S). Par exemple :rtmps://a1b2c3d4e5f6.global-contribute.live-video.net:443/app/sk_us-west-2_abcd1234efgh5678ijkl?keyframeInterval=2
Remarque : l’intervalle d’images-clés spécifié dans le cadre de l’URL RTMP doit être supérieur ou égal à la valeur configurée dans l’encodeur ; sinon, vous risquez de rencontrer des problèmes de lecture. Vous pouvez définir la valeur sur n’importe quel entier compris entre 2 et 6 inclus, mais 2 assure la latence la plus faible.
Pour les types de canaux avancés : les instructions ci-dessus ne s’appliquent pas. Les types de canaux avancés génèrent automatiquement des intervalles d’images-clés pour améliorer l’efficacité de l’encodage, avec un intervalle d’au plus 2 secondes entre les images-clés, quel que soit le paramètre d’intervalle entre les images-clés du codage source.
iOS Safari
Dans iOS Safari, vous pouvez réduire la latence à environ 6 à 8 secondes en utilisant le lecteur IVS et en le configurant pour qu’il fasse appel à un service worker. Consultez Configurer un service worker dans le SDK du lecteur : Guide Web pour obtenir des informations détaillées sur l’implémentation ainsi qu’un exemple de référence.
Remarque : pour obtenir la latence la plus faible, il faut un flux IVS dont l’intervalle entre les images clés est défini sur 2 secondes.
Lecture audio uniquement
Tous les types de canaux IVS prennent en charge les rendus uniquement audio. Cela peut être particulièrement utile pour les applications mobiles. Par exemple, dans votre application mobile, vous pouvez faire passer le lecteur au rendu audio uniquement lorsque l'utilisateur exécute l'application en arrière-plan afin d'économiser de la bande passante.
Pour les chaînes ADVANCED-SD et ADVANCED-HD, le rendu audio uniquement est automatiquement inclus dans la liste de lecture multivariante. Pour les canaux BASIC et STANDARD, vous devez ajouter le paramètre de ?allow_audio_only=true requête à l'URL de lecture pour permettre l'inclusion du rendu uniquement audio.
Remarque : Le SDK du lecteur Web IVS ne prend en charge la lecture audio que dans les versions 1.24.0 et ultérieures.
Support
Si vous rencontrez une erreur de lecture ou un autre problème de lecture avec votre flux, déterminez l’identifiant de séance de lecture unique via l’API du lecteur.
| Pour ce lecteur Amazon IVS : | Utilisez : |
|---|---|
| Android | Fonction |
| iOS |
|
| Web | fonction |
Partagez cet identifiant de session de lecture avec l’équipe du support AWS. Il lui permettra d’obtenir des informations pour aider à résoudre votre problème.
Remarque : le lecteur est sans cesse amélioré. 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 votre version du lecteur et vérifiez si cela résout votre problème.
Gestion des versions
Les kits SDK du lecteur 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.
