本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon Chime SDK 发送会议生命周期事件,用于触发通知和启动下游工作流程。使用会议事件的部分示例包括:
-
与会者加入或离开 Amazon Chime SDK 会议时更新元数据。
-
为 Amazon Chime SDK 会议实施推送通知或花名册。
测量 Amazon Chime SDK 会议中视频和内容共享的使用情况。
您可以向亚马逊 EventBridge、亚马逊简单通知服务 (SNS) 和亚马逊简单队列服务 (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 会发送此事件。
注意
为了提高效率,该服务还会在您调用时发送此事件 DeleteMeetingAPI。
例 事件数据
以下示例显示此事件的数据。
{
"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 软件开发工具包会发送此事件 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 秒内没有收到数据包时,它会认为客户端已掉线并发布事件。
掉线操作通常由该服务触发,但客户端也可以触发。例如,假设用户将笔记本电脑从 Wi-Fi 切换到以太网。这会导致网络适配器的更改,连接被重置。这又会重置 websocket 并触发掉线-加入操作。
注意
该服务不会针对一个“离开”操作发送同时发送 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: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
"
}
}
当现有与会者的容量更新时,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
"
}
}