Amazon Chime SDK会議のライフサイクルイベントについて - Amazon Chime SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Chime SDK会議のライフサイクルイベントについて

Amazon Chime は会議のライフサイクルイベントSDKを送信します。これを使用して通知をトリガーし、ダウンストリームワークフローを開始できます。会議イベントを使用する例をいくつか次に示します。

  • 参加者が Amazon Chime SDK会議に参加または退席したときにメタデータを更新する。

  • Amazon Chime SDK会議のプッシュ通知または名簿の実装。

  • Amazon Chime SDK会議でのビデオとコンテンツ共有の使用状況を測定します。

Amazon 、Amazon Simple Notification Service (SNS) EventBridge、および 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 は、既存の参加者が指定されたネットワークトランスポートを使用して Amazon Chime SDK会議に参加するときに、このイベント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 は、既存の参加者が指定されたネットワークトランスポートを使用して Amazon Chime SDK会議を退席したときに、このイベントSDKを送信します。

注記

サービスは、同じ「leave」アクションのchime:AttendeeLeftANDchime: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 は、通常、接続が不十分なために、現在の参加者が Amazon Chime SDK会議から削除されたときにこのイベントSDKを送信します。サービスが 10~15 秒間パケットを受信しない場合、削除された cient を考慮し、イベントを発行します。

サービスは通常、ドロップアクションをトリガーしますが、クライアントもアクションをトリガーできます。例えば、ユーザーがラップトップを Wi-Fi からイーサネットに切り替えたとします。これはネットワークアダプターの変更を構成し、接続はリセットされます。次に、 はウェブソケットをリセットし、組み合わせたドロップジョイントアクションをトリガーします。

注記

サービスは、同じ「leave」アクションのchime:AttendeeLeftANDchime: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 は、コンテンツ共有が指定されたネットワークトランスポートを使用して Amazon Chime SDK会議を退出するときに、このイベント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 は、コンテンツ共有が Amazon Chime SDK会議から切断されたときに、通常、低帯域幅が原因でこのイベント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" } }