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.
# Utilisation de canaux élastiques pour organiser des événements en direct dans le cadre des réunions du SDK Amazon Chime
Les canaux élastiques permettent des expériences de chat à grande échelle avec jusqu'à un million de membres. Les utilisations typiques incluent les soirées de surveillance pour des événements sportifs ou politiques. Vous ne pouvez utiliser les canaux élastiques que dans la région de l'est des États-Unis (Virginie du Nord).
Un canal élastique se compose d'un canal unique avec une configuration commune, plus un nombre variable (ou *élastique*) de sous-canaux. La configuration inclut également des seuils minimum et maximum pour les membres des sous-canaux.
Supposons, par exemple, que vous créiez un canal élastique avec 100 sous-canaux et que, pour les sous-canaux, vous définissiez un seuil bas de 500 membres et un seuil élevé de 10 000 membres. Lorsque les utilisateurs rejoignent cet exemple de canal, le système les affecte automatiquement à un seul sous-canal jusqu'à ce que le nombre de membres dépasse 10 000. À ce stade, le système crée un nouveau sous-canal et y ajoute de nouveaux membres. Lorsque les utilisateurs partent, le système supprime les sous-canaux et répartit les membres sur les sous-canaux restants.
La répartition de l'audience entre les sous-canaux permet aux participants de suivre plus facilement les conversations. Les modérateurs ont également réduit leur charge de travail, car ils n'ont besoin de regarder que certaines sous-chaînes. En outre, les modérateurs peuvent utiliser les outils intégrés fournis par les canaux élastiques. Par exemple, les modérateurs peuvent [bannir des utilisateurs](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html) d'une chaîne, [créer des modérateurs](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html) et utiliser les [flux de chaînes](https://docs.aws.amazon.com/chime-sdk/latest/dg/using-channel-flows.html) pour modérer automatiquement tous les messages de la chaîne.
Pour plus d'informations sur les quotas de messagerie du SDK Amazon Chime, reportez-vous à la section Quotas de [messagerie](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) du manuel de référence général du SDK *Amazon Chime*.
**Topics**
+ [Conditions préalables](#elastic-prereqs)
+ [Concepts de canaux élastiques](#elastic-concepts)
+ [Fonctionnalités supplémentaires prises en charge](#additional-features)
+ [Création de canaux élastiques pour les réunions du SDK Amazon Chime](create-elastic-channel.md)
+ [Gestion des membres d'Elastic Channel pour les réunions du SDK Amazon Chime](manage-elastic-members.md)
+ [Envoi de messages Elastic Channel lors des réunions du SDK Amazon Chime](send-messages-elastic.md)
+ [Comprendre les messages WebSocket du système dans les canaux élastiques pour les réunions du SDK Amazon Chime](websocket-messages-elastic.md)
+ [Utilisation des flux Kinesis pour recevoir des messages système pour les réunions du SDK Amazon Chime](elastic-onboard-streams.md)
+ [Test des canaux élastiques pour les réunions du SDK Amazon Chime dans notre application de démonstration](elastic-testing.md)
## Conditions préalables
Pour utiliser les canaux élastiques, vous devez disposer des éléments suivants.
+ Connaissance des fonctionnalités de messagerie du SDK Amazon Chime, telles que la gestion des canaux et l'envoi et la réception de messages.
+ Possibilité d'invoquer la messagerie du SDK Amazon Chime. APIs
## Concepts de canaux élastiques
Pour utiliser efficacement les canaux élastiques, vous devez comprendre ces concepts.
**Sous-canaux**
Les canaux élastiques divisent leurs membres en conteneurs logiques appelés sous-canaux. Lorsque vous ajoutez un `AppInstanceUser` à un canal élastique, l'utilisateur devient membre d'un sous-canal. Cet utilisateur peut envoyer et recevoir des messages, mais uniquement avec les autres membres de ce sous-canal. Le système n'autorise jamais les messages d'un sous-canal à apparaître dans d'autres sous-canaux.
**Mise à l’échelle**
Pour favoriser l'engagement des utilisateurs, chaque sous-canal doit répondre à une exigence minimale d'adhésion. Vous fournissez cette valeur lorsque vous créez un canal élastique. Lorsque les utilisateurs rejoignent ou quittent un événement, le système transfère les membres vers différents sous-canaux, ce qui rend l'ensemble du canal « élastique ». Les sous-canaux exécutent les actions de dimensionnement suivantes.
+ **SCALE\$1OUT** — Lorsqu'une nouvelle demande d'adhésion à un canal Elastic arrive et que tous les sous-canaux sont pleins, le système évolue en créant un nouveau sous-canal, puis en transférant les adhésions des sous-canaux existants vers le nouveau sous-canal.
+ **SCALE\$1IN** — Lorsque le nombre de membres d'un sous-canal est inférieur au minimum requis et qu'un autre sous-canal a la capacité d'accueillir tous les membres du premier sous-canal, un `SCALE_IN` événement transfère ces adhésions, puis supprime le sous-canal et tous les messages.
Si vous devez accéder aux messages provenant de chaînes supprimées, vous devez d'abord activer le streaming des messages. Pour plus d’informations, consultez [Diffusion de données de messagerie dans la messagerie du SDK Amazon Chime](streaming-export.md).
**Transfert de membre**
Cela se produit lorsque l'équilibrage des membres déplace un canal `AppInstanceUser` d'un sous-canal à un autre. L'`AppInstanceUser`alambic appartient au canal élastique après le transfert. Cependant, le nouveau sous-canal contient des adhésions et des messages différents, de sorte que les messages envoyés par le `AppInstanceUser` après le transfert sont adressés à ces différents membres. L'équilibrage des membres n'affecte pas les adhésions des modérateurs.
**Note**
Les canaux Elastic ne prennent pas en charge les adhésions masquées, les préférences d'adhésion et les horodatages des messages de lecture.
## Fonctionnalités supplémentaires prises en charge
Les canaux élastiques prennent également en charge ces fonctionnalités de messagerie.
+ [Prefetch](websockets.md#prefetch)
+ [Débits des canaux](using-channel-flows.md)
# Création de canaux élastiques pour les réunions du SDK Amazon Chime
Vous utilisez le `ElasticChannelConfiguration` champ de l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html)API pour créer un canal élastique. Une fois que vous avez créé un canal élastique, vous créez des adhésions à un canal.
**Note**
Pour les canaux non élastiques, le canal `AppInstanceUser` qui crée le canal est automatiquement ajouté à ce canal en tant que membre et modérateur. Pour les canaux élastiques, le créateur de la chaîne est uniquement ajouté en tant que modérateur.
Vous ne pouvez pas mettre à `ElasticChannelConfiguration` jour un set unique.
Vous ne pouvez pas mettre à jour un canal d'élastique à un canal non élastique et vice-versa.
Vous ne pouvez pas inclure de liste de membres ARNs dans une demande d'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html)API. Vous pouvez toutefois inclure une liste de modérateurs. ARNs
Vous ne pouvez pas créer de canal élastique `UNRESTRICTED` de type.
# Gestion des membres d'Elastic Channel pour les réunions du SDK Amazon Chime
Pour gérer les membres d'un canal élastique, utilisez les [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelMembership.html)touches [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html), et [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html) APIs. Les informations suivantes expliquent comment les utiliser.
**Abonnements aux chaînes**
L'`CreateChannelMembership`API crée des adhésions au niveau des sous-canaux. Les sous-canaux peuvent inclure des modérateurs et des membres réguliers.
+ **Modérateurs** — Vous pouvez ajouter des modérateurs à plusieurs sous-canaux. Cela permet aux modérateurs d'envoyer des messages sur chacun des sous-canaux auxquels ils appartiennent. Lorsque vous ajoutez un modérateur à une sous-chaîne, vous devez fournir le. `SubChannelId`
Si vous souhaitez attribuer automatiquement des modérateurs à de nouvelles sous-chaînes, vous pouvez [activer le streaming des messages](streaming-export.md), écouter les événements de création de sous-chaînes, puis créer un abonnement de modérateur en réponse à ces événements.
Enfin, vous pouvez supprimer les modérateurs de sous-chaînes spécifiques ou de toutes les sous-chaînes. Vous utilisez l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_DeleteChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_DeleteChannelMembership.html)API dans les deux cas. Pour supprimer un modérateur d'une sous-chaîne spécifique, vous devez fournir le. `SubChannelId` Si vous ne fournissez pas d'identifiant pour une sous-chaîne, le système supprime le modérateur de toutes les sous-chaînes. Enfin, vous pouvez utiliser l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels)API pour répertorier les sous-canaux et le nombre de membres de chacun.
+ **Membres réguliers** : ils constituent la majorité des abonnements aux chaînes. Vous ne pouvez ajouter un membre normal qu'à une seule sous-chaîne. De plus, vous ne pouvez pas transmettre un `SubChannelId` lors de la création ou de la suppression d'abonnements à une chaîne, car le système contrôle le sous-canal dans lequel un abonnement est créé.
**Modérateurs de chaînes**
L'`CreateChannelModerator`API crée des modérateurs au niveau du canal élastique. Les modérateurs peuvent consulter tous les messages dans tous les sous-canaux. Lorsque vous promouvez un membre régulier au poste de modérateur de chaîne, le système supprime toutes les adhésions existantes à la chaîne pour ce membre. Il en va de même lorsque vous rétrogradez un modérateur.
**Interdictions de chaînes**
L'`CreateChannelBan`API crée des interdictions au niveau du canal élastique. Un banni ne `AppInstanceUser` peut appartenir à aucune sous-chaîne. Lorsque vous bannissez un membre, le système supprime toutes les adhésions à la chaîne de ce membre.
# Envoi de messages Elastic Channel lors des réunions du SDK Amazon Chime
L'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SendChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SendChannelMessage.html)API crée des messages au niveau du sous-canal. Pour envoyer des messages, vous devez disposer d'un`subChannelId`. Vous pouvez également utiliser le [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_UpdateChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_UpdateChannelMessage.html)et [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_RedactChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_RedactChannelMessage.html) APIs pour modifier et supprimer des messages, mais dans tous les cas, vous devez disposer d'un`subChannelId`.
**Note**
Les expéditeurs de messages ne peuvent modifier ou biffer des messages que s'ils appartiennent au sous-canal auquel ils envoient des messages. Si l'équilibrage des membres transfère un membre vers un autre sous-canal, ce membre peut uniquement modifier ou expurger les messages qu'il envoie sur ce nouveau sous-canal.
# Comprendre les messages WebSocket du système dans les canaux élastiques pour les réunions du SDK Amazon Chime
Le SDK Amazon Chime envoie des messages système à tous les clients connectés pour les événements qui se déroulent dans les canaux. La liste suivante décrit les messages système pour les canaux élastiques.
**Événements liés aux messages**
Les charges utiles d'événements pour les canaux élastiques contiennent le `subChannelId` champ. Les charges utiles pour les canaux non élastiques restent les mêmes.
**Événements pour les membres**
Les `DELETE_CHANNEL_MEMBERSHIP` événements `CREATE_CHANNEL_MEMBERSHIP` et le `subChannelId` terrain font désormais partie de leur charge utile.
Les canaux élastiques ne prennent pas en charge l'`BATCH_CREATE_CHANNEL_MEMBERHSIP`événement. Lorsque vous appelez l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_BatchCreateChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_BatchCreateChannelMembership.html)API, le système envoie des `CREATE_CHANNEL_MEMBERSHIP` événements individuels.
Vous pouvez désormais utiliser le type d'`UPDATE_CHANNEL_MEMBERSHIP`événement pour signaler les modifications apportées aux informations d'adhésion. Par exemple, lors du transfert d'un membre d'un sous-canal à un autre, le système envoie un `UPDATE_CHANNEL_MEMBERSHIP` événement avec le nouveau `SubChannelId` dans la charge utile pour indiquer que le membre a été transféré.
Le système envoie l'`UPDATE_CHANNEL_MEMBERSHIP`événement uniquement au membre transféré, et non aux autres membres du sous-canal. C'est pourquoi nous vous encourageons à utiliser l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListChannelMemberships.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListChannelMemberships.html)API plutôt que de remplir WebSockets les listes de membres de votre chaîne. Pour plus d’informations, consultez [Utilisation WebSockets pour recevoir des messages dans la messagerie du SDK Amazon Chime](websockets.md).
# Utilisation des flux Kinesis pour recevoir des messages système pour les réunions du SDK Amazon Chime
Vous pouvez configurer un `AppInstance` pour recevoir des données sous forme de flux. Par exemple, un flux peut inclure des messages, des événements de sous-canal et des événements de canal.
Dans ce cadre, nous soutenons les `DELETE_SUB_CHANNEL` événements `CREATE_SUB_CHANNEL` et. Ils indiquent à quel moment une sous-chaîne a été créée ou supprimée dans le cadre de l'équilibrage des membres. Pour plus d'informations sur la réception de flux de données, reportez-vous à[Diffusion de données de messagerie dans la messagerie du SDK Amazon Chime](streaming-export.md).
# Test des canaux élastiques pour les réunions du SDK Amazon Chime dans notre application de démonstration
[Vous pouvez tester toutes les fonctionnalités de messagerie du SDK Amazon Chime sur GitHub /. https://github.com/aws-samples/ amazon-chime-sdk tree/main/apps/chat](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/chat)