기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# RCS 캐러셀 전송
AWSEnd User Messaging의 캐러셀 메시지는 가로로 스크롤 가능한 스트립에 2\~10개의 리치 카드를 표시합니다. 수신자는 카드를 스크롤하고 개별 카드에 대한 제안을 선택하여 조치를 취할 수 있습니다. 캐러셀을 사용하면 제품 카탈로그, 서비스 메뉴, 계획 비교, 위치 목록과 같은 대화형 경험을 만들 수 있습니다.
캐러셀은 독립형 리치 카드와 동일한 카드 콘텐츠 모델을 공유하지만( 참조[RCS 리치 카드 전송](rcs-rich-cards.md)), 캐러셀 카드는 항상 수직 레이아웃을 사용하며 `TALL` 미디어 높이를 지원하지 않습니다.
**중요**
RCS가 지원되는 모든 국가에서 RCS 캐러셀 메시지를 보낼 수 있습니다.
## 캐러셀을 사용해야 하는 경우
수신자가 동일한 유형의 여러 항목을 검색하고 비교하도록 하려면 캐러셀을 사용합니다. 일반적인 사용 사례는 다음과 같습니다.
+ **제품 카탈로그**: 이미지, 설명 및 구매 버튼이 포함된 여러 항목을 표시합니다.
+ **서비스 메뉴**: 비교를 위해 서비스 티어 또는 옵션을 나란히 제시합니다.
+ **계획 비교**: 수신자가 여러 계획의 기능을 비교하고 하나를 선택할 수 있습니다.
+ **위치 목록**: 주소 및 맵 작업이 있는 가까운 매장 또는 사무실을 표시합니다.
리치 콘텐츠가 포함된 단일 항목을 표시해야 하는 경우 독립 실행형 리치 카드를 대신 사용합니다. 자세한 내용은 [RCS 리치 카드 전송](rcs-rich-cards.md)을 참조하세요.
## 캐러셀 구조
`SendRcsMessage` 요청의 `RcsMessageContent` 파라미터 내에서 `Content.Carousel` 객체에 캐러셀을 정의합니다. 캐러셀 객체에는 두 개의 필수 필드가 있습니다.
`CardWidth`(필수)
캐러셀에 있는 모든 카드의 표시 너비입니다. 모든 카드는 동일한 너비를 공유합니다. 유효한 값: `SMALL` 또는 `MEDIUM`.
`CardContents`(필수)
카드 객체 2\~10개의 배열입니다. 각 카드에는 제목, 설명, 미디어 및 최대 4개의 제안이 포함될 수 있습니다.
### 카드 너비 값
**캐러셀 카드 너비**
| 값 | 너비 | 최적의 용도 |
| --- | --- | --- |
| SMALL | 180DP | 소형 목록, 썸네일, 빠른 탐색 경험 |
| MEDIUM | 296 DP | 더 긴 설명과 더 큰 이미지가 있는 세부 카드 |
### 카드 콘텐츠 필드
`CardContents` 배열의 각 카드 객체는 다음 필드를 지원합니다.
`Title`
카드 제목입니다. 최대 200자입니다.
`Description`
카드 설명 텍스트입니다. 최대 2,000자.
`Media`
카드에 표시할 이미지 또는 비디오입니다. 다음 필드가 포함됩니다.
+ `FileUrl` (필수): 미디어 파일의 URL입니다. 패턴과 일치해야 합니다`^(https://|s3://).+$`. 최대 2,000자. 최대 파일 크기는 100MB입니다.
+ `ThumbnailUrl` (선택 사항): 전체 미디어가 로드되는 동안 표시되는 썸네일 이미지 URL입니다.
+ `Height`: 미디어의 표시 높이입니다. 캐러셀 카드의 유효한 값: `SHORT` 또는 `MEDIUM`. 캐러셀에서는 `TALL` 높이가 지원되지 않습니다.
`Suggestions`
카드 콘텐츠 아래에 표시되는 최대 4개의 제안된 회신 또는 작업의 배열입니다. 제안 유형의 전체 목록은 섹션을 참조하세요[RCS 제안 구성](rcs-suggestions.md).
## 카드 제안 및 외부 제안
캐러셀 메시지는 두 가지 수준의 제안을 지원합니다.
카드 수준 제안
각 카드에는 최대 4개의 제안이 포함될 수 있습니다. 이는 카드 콘텐츠 바로 아래에 표시되며 해당 카드에 고유합니다(예: "이 항목 구매" 또는 "세부 정보 보기").
외부(메시지 수준) 제안
최상위 `Suggestions` 배열(`RcsMessageContent`구조`Content`의 형제)은 전체 캐러셀 아래에 나타나는 칩 목록을 정의합니다. 메시지당 최대 11개의 외부 제안을 포함할 수 있습니다.
"메뉴로 돌아가기", "도움말" 또는 "검색 완료"와 같이 전체 메시지에 적용되는 탐색 작업에 대한 외부 제안을 사용합니다. 외부 칩 목록에서 카드 수준 작업을 복제하지 마세요.
## 카드 높이 및 잘림
캐러셀의 모든 카드는 가장 높은 카드의 높이에 맞게 조정됩니다. 카드의 콘텐츠가 최대 표시 높이를 초과하는 경우 메시징 클라이언트는 다음 순서로 콘텐츠를 잘라냅니다.
1. 설명은 한 줄로 잘립니다.
1. 제목이 한 줄로 잘립니다.
1. 제안이 제거되었습니다.
1. 설명이 제거되었습니다.
1. 제목이 제거되었습니다(미디어만 남음).
잘림이 적용되면 수신자가 카드를 전체 화면 보기로 확장할 수 있도록 "더 보기" 표시기가 나타납니다.
## 미디어 종횡비
카드 미디어의 종횡비는 카드 너비와 미디어 높이의 조합에 따라 달라집니다.
**중간 너비 카드 종횡비**
| Height | 가로 세로 비율 |
| --- | --- |
| MEDIUM | 4:3 |
| SHORT | 2:1 |
**작은 너비 카드 종횡비**
| Height | 가로 세로 비율 |
| --- | --- |
| MEDIUM | 4:5 |
| SHORT | 5:4 |
**참고**
캐러셀 카드에서는 `TALL` 미디어 높이가 지원되지 않습니다. 키가 큰 미디어의 경우 독립 실행형 리치 카드를 사용합니다. [RCS 리치 카드 전송](rcs-rich-cards.md)을(를) 참조하세요.
## 캐러셀 JSON 구조
다음 JSON은 캐러셀 메시지에 대한 `RcsMessageContent` 파라미터의 구조를 보여줍니다.
```
{
"Content": {
"Carousel": {
"CardWidth": "SMALL | MEDIUM",
"CardContents": [
{
"Title": "Card title (max 200 chars)",
"Description": "Card description (max 2000 chars)",
"Media": {
"FileUrl": "https://example.com/image.jpg",
"ThumbnailUrl": "https://example.com/thumb.jpg",
"Height": "SHORT | MEDIUM"
},
"Suggestions": [
{
"Reply": {
"Text": "Button label (max 25 chars)",
"PostbackData": "callback_data"
}
}
]
}
]
}
},
"Suggestions": [
{
"Reply": {
"Text": "Outer chip label",
"PostbackData": "outer_callback"
}
}
]
}
```
이 값은 `--rcs-message-content` 파라미터(CLI) 또는 `RcsMessageContent` 파라미터(SDK)에서 JSON 문자열로 전달됩니다. `send-rcs-message` 요청에서 `--destination-phone-number` 및 `--origination-identity` (풀 또는 RCS 에이전트)도 지정합니다.
## 캐러셀 제한
**캐러셀 메시지 제한**
| 파라미터 | 최소 | 최대 |
| --- | --- | --- |
| 캐러셀당 카드 | 2 | 10 |
| 카드당 제안 사항 | 0 | 4 |
| 메시지당 외부 제안 | 0 | 11 |
| 제목 길이 | - | 200자 |
| 설명 길이 | - | 2,000자 |
| 미디어 파일 크기 | - | 100MB |
| 총 페이로드 크기 | - | 250KB |
미디어 형식 및 전송 세부 정보는 섹션을 참조하세요[RCS 파일 메시지 전송](rcs-file-messages.md).