Comprendre les événements liés au cycle de vie d'Amazon SDK Chime

L'Amazon Chime SDK envoie les événements du cycle de vie des réunions, que vous pouvez utiliser pour déclencher des notifications et lancer des flux de travail en aval. Voici quelques exemples d'utilisation des événements de réunion :

• Mise à jour des métadonnées lorsqu'un participant rejoint ou quitte une réunion Amazon SDK Chime.

• Implémentation de notifications push ou de listes pour une réunion Amazon SDK Chime.

• Mesurer l'utilisation des vidéos et du partage de contenu lors des réunions Amazon Chime. SDK

Vous pouvez envoyer des événements à Amazon EventBridge, Amazon Simple Notification Service (SNS) et Amazon Simple Queue Service (SQS). Pour plus d'informations, reportez-vous à la section Événements liés AWS aux services dans le guide de EventBridge l'utilisateur Amazon.

Début de la réunion Amazon Chime SDK

L'Amazon Chime SDK envoie cet événement lorsqu'une nouvelle réunion commence.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:MeetingStarted",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",    
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Fin de la réunion Amazon Chime SDK

L'Amazon Chime SDK envoie cet événement à la fin d'une réunion active.

Note

Pour des raisons d'efficacité, le service envoie également cet événement lorsque vous appelez le DeleteMeeting API.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:MeetingEnded",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",    
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Un SDK participant à Amazon Chime est ajouté

L'Amazon Chime SDK envoie cet événement lorsqu'un nouveau participant est ajouté à une réunion active.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeAdded",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Le SDK participant à Amazon Chime est supprimé

L'Amazon Chime SDK envoie cet événement lorsque vous utilisez DeleteAttendeeAPIpour retirer un participant d'une réunion en cours.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeDeleted",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Le SDK participant à Amazon Chime est autorisé

L'Amazon Chime SDK envoie cet événement lorsqu'un utilisateur, déjà joint à la réunion, utilise le même jeton de participation pour rejoindre à nouveau la réunion. Par exemple, un utilisateur peut passer d'un ordinateur de bureau à un appareil mobile. Cela « transfère » efficacement la réunion au nouvel appareil.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeAuthorized",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Un SDK participant à Amazon Chime rejoint une réunion

L'Amazon Chime SDK envoie cet événement lorsqu'un participant existant rejoint une SDK réunion Amazon Chime en utilisant le transport réseau spécifié.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeJoined",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",    
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Un SDK participant à Amazon Chime quitte une réunion

L'Amazon Chime SDK envoie cet événement lorsqu'un participant existant quitte une SDK réunion Amazon Chime en utilisant le transport réseau spécifié.

Note

Le service n'envoie jamais d'chime:AttendeeLeftANDchime:AttendeeDroppedévénements pour la même action de « départ ». Déposer et partir sont des actions différentes, et le système envoie l'événement correspondant à chaque action.

Par exemple, supposons qu'un participant dont la connexion est mauvaise rejoigne une réunion à 11 heures. Vous pouvez vous attendre aux actions suivantes :

11:00 API – CreateAttendee, CreateMeetingWithAttendee, or BatchCreateAttendee
11:00   Event – chime:AttendeeAdded
11:01 Action – user joins meeting
11:01   Event – chime:AttendeeJoined
11:02 Action – user's connection drops
11:02   Event – chime:AttendeeDropped
11:03 Action – user's connection restored
11:03   Event – chime:AttendeeJoined
11:30 Action – user leaves meeting
11:30   Event – chime:AttendeeLeft

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeLeft",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Un SDK participant à Amazon Chime est retiré d'une réunion

L'Amazon Chime SDK envoie cet événement lorsqu'un participant actuel est exclu d'une SDK réunion Amazon Chime, généralement en raison d'une mauvaise connexion. Lorsque le service ne reçoit pas de paquets pendant 10 à 15 secondes, il considère que le client a été abandonné et émet l'événement.

Le service déclenche généralement des actions de suppression, mais les clients peuvent également les déclencher. Supposons, par exemple, qu'un utilisateur passe de son ordinateur portable du Wi-Fi à l'Ethernet. Cela constitue un changement d'adaptateur réseau et la connexion est réinitialisée. À son tour, cela réinitialise le websocket et déclenche une action combinée de jointure directe.

Note

Le service n'envoie jamais d'chime:AttendeeLeftANDchime:AttendeeDroppedévénements pour la même action de « départ ». Déposer et partir sont des actions différentes, et le système envoie l'événement correspondant à chaque action.

Par exemple, supposons qu'un participant dont la connexion est mauvaise rejoigne une réunion à 11 heures. Vous pouvez vous attendre aux actions suivantes :

11:00 API – CreateAttendee, CreateMeetingWithAttendee, or BatchCreateAttendee
11:00   Event – chime:AttendeeAdded
11:01 Action – user joins meeting
11:01   Event – chime:AttendeeJoined
11:02 Action – user's connection drops
11:02   Event – chime:AttendeeDropped
11:03 Action – user's connection restored
11:03   Event – chime:AttendeeJoined
11:30 Action – user leaves meeting
11:30   Event – chime:AttendeeLeft

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeDropped",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",  
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Un SDK participant à Amazon Chime commence à diffuser une vidéo

L'Amazon Chime SDK envoie cet événement lorsqu'un participant existant commence à diffuser une vidéo.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeVideoStarted",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Un SDK participant à Amazon Chime arrête de diffuser une vidéo

L'Amazon Chime SDK envoie cet événement lorsqu'un participant existant arrête de diffuser une vidéo.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeVideoStopped",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Un SDK participant à Amazon Chime commence à partager son écran

L'Amazon Chime SDK envoie cet événement lorsqu'un participant existant commence à partager son écran.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentJoined",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Un SDK participant à Amazon Chime arrête de partager son écran

L'Amazon Chime SDK envoie cet événement lorsqu'un participant existant arrête de partager son écran.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentLeft",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Fonctionnalités d'Amazon Chime mises à jour pour les SDK participants

L'Amazon Chime SDK envoie cet événement lorsque les capacités d'un participant existant sont mises à jour.

Exemple Données d’événement

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",
  "id": "12345678-1234-1234-1234-111122223333",
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": [],
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeCapabilitiesUpdated",
    "success": "1", // value can be 1 or 0. 1 means success, 0 means failure
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "mymeeting",
    "attendeeId": "attendeeId",
    "externalUserId": "externalUserId"
    "mediaRegion": "us-east-1"
    "attendeeCapabilities": {
    "audio": "SendReceive",
    "video": "SendReceive",
    "content": "SendReceive"
   }
  }
}

Le contenu d'un SDK participant à Amazon Chime rejoint une réunion

Amazon Chime SDK envoie cet événement lorsqu'un partage de contenu rejoint une réunion Amazon SDK Chime en utilisant le transport réseau spécifié.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentJoined",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Le contenu d'un SDK participant à Amazon Chime quitte une réunion

L'Amazon Chime SDK envoie cet événement lorsqu'un partage de contenu quitte une réunion Amazon SDK Chime en utilisant le transport réseau spécifié.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentLeft",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Le contenu d'un SDK participant à Amazon Chime disparaît d'une réunion

L'Amazon Chime SDK envoie cet événement lorsqu'un partage de contenu est perdu lors d'une réunion Amazon SDK Chime, généralement en raison d'une faible bande passante.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentDropped",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "networkType": "Voip",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Le contenu des SDK participants à Amazon Chime commence à diffuser des vidéos

L'Amazon Chime SDK envoie cet événement lorsqu'un partage de contenu commence à diffuser une vidéo.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333",  
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentVideoStarted",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}

Le contenu des SDK participants à Amazon Chime arrête de diffuser des vidéos

L'Amazon Chime SDK envoie cet événement lorsqu'un partage de contenu arrête de diffuser des vidéos.

Exemple Données d’événement

L'exemple suivant montre les données de cet événement.

{
  "version": "0",
  "source": "aws.chime",
  "account": "111122223333", 
  "region": "us-east-1",
  "detail-type": "Chime Meeting State Change",
  "time": "yyyy-mm-ddThh:mm:ssZ",
  "resources": []
  "detail": {
    "version": "0",
    "eventType": "chime:AttendeeContentVideoStopped",
    "timestamp": 12344566754,
    "meetingId": "87654321-4321-4321-1234-111122223333",
    "attendeeId": "87654321-4321-4321-1234-111122223333",
    "externalUserId": "87654321-4321-4321-1234-111122223333",
    "externalMeetingId": "87654321-4321-4321-1234-111122223333",
    "mediaRegion": "us-east-1"
  }
}