기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Chime SDK 미디어 파이프라인 이벤트 사용
<a name="media-pipe-events"></a>

각 미디어 파이프라인 유형은 수명 주기 이벤트를 전송하며, 이러한 이벤트를 사용하면 알림을 트리거하고 다운스트림 워크플로를 시작할 수 있습니다. 다음은 미디어 파이프라인 이벤트를 사용하는 몇 가지 예입니다.
+ 미디어 파이프라인 완료 후 캡처된 미디어 처리
+ 미디어 파이프라인에 일시적인 장애가 발생한 경우 회의 참가자에게 알림
+ 미디어 파이프라인이 영구적으로 실패할 경우 회의 중단

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="media-pipeline-create"></a>

Amazon Chime SDK는 미디어 파이프라인이 생성될 때 이 이벤트를 전송합니다.

**예제: 이벤트 데이터**  
 다음은 이 이벤트의 예제 데이터입니다.

```
{
    "version": "0", 
    "id": "5ee6265a-0a40-104e-d8fd-a3b4bdd78483", 
    "detail-type": "Chime Media Pipeline State Change", 
    "source": "aws.chime", 
    "account": "{{111122223333}}", 
    "time": "{{2021-07-28T20:20:49Z}}", 
    "region": "us-east-1", 
    "resources": [], 
    "detail": {
        "version": "0", 
        "eventType": "chime:MediaPipelineInProgress", 
        "timestamp": {{1627503649251}}, 
        "meetingId": "{{1e6bf4f5-f4b5-4917-b8c9-bda45c340706}}", 
        "externalMeetingId": "{{Meeting_Id}}",
        "mediaPipelineId": "{{e40ee45e-2ed1-408e-9156-f52b8208a491}}", 
        "mediaRegion": "ap-southeast-1"
    }
}
```

## 삭제된 Amazon Chime SDK 미디어 파이프라인
<a name="media-pipeline-delete"></a>

미디어 파이프라인이 성공적으로 중지되면 Amazon Chime SDK가 이 이벤트를 전송합니다.

**예제: 이벤트 데이터**  
다음은 이 이벤트의 예제 데이터입니다.

```
{
    "version": "0",
    "id": "9e11e429-97fd-9532-5670-fac3f7abc05f",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "{{365135496707}}",
    "time": "{{2021-07-28T20:21:50Z}}",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelineDeleted",
        "timestamp": {{1627503710485}},
        "meetingId": "{{1e6bf4f5-f4b5-4917-b8c9-bda45c340706}}",
        "externalMeetingId": "{{Meeting_Id}}",
        "mediaPipelineId": "{{e40ee45e-2ed1-408e-9156-f52b8208a491}}",
        "mediaRegion": "ap-southeast-1"
    }
}
```

## Amazon Chime SDK 미디어 파이프라인의 일시적인 장애
<a name="pipeline-temp-failure"></a>

Amazon Chime SDK는 미디어 파이프라인에 일시적인 장애가 발생했을 때 이 이벤트를 전송합니다.

**예제: 이벤트 데이터**  
다음은 이 이벤트의 예제 데이터입니다.

```
{
    "version": "0",
    "id": "{{abc141e1-fc2e-65e8-5f18-ab5130f1035a}}",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "{{365135496707}}",
    "time": "{{2021-07-28T21:16:42Z}}",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelineTemporaryFailure",
        "timestamp": {{1627507002882}},
        "meetingId": "{{7a5434e3-724a-4bbb-9eb6-2fb209dc0706}}",
        "externalMeetingId": "{{Meeting_Id}}",
        "mediaPipelineId": "{{ebd62f4e-04a9-426d-bcb0-974c0f266400}}",
        "mediaRegion": "eu-south-1"
    }
}
```

## Amazon Chime SDK 미디어 파이프라인 진행 중
<a name="pipeline-in-progress"></a>

미디어 파이프라인이 아티팩트 캡처를 시작하면 Amazon Chime SDK가 이 이벤트를 전송합니다.

**예제: 이벤트 데이터**  
다음은 이 이벤트의 예제 데이터입니다.

```
{
    "version": "0",
    "id": "{{9e11e429-97fd-9532-5670-fac3f7abc05f}}",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "{{365135496707}}",
    "time": "{{2021-07-28T20:21:50Z}}",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelineInProgress",
        "timestamp": {{1627503710485?}},
        "meetingId": "{{1e6bf4f5-f4b5-4917-b8c9-bda45c340706}}",
        "externalMeetingId": "{{Meeting_Id}}",
        "mediaPipelineId": "{{e40ee45e-2ed1-408e-9156-f52b8208a491}}",
        "mediaRegion": "ap-southeast-1"
    }
}
```

## Amazon Chime SDK 미디어 파이프라인의 영구 장애
<a name="pipeline-perm-failure"></a>

Amazon Chime SDK는 미디어 파이프라인이 영구적으로 실패했을 때 이 이벤트를 전송합니다.

**예제: 이벤트 데이터**  
다음은 이 이벤트의 예제 데이터입니다.

```
{
    "version": "0",
    "id": "{{9e11e429-97fd-9532-5670-fac3f7abc05f}}",
    "detail-type": "Chime Media Pipeline State Change",
    "source": "aws.chime",
    "account": "{{365135496707}}",
    "time": "{{2021-07-28T20:21:50Z}}",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0",
        "eventType": "chime:MediaPipelinePermanentFailure",
        "timestamp": {{1627503710485}},
        "meetingId": "{{1e6bf4f5-f4b5-4917-b8c9-bda45c340706}}",
        "externalMeetingId": "{{Meeting_Id}}",
        "mediaPipelineId": "{{e40ee45e-2ed1-408e-9156-f52b8208a491}}",
        "mediaRegion": "ap-southeast-1"
    }
}
```