SDK de messagerie client de chat IVS - Amazon IVS

SDK de messagerie client de chat IVS

Le kit SDK de messagerie client Amazon Interactive Video Services (IVS) Chat 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 fera l'objet de mises à jour, en plus d'Amazon IVS Chat. En tant que kit SDK natif, il est conçu pour minimiser l'impact sur les performances de votre application et sur les appareils avec lesquels vos utilisateurs accèdent à votre application.

Exigences de la plateforme

Navigateurs de bureau

Navigateur Versions prises en charge
Chrome Deux versions principales (la version actuelle et la version la plus récente)
Edge Deux versions principales (la version actuelle et la version la plus récente)
Firefox Deux versions principales (la version actuelle et la version la plus récente)
Opera Deux versions principales (la version actuelle et la version la plus récente)
Safari Deux versions principales (la version actuelle et la version la plus récente)

Navigateurs mobiles

Navigateur Versions prises en charge
Chrome pour Android Deux versions principales (la version actuelle et la version la plus récente)
Firefox pour Android Deux versions principales (la version actuelle et la version la plus récente)
Opera pour Android Deux versions principales (la version actuelle et la version la plus récente)
WebView pour Android Deux versions principales (la version actuelle et la version la plus récente)
Samsung Internet Deux versions principales (la version actuelle et la version la plus récente)
Safari pour iOS Deux versions principales (la version actuelle et la version la plus récente)

Plateformes natives

Plateforme Versions prises en charge
Android 5.0 et versions ultérieures
iOS

13.0 et versions ultérieures

Support

Si vous rencontrez une erreur ou un autre problème avec votre salle de chat, déterminez l'identifiant unique de salle via l'API IVS Chat (voir ListRooms).

Partagez cet identifiant de salle de chat avec l'équipe AWS Support. Il lui permettra d’obtenir des informations pour aider à résoudre votre problème.

Remarque : veuillez consulter la rubrique Notes de mise à jour Chat 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 et vérifiez si cela résout votre problème.

Gestion des versions

Les kits SDK de messagerie client Amazon IVS Chat sont basés sur la gestion sémantique de version.

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.

En outre, la version 1.x sera prise en charge jusqu'à la fin de 2023 ou à la sortie de la version 3.x, selon la situation qui survient en dernier.

API Amazon IVS Chat

Côté serveur (non géré par les kits SDK), il existe deux API, chacune ayant ses propres responsabilités :

  • Plan de données : l'API de messagerie IVS Chat est une API WebSockets conçue pour être utilisée par des applications frontend (iOS, Android, macOS, etc.) qui sont pilotées par un schéma d'authentification basé sur des jetons. À l'aide d'un jeton de chat généré précédemment, vous vous connectez à des salles de chat déjà existantes avec cette API.

    Les kits SDK de messagerie client Amazon IVS Chat sont uniquement concernés par le plan de données. Les kits SDK supposent que vous générez déjà des jetons de chat via votre backend. La récupération de ces jetons est supposée être gérée par votre application frontend, et non par les kits SDK.

  • Plan de contrôle : l'API du plan de contrôle IVS Chat fournit une interface pour que vos applications backend puissent gérer et créer des salles de chat ainsi que les utilisateurs qui les rejoignent. Considérez-la comme le panneau d'administration de l'expérience de chat de votre application, géré par votre backend. Certains points de terminaison du plan de contrôle sont responsables de la création du jeton de chat nécessaire au plan de données pour s'authentifier auprès d'une salle de chat.

    Important : les kits SDK de messagerie client IVS Chat n'appellent aucun point de terminaison du plan de contrôle. Votre backend doit être configuré pour créer des jetons de chat pour vous. Votre application frontend doit communiquer avec votre backend pour récupérer ce jeton de chat.