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.

Se utiliza WebSockets para recibir mensajes

Puede usar Amazon Chime JS SDK para recibir mensajes o puede usar WebSockets la biblioteca de WebSocket clientes que prefiera.

Siga estos temas en el orden indicado para empezar a WebSockets utilizarlos:

Definir una IAM política

Para empezar, defina una IAM política que le dé permiso para establecer una WebSocket conexión. El siguiente ejemplo de política otorga un AppInstanceUser permiso para establecer una WebSocket conexión.

"Version": "2012-10-17",
"Statement": [
  {
    "Effect": "Allow",
    "Action: [
      "chime:Connect"
    ],
    "Resource": [
      "arn:aws:chime:region:{aws_account_id}:app-instance/{app_instance_id}/user/{app_instance_user_id}"
    ]
 },
 {
    "Effect": "Allow",
    "Action: [
      "chime:GetMessagingSessionEndpoint"
    ],
    "Resource": [
      "*"
    ]
 }
 ]
} 

Recuperación del punto de conexión

En los siguientes pasos se explica cómo recuperar el punto final utilizado en una WebSocket conexión.

Establecimiento de la conexión

Después de recuperar un punto final, utiliza la conexión API para establecer una WebSocket conexión con el servidor SDK back-end de Amazon Chime y recibir mensajes para un. AppInstanceUser Debe usar la versión 4 de AWS Signature para firmar las solicitudes. Para obtener más información sobre la firma de una solicitud, consulte Firmar AWS solicitudes con la versión 4 de firma.

Sintaxis de la solicitud

GET /connect
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIARALLEXAMPLE%2F20201214%2Fregion%2Fchime%2Faws4_request
&X-Amz-Date=20201214T171359Z
&X-Amz-Expires=10
&X-Amz-SignedHeaders=host
&sessionId={sessionId}
&userArn={appInstanceUserArn}
&X-Amz-Signature=db75397d79583EXAMPLE

URIParámetros de solicitud

Todos los parámetros de la consulta de URI solicitud deben estar URL codificados.

X-Amz-Algorithm

Identifica la versión de AWS Signature y el algoritmo que utilizó para calcular la firma. Amazon Chime solo SDK admite la autenticación de la versión 4 de AWS Signature, por lo que su valor es. AWS4-HMAC-SHA256

X-Amz-Credential

Además del identificador de la clave de acceso, este parámetro también proporciona la AWS región y el servicio (el ámbito) para los que es válida la firma. Este valor debe coincidir con el ámbito que utilice en los cálculos de la firma. La forma general para el valor de este parámetro es la siguiente:

<yourAccessKeyId>/<date>/<awsRegion>/<awsService >/aws4_request

Por ejemplo:

AKIAIOSFODNN7EXAMPLE/20201214/us-east-1/chime/aws4_request

X-Amz-Date

El formato de fecha y hora debe seguir el estándar ISO 8601 y usted debe formatearlo como. yyyyMMddTHHmmssZ Por ejemplo, debe convertir 08/01/2020 15:32:41 .982-700 a Hora universal coordinada () y enviarla como. UTC 20200801T083241Z

X-Amz-Signed-Headers

Muestra los encabezados que utilizó para calcular la firma. Los siguientes encabezados son obligatorios para los cálculos de firmas:

X-Amz-Signatures

Proporciona la firma para autenticar la solicitud. Esta firma debe coincidir con la firma que calcula Amazon ChimeSDK. Si no lo hace, Amazon Chime SDK deniega la solicitud. Por ejemplo, 733255ef022bec3f2a8701cd61d4b371f3f28c9f19EXAMPLEd48d5193d7.

X-Amz-Security-Token

Parámetro de credenciales opcional si se utilizan credenciales procedentes del servicio de token de seguridad. Para obtener más información sobre el servicio, consulte la versión más https://docs.aws.amazon.com/STS/reciente de/. APIReference

SessionId

Indica un identificador único para la WebSocket conexión que se está estableciendo.

UserArn

Indica la identidad del AppInstanceUser que intenta establecer una conexión. El valor debe ser el ARN deAppInstanceUser. Por ejemplo, arn:aws:chime:us%2Deast%2D1:123456789012:app%2Dinstance/694d2099%2Dcb1e%2D463e%2D9d64%2D697ff5b8950e/user/johndoe .

Uso de la captura previa para entregar los detalles del canal

Al establecer una WebSocket conexión, puede especificar prefetch-on=connect en la consulta los parámetros para entregar CHANNEL_DETAILS los eventos. La función de captura previa viene con la conexión API y permite a los usuarios ver una vista de chat enriquecida sin llamadas adicionalesAPI. Los usuarios pueden:

Cuando un usuario se conecta con el parámetro de captura previa especificado, recibe el evento de sesión establecida, que indica que se ha establecido la conexión. A continuación, el usuario recibe hasta 50 eventos de CHANNEL_DETAILS. Si el usuario tiene menos de 50 canales, la conexión API busca previamente todos los canales mediante eventos. CHANNEL_DETAILS Si el usuario tiene más de 50 canales, API busca previamente los 50 canales principales que contienen mensajes no leídos y los valores más recientes. LastMessageTimestamp Los eventos de CHANNEL_DETAILS aparecen en orden aleatorio y recibe los eventos de los 50 canales.

Además, la captura previa devuelve lo siguiente para ChannelMessages y ChannelMemberships:

En este ejemplo, puede ver cómo usar prefetch-on=connect.

GET /connect
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIARALLEXAMPLE%2F20201214%2Fregion%2Fchime%2Faws4_request
&X-Amz-Date=20201214T171359Z
&X-Amz-Expires=10
&X-Amz-SignedHeaders=host
&sessionId=sessionId
&prefetch-on=connect
&userArn=appInstanceUserArn
&X-Amz-Signature=db75397d79583EXAMPLE

Este ejemplo muestra la respuesta de un canal. Recibirá respuestas para los 50 canales.

{
   "Headers": { 
        "x-amz-chime-event-type": "CHANNEL_DETAILS", 
        "x-amz-chime-message-type": "SYSTEM" 
        },
   "Payload": JSON.stringify"({
        Channel: ChannelSummary 
        ChannelMessages: List of ChannelMessageSummary  
        ChannelMemberships: List of ChannelMembershipSummary
        ReadMarkerTimestamp: Timestamp 
        ChannelMessagesHasMore: Boolean 
    })
} 

Procesamiento de eventos

Para que un AppInstanceUser reciba mensajes después de establecer una conexión, debe añadirlos a un canal. Para ello, utilice el CreateChannelMembership API.

A AppInstanceAdmin y a ChannelModerator no reciben mensajes en un canal a menos que utilices el CreateChannelMembershipAPIpara añadirlos de forma explícita.

En los siguientes temas se explica cómo procesar eventos.

Descripción de las estructuras de los mensajes

Todos los WebSocket mensajes que recibas tienen este formato:

{
   "Headers": {"key": "value"},
   "Payload": "{\"key\": \"value\"}"
}

Encabezados

Los SDK mensajes de Amazon Chime utilizan las siguientes claves de encabezado:

En la siguiente sección, se enumeran y describen los posibles valores y cargas útiles del encabezado.

Carga

Los mensajes de Websocket devuelven cadenasJSON. La estructura de las JSON cadenas depende de los x-amz-event-type encabezados. En la siguiente tabla se enumeran los posibles valores de x-amz-chime-event-type y cargas:

x-amz-chime-message-tipo

En la tabla siguiente se enumeran los tipos de mensajes de x-amz-chime-message-type.

x-amz-chime-event-motivo

Se trata de un encabezado opcional compatible con un caso de uso específico. El encabezado proporciona información sobre el motivo por el que se recibió un evento específico.

Gestión de desconexiones

Los Websockets se pueden desconectar debido a cambios en la conectividad de la red o cuando las credenciales caduquen. Después de abrir un WebSocket, Amazon Chime SDK envía pings periódicos al cliente de mensajería para asegurarse de que sigue conectado. Si la conexión se cierra, el cliente recibe un código de WebSocket cierre. El cliente puede intentar volver a conectarse o no, según el código de cierre. En las siguientes tablas se muestran los códigos de cierre que el cliente puede usar para volver a conectarse.

En el caso de códigos de cierre de 1000 a 4000, vuelva a conectarse únicamente para los siguientes mensajes:

En el caso de 4 XXX códigos, vuelva a conectarse siempre, excepto en el caso de los siguientes mensajes:

Cuando la aplicación utiliza un código de cierre para volver a conectarse, debe:

Si usa la amazon-chime-sdk-js biblioteca, esto se gestiona automáticamente si implementa la propiedad needsRefresh() y el método refresh (). Para ver un ejemplo práctico, consulta https://github.com/aws-samples/amazon-chime-sdk/blob/dc11c4c76c78d28f618577706bba2087919a5635/apps/chat/src/providers/ .jsx #L93 -L101 AuthProvider.