Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Uso de canales elásticos para organizar eventos en directo en las reuniones de Amazon Chime SDK
Los canales elásticos admiten experiencias de chat a gran escala con hasta 1 millón de miembros. Los usos típicos incluyen ver fiestas para eventos deportivos o políticos. Puede utilizar canales elásticos solo en la región este de EE. UU. (Norte de Virginia).
Un canal elástico consta de un único canal con una configuración común, además de un número variable (o *elástico*) de subcanales. La configuración también incluye los umbrales mínimo y máximo para los miembros de los subcanales.
Por ejemplo, supongamos que crea un canal elástico con 100 subcanales y, para los subcanales, establece un umbral inferior de 500 miembros y un umbral superior de 10 000 miembros. Cuando los usuarios se unen a este canal de ejemplo, el sistema los asigna automáticamente a un único subcanal hasta que el número de miembros supere los 10 000. En ese momento, el sistema crea un nuevo subcanal y añade allí a los nuevos miembros. Cuando los usuarios se van, el sistema elimina los subcanales y distribuye a los miembros entre los subcanales restantes.
Dividir la audiencia en subcanales facilita el seguimiento de las conversaciones por parte de los participantes. Los moderadores también han reducido la carga de trabajo, ya que solo necesitan ver algunos de los subcanales. Además, los moderadores pueden utilizar las herramientas integradas que proporcionan los canales elásticos. Por ejemplo, los moderadores pueden [prohibir el acceso de los usuarios](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html) a un canal, [crear moderadores](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html) y utilizar los [flujos del canal](https://docs.aws.amazon.com/chime-sdk/latest/dg/using-channel-flows.html) para moderar automáticamente todos los mensajes del canal.
Para obtener más información sobre las cuotas de mensajería de Amazon Chime SDK, consulte [Cuotas de mensajería](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) en la *Referencia general de Amazon Chime SDK*.
**Topics**
+ [
## Requisitos previos
](#elastic-prereqs)
+ [
## Conceptos sobre los canales elásticos
](#elastic-concepts)
+ [
## Características admitidas adicionales
](#additional-features)
+ [
# Creación de canales elásticos para las reuniones de Amazon Chime SDK
](create-elastic-channel.md)
+ [
# Administración de miembros de un canal elástico para las reuniones de Amazon Chime SDK
](manage-elastic-members.md)
+ [
# Envío de mensajes de canal elástico en las reuniones de Amazon Chime SDK
](send-messages-elastic.md)
+ [
# Descripción de los mensajes WebSocket del sistema en los canales elásticos para las reuniones del SDK de Amazon Chime
](websocket-messages-elastic.md)
+ [
# Uso de transmisiones de Kinesis para recibir mensajes del sistema para las reuniones de Amazon Chime SDK
](elastic-onboard-streams.md)
+ [
# Pruebas de canales elásticos para las reuniones de Amazon Chime SDK en nuestra aplicación de demostración
](elastic-testing.md)
## Requisitos previos
Debe tener lo siguiente para usar canales elásticos.
+ Conocimiento de las funciones de mensajería de Amazon Chime SDK, como la administración de canales y el envío y la recepción de mensajes.
+ La capacidad de invocar la mensajería del SDK de Amazon Chime. APIs
## Conceptos sobre los canales elásticos
Para utilizar los canales elásticos de forma eficaz, debe comprender estos conceptos:
**Subcanales**
Los canales elásticos dividen sus miembros en contenedores lógicos denominados subcanales. Al añadir un `AppInstanceUser` a un canal elástico, el usuario pasa a ser miembro de un subcanal. Ese usuario puede enviar y recibir mensajes, pero solo con otros miembros de ese subcanal. El sistema nunca permite que los mensajes de un subcanal aparezcan en otros subcanales.
**Escalado**
Para fomentar la participación de los usuarios, todos los subcanales deben cumplir un requisito mínimo de membresía. Al crear un canal elástico, aporta ese valor. A medida que los usuarios se unen a un evento o lo abandonan, el sistema transfiere a los miembros a diferentes subcanales, lo que hace que el canal en general sea “elástico”. Los subcanales ejecutan las siguientes acciones de escalado.
+ **SCALE\$1OUT**: cuando se recibe una nueva solicitud de membresía en un canal elástico y todos los subcanales están llenos, el sistema se amplía creando un nuevo subcanal y, a continuación, transfiriendo las membresías de los subcanales existentes al nuevo subcanal.
+ **SCALE\$1IN**: cuando el número de miembros de un subcanal es inferior al mínimo requerido y otro subcanal tiene la capacidad de alojar a todos los miembros del primer subcanal, un evento de `SCALE_IN` transfiere esas membresías y, a continuación, elimina el subcanal y todos los mensajes.
Si necesita acceder a los mensajes de los canales que se han eliminado, primero debe activar la transmisión de mensajes. Para obtener más información, consulta [Transmisión de datos de mensajería en la mensajería de Amazon Chime SDK](streaming-export.md).
**Transferencia de miembros**
Esto ocurre cuando el equilibrio de miembros se mueve y mueve un `AppInstanceUser` de un subcanal a otro. El `AppInstanceUser` aún pertenece al canal elástico después de la transferencia. Sin embargo, el nuevo subcanal contiene diferentes membresías y mensajes, por lo que los mensajes enviados por el `AppInstanceUser` después de la transferencia van a parar a esos distintos miembros. El equilibrio de las membresías no afecta a las membresías de los moderadores.
**nota**
Los canales elásticos no admiten membresías ocultas, preferencias de membresía ni marcas horarias de lectura de mensajes.
## Características admitidas adicionales
Los canales elásticos también admiten estas características de mensajería.
+ [Captura previa](websockets.md#prefetch)
+ [Flujos de canales](using-channel-flows.md)
# Creación de canales elásticos para las reuniones de Amazon Chime SDK
El campo `ElasticChannelConfiguration` de la API [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) se utiliza para crear un canal elástico. Una vez que se crea un canal elástico, se crean las membresías del canal.
**nota**
En el caso de los canales no elásticos, el `AppInstanceUser` que crea el canal se añade automáticamente a ese canal como miembro y moderador. En el caso de los canales elásticos, el creador del canal solo se añade como moderador.
No se puede actualizar un `ElasticChannelConfiguration` después de establecerse.
No se puede actualizar un canal de elástico a no elástico y viceversa.
No puede incluir una lista de miembros ARNs en una solicitud de [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. Sin embargo, puedes incluir una lista de moderadores. ARNs
No puede crear un tipo `UNRESTRICTED` de canal elástico.
# Administración de miembros de un canal elástico para las reuniones de Amazon Chime SDK
Para gestionar los miembros de un canal elástico, utilice las opciones [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), y [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. La siguiente información explica como usarlas.
**Membresías de canal**
La API `CreateChannelMembership` crea membresías a nivel de subcanal. Los subcanales pueden incluir moderadores y miembros habituales.
+ **Moderadores**: puede añadir moderadores a varios subcanales. Esto permite a los moderadores enviar mensajes en cada uno de los subcanales a los que pertenecen. Cuando agrega un moderador a un subcanal, debe proporcionar el `SubChannelId`.
Si quiere asignar moderadores a los nuevos subcanales automáticamente, puede [habilitar la transmisión de mensajes](streaming-export.md), escuchar los eventos de creación de subcanales y, después, crear una membresía de moderador en respuesta a esos eventos.
Por último, puede eliminar a los moderadores de subcanales específicos o de todos los subcanales. Utilizará la API [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) en ambos casos. Para eliminar un moderador de un subcanal específico, debe proporcionar el `SubChannelId`. Si no proporciona un ID para un subcanal, el sistema elimina al moderador de todos los subcanales. Por último, puede usar la API [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) para enumerar los subcanales y el número de miembros de cada uno.
+ **Miembros habituales**: representan la mayoría de los miembros del canal. Solo puede añadir un miembro habitual a un subcanal. Además, no puede pasar un número `SubChannelId` al crear o eliminar las membresías de un canal, ya que el sistema controla en qué subcanal se crea una membresía.
**Moderadores del canal**
La API `CreateChannelModerator` crea moderadores a nivel de canal elástico. Los moderadores pueden ver todos los mensajes de todos los subcanales. Al ascender a un miembro habitual a moderador del canal, el sistema elimina todas las membresías del canal existentes para ese miembro. Lo mismo ocurre cuando se degrada a un moderador.
**Prohibiciones de canal**
La API `CreateChannelBan` crea prohibiciones a nivel de canal elástico. Un `AppInstanceUser` prohibido no puede pertenecer a ningún subcanal. Cuando expulsa a un miembro, el sistema elimina todas las membresías del canal de ese miembro.
# Envío de mensajes de canal elástico en las reuniones de Amazon Chime SDK
La API [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) crea mensajes a nivel de subcanal. Para enviar mensajes, debe tener un `subChannelId`. También puede usar [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), y [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 para editar y eliminar mensajes, pero en todos los casos, debe tener un`subChannelId`.
**nota**
Los remitentes de los mensajes solo pueden editar o redactar los mensajes si pertenecen al subcanal al que envían los mensajes. Si al equilibrar el número de miembros se transfiere a un miembro a otro subcanal, ese miembro solo podrá editar o redactar los mensajes que envíe en ese nuevo subcanal.
# Descripción de los mensajes WebSocket del sistema en los canales elásticos para las reuniones del SDK de Amazon Chime
Amazon Chime SDK envía mensajes del sistema a todos los clientes conectados para los eventos que tienen lugar en los canales. La siguiente lista describe los mensajes de sistema para los canales elásticos.
**Eventos de mensaje**
Las cargas útiles de eventos para los canales elásticos contienen el campo `subChannelId`. Las cargas útiles para los canales no elásticos siguen siendo las mismas.
**Eventos de membresía**
Los eventos `CREATE_CHANNEL_MEMBERSHIP` y`DELETE_CHANNEL_MEMBERSHIP` ahora tienen el campo `subChannelId` entre sus cargas útiles.
Los canales elásticos no admiten el evento `BATCH_CREATE_CHANNEL_MEMBERHSIP`. Cuando llama a la API [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) el sistema envía eventos individuales `CREATE_CHANNEL_MEMBERSHIP`.
Ahora puede usar el tipo de evento `UPDATE_CHANNEL_MEMBERSHIP` para indicar cambios en la información de membresía. Por ejemplo, durante la transferencia de un miembro de un subcanal a otro, el sistema envía un evento `UPDATE_CHANNEL_MEMBERSHIP` con el nuevo `SubChannelId` en la carga útil para indicar que el miembro se ha transferido.
El sistema solo envía el evento `UPDATE_CHANNEL_MEMBERSHIP` al miembro que se ha transferido y no a otros miembros del subcanal. Por este motivo, le recomendamos que utilice la [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 en lugar de rellenar WebSockets las listas de miembros de su canal. Para obtener más información, consulta [Uso WebSockets para recibir mensajes en la mensajería del SDK de Amazon Chime](websockets.md).
# Uso de transmisiones de Kinesis para recibir mensajes del sistema para las reuniones de Amazon Chime SDK
Puede configurar un `AppInstance` y recibir datos en forma de transmisión. Por ejemplo, una transmisión puede incluir mensajes, eventos de subcanal y eventos de canal.
Como parte de eso, ofrecemos soporte para los eventos `CREATE_SUB_CHANNEL` y `DELETE_SUB_CHANNEL`. Indican cuándo se creó o eliminó un subcanal como parte del equilibrio de miembros. Para obtener más información sobre la recepción de flujos de datos, consulte [Transmisión de datos de mensajería en la mensajería de Amazon Chime SDK](streaming-export.md).
# Pruebas de canales elásticos para las reuniones de Amazon Chime SDK en nuestra aplicación de demostración
[Puede probar todas las funciones de mensajería del SDK de Amazon Chime GitHub en https://github.com/aws-samples/amazon-chime-sdk/. tree/main/apps/chat](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/chat)