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

# Amazon Chime SDK ミーティングのライフサイクルイベントについて
<a name="using-events"></a>

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 「サービスからのイベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)」を参照してください。

## Amazon Chime SDK ミーティングの開始
<a name="sdk-start-mtg"></a>

Amazon Chime SDK は、新しい会議の開始時に、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 ミーティングの終了
<a name="sdk-end-mtg"></a>

Amazon Chime SDK は、アクティブな会議が終了すると、このイベントを送信します。

**注記**  
効率を高めるため、サービスは [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteMeeting.html) API を呼び出すときにこのイベントも送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者の追加
<a name="sdk-add-attendee"></a>

Amazon Chime SDK は、新しい参加者がアクティブな会議に追加されると、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者の削除
<a name="sdk-remove-attendee"></a>

Amazon Chime SDK は、ユーザーが [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_DeleteAttendee.html) API を使用して参加者をアクティブな会議から削除すると、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者の許可
<a name="sdk-auth-attendee"></a>

Amazon Chime SDK は、会議に既に参加しているユーザーが同じ参加トークンを使用して会議に再度参加すると、このイベントを送信します。例えば、ユーザーはデスクトップからモバイルデバイスに切り替えることができます。これにより、会議は事実上新しいデバイスに "引き渡され" ます。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者の会議への参加
<a name="sdk-join-attendee"></a>

Amazon Chime SDK は、既存の参加者が指定したネットワークトランスポートを使用して Amazon Chime SDK ミーティングに参加したときに、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者の会議からの退席
<a name="sdk-leave-attendee"></a>

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
```

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者の会議からの途中退席
<a name="sdk-drop-attendee"></a>

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
```

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者による動画ストリームの開始
<a name="sdk-attendee-video-start"></a>

Amazon Chime SDK は、既存の参加者が動画ストリームを開始したときに、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者による動画ストリームの停止
<a name="sdk-attendee-video-stop"></a>

Amazon Chime SDK は、既存の参加者が動画ストリームを停止したときに、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者による共有画面の開始
<a name="sdk-attendee-screenshare-start"></a>

Amazon Chime SDK は、既存の参加者が画面の共有を開始したときに、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者による共有画面の停止
<a name="sdk-attendee-screenshare-stop"></a>

Amazon Chime SDK は、既存の参加者が画面の共有を停止したときに、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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}}"
  }
}
```

## Amazon Chime SDK 出席者の機能が更新されました
<a name="sdk-attendee-capability-updated"></a>

Amazon Chime SDK は、既存の出席者の機能が更新されたときにこのイベントを送信します。

**Example イベントデータ**  

```
{
  "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 参加者によるコンテンツの会議への参加
<a name="sdk-content-join"></a>

Amazon Chime SDK は、指定したネットワークトランスポートを使用してコンテンツ共有が Amazon Chime SDK ミーティングに参加したときに、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者によるコンテンツの会議からの退席
<a name="sdk-content-leave"></a>

Amazon Chime SDK は、指定したネットワークトランスポートを使用してコンテンツ共有が Amazon Chime SDK ミーティングから退席したときに、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者によるコンテンツの会議からの途中退席
<a name="sdk-content-drop"></a>

Amazon Chime SDK は、コンテンツ共有が Amazon Chime SDK ミーティングから切断されたときにこのイベントを送信します。これは通常、低帯域幅が原因で生じます。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者によるコンテンツの動画ストリームの開始
<a name="sdk-content-start-stream"></a>

Amazon Chime SDK は、コンテンツ共有がビデオのストリーミングを開始すると、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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 参加者によるコンテンツの動画ストリームの停止
<a name="sdk-content-stop-stream"></a>

Amazon Chime SDK は、コンテンツ共有がビデオのストリーミングを停止すると、このイベントを送信します。

**Example イベントデータ**  
次の例は、このイベントのデータを示しています。  

```
{
  "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}}"
  }
}
```