本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
了解 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: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 SDK 會議退出時，Amazon Chime 會SDK傳送此事件，通常是因為連線不良。當服務在 10-15 秒內沒有收到封包時，會考慮用戶端已捨棄並發出事件。
服務通常會觸發捨棄動作，但用戶端也可以觸發這些動作。例如，假設使用者將其筆記型電腦從 Wi-Fi 切換至乙太網路。這會構成網路轉接器變更，並重設連線。反過來， 會重設 Websocket，並觸發合併的退出動作。
注意
服務絕不會針對相同的「離開」動作傳送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 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"
}
}