Amazon Chime SDK ミーティングのライフサイクルイベントについて
Amazon Chime SDK は会議のライフサイクルイベントを送信します。これを使用して通知をトリガーし、ダウンストリームワークフローを開始できます。会議イベントを使用する例をいくつか次に示します。
-
参加者が Amazon Chime SDK ミーティングに参加または退席したときにメタデータを更新する。
-
Amazon Chime SDK ミーティングのプッシュ通知または名簿を実装する。
Amazon Chime SDK ミーティングでの動画およびコンテンツ共有の使用状況を測定する。
Amazon EventBridge、Amazon Simple Notification Service (SNS)、Amazon Simple Queue Service (SQS) にイベントを送信できます。詳細については、Amazon EventBridge ユーザーガイドの「AWS サービスからのイベント」を参照してください。
Amazon Chime SDK は、新しい会議の開始時に、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、アクティブな会議が終了すると、このイベントを送信します。
注記
効率を高めるため、サービスは DeleteMeeting API を呼び出すときにこのイベントも送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、新しい参加者がアクティブな会議に追加されると、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、ユーザーが DeleteAttendee API を使用して参加者をアクティブな会議から削除すると、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、会議に既に参加しているユーザーが同じ参加トークンを使用して会議に再度参加すると、このイベントを送信します。例えば、ユーザーはデスクトップからモバイルデバイスに切り替えることができます。これにより、会議は事実上新しいデバイスに "引き渡され" ます。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、既存の参加者が指定したネットワークトランスポートを使用して Amazon Chime SDK ミーティングに参加したときに、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、既存の参加者が指定したネットワークトランスポートを使用して Amazon Chime SDK ミーティングから退席したときに、このイベントを送信します。
注記
サービスは、同じ "退出" アクションの chime:AttendeeLeft および chime:AttendeeDroppedイベントを送信しません。途中退席と退出は異なるアクションであり、システムは各アクションに対応するイベントを送信します。
例えば、接続が不十分な参加者が午前 11 時に会議に参加するとします。以下のアクションが実行されることを予想できます。
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
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、現在の参加者が Amazon Chime SDK ミーティングから途中退席したときに、このイベントを送信します。これは通常、接続が不十分な場合に起こります。サービスが 10～15 秒間パケットを受信しない場合、途中退席したクライアントが考慮され、イベントが発行されます。
サービスは通常、ドロップアクションをトリガーしますが、クライアントもドロップアクションをトリガーできます。例えば、ユーザーがノート PC を Wi-Fi からイーサネットに切り替えたとします。これはネットワークアダプターの変更であり、接続はリセットされます。次いで、WebSocket がリセットされ、drop および join の結合アクションがトリガーされます。
注記
サービスは、同じ "退出" アクションの chime:AttendeeLeft および chime:AttendeeDroppedイベントを送信しません。途中退席と退出は異なるアクションであり、システムは各アクションに対応するイベントを送信します。
例えば、接続が不十分な参加者が午前 11 時に会議に参加するとします。以下のアクションが実行されることを予想できます。
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
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、既存の参加者が動画ストリームを開始したときに、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、既存の参加者が動画ストリームを停止したときに、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、既存の参加者が画面の共有を開始したときに、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、既存の参加者が画面の共有を停止したときに、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、既存の出席者の機能が更新されたときにこのイベントを送信します。
例 イベントデータ
{ "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" } } }
Amazon Chime SDK は、指定したネットワークトランスポートを使用してコンテンツ共有が Amazon Chime SDK ミーティングに参加したときに、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、指定したネットワークトランスポートを使用してコンテンツ共有が Amazon Chime SDK ミーティングから退席したときに、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、コンテンツ共有が Amazon Chime SDK ミーティングから切断されたときにこのイベントを送信します。これは通常、低帯域幅が原因で生じます。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、コンテンツ共有がビデオのストリーミングを開始すると、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}Amazon Chime SDK は、コンテンツ共有がビデオのストリーミングを停止すると、このイベントを送信します。
例 イベントデータ
次の例は、このイベントのデータを示しています。
{
"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"
}
}