会議イベント - 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 ユーザーガイド」の「 AWSのサービスからのイベント」を参照してください。 EventBridge

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 AND 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 秒間パケットを受信しない場合、 は、cient がドロップしたと見なし、イベントを発行します。

サービスは通常、ドロップアクションをトリガーしますが、クライアントはアクションをトリガーすることもできます。例えば、ユーザーがラップトップを Wi-Fi からイーサネットに切り替えたとします。これにより、ネットワークアダプタが変更され、接続がリセットされます。次に、WebSocket をリセットし、結合されたドロップ結合アクションをトリガーします。

注記

このサービスは、同じ「リーブ」アクションの chime:AttendeeLeft AND 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" } }