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

# RCS 리치 카드 전송
<a name="rcs-rich-cards"></a>

리치 카드는 미디어, 텍스트 및 제안된 작업을 하나의 구조화된 메시지로 결합합니다. 수신자는 카드를 메시징 클라이언트의 기본 UI 요소로 보고 앱과 같은 경험을 제공합니다. 리치 카드를 사용하여 제품 세부 정보, 예약 확인 또는 프로모션 제안과 같은 상호 작용을 장려하는 정보를 제공합니다.

**중요**  
RCS가 지원되는 모든 국가에서 RCS 리치 미디어 메시징(리치 카드 포함)을 사용할 수 있습니다. 자세한 내용은 [리치 RCS 메시지 전송](rcs-rich-messaging.md) 단원을 참조하십시오.

여러 카드를 스크롤 가능한 세트로 그룹화하려면 섹션을 참조하세요[RCS 캐러셀 전송](rcs-carousels.md).

**Topics**
+ [리치 카드를 사용해야 하는 경우](#rcs-rich-cards-when)
+ [리치 카드 구성 요소](#rcs-rich-cards-components)
+ [카드 방향](#rcs-rich-cards-orientation)
+ [미디어 및 높이](#rcs-rich-cards-media)
+ [카드 수준 제안](#rcs-rich-cards-suggestions)
+ [RcsMessageContent 구조](#rcs-rich-cards-structure)
+ [리치 카드 전송](#rcs-rich-cards-sending)
+ [교차 플랫폼 렌더링](#rcs-rich-cards-rendering)
+ [리치 카드 한도](#rcs-rich-cards-limits)

## 리치 카드를 사용해야 하는 경우
<a name="rcs-rich-cards-when"></a>

리치 카드는 대화형 요소가 있는 시각적 레이아웃의 이점을 활용하는 메시지에 매우 적합합니다. 일반적인 사용 사례는 다음과 같습니다.
+ **제품 소개**: 이미지, 제품 이름, 가격 및 구매 버튼을 하나의 메시지로 표시합니다.
+ **예약 확인**: 일정 링크 및 지침 버튼이 있는 예약 세부 정보를 표시합니다.
+ **예약 세부 정보**: 현재 날짜, 시간, 위치 및 확인 또는 일정 조정 옵션.
+ **프로모션 제안**: 미디어와의 거래와 명확한 행동 호출을 강조 표시합니다.

메시지에 선택적 제안이 포함된 텍스트만 필요한 경우 [RCS 문자 메시지 전송](rcs-text-messages.md) 대신를 사용합니다. 추가 카드 구조 없이 파일을 전송해야 하는 경우 섹션을 참조하세요[RCS 파일 메시지 전송](rcs-file-messages.md).

## 리치 카드 구성 요소
<a name="rcs-rich-cards-components"></a>

독립 실행형 리치 카드는 다음 구성 요소로 구성됩니다. 에는 `Media``Title`, 또는 중 하나 이상이 `Description` 필요합니다`CardContent`.


**리치 카드 구성 요소**  

| 구성 요소 | 필수 | 설명 | 
| --- | --- | --- | 
| Media | 아니요 | 카드 내에 표시되는 이미지, GIF 또는 비디오입니다. 지원되는 형식에는 JPEG, PNG, GIF 및 MP4가 포함됩니다. 최대 파일 크기는 100MB입니다. | 
| Title | 아니요 | 카드에 대한 짧은 헤드라인입니다. 최대 200자입니다. | 
| Description | 아니요 | 추가 세부 정보를 제공하는 본문 텍스트입니다. 최대 2,000자. | 
| Suggestions | 아니요 | 카드에 연결된 최대 4개의 추천 작업 또는 회신. [RCS 제안 구성](rcs-suggestions.md)을(를) 참조하세요. | 

## 카드 방향
<a name="rcs-rich-cards-orientation"></a>

`CardOrientation` 필드는 미디어와 텍스트 콘텐츠 간의 레이아웃 관계를 제어합니다. 이 필드는 필수 항목입니다.

`VERTICAL`  
미디어는 아래 제목, 설명 및 제안과 함께 카드 상단에 표시됩니다. 세로 방향은 교차 플랫폼 호환성을 위해 권장되는 기본값입니다.

`HORIZONTAL`  
미디어는 카드의 왼쪽 또는 오른쪽에 텍스트 콘텐츠와 함께 표시됩니다. 미디어 영역의 고정 너비는 128개의 밀도 독립적 픽셀(DP)입니다. `ThumbnailImageAlignment`를 사용하여 미디어가 왼쪽 또는 오른쪽에 나타나는지 여부를 제어합니다.

**주의**  
가로 방향은 iOS 디바이스에서 이미지 잘림을 유발합니다. 교차 플랫폼 배포에 `VERTICAL` 방향을 사용합니다.

## 미디어 및 높이
<a name="rcs-rich-cards-media"></a>

`Media` 객체에는 `FileUrl` (필수), 선택적 및 `ThumbnailUrl`선택적 `Height` 값이 포함됩니다. 는 패턴과 일치해야 `FileUrl` 하며 최대 2,000자일 `^(https://|s3://).+$` 수 있습니다. 최대 미디어 파일 크기는 100MB입니다.

지원되는 미디어 형식, 전송 옵션 및 S3 미리 서명된 URLs[RCS 파일 메시지 전송](rcs-file-messages.md).


**미디어 높이 값**  

| Height | Size: | 설명 | 
| --- | --- | --- | 
| SHORT | 112 DP | 소형 디스플레이. 썸네일 또는 텍스트 콘텐츠가 기본 포커스인 경우를 사용합니다. | 
| MEDIUM | 168DP | 균형 잡힌 표시. 대부분의 사용 사례에 권장되는 기본값입니다. | 
| TALL | 264 DP | 최대 표시 영역입니다. 미디어가 기본 콘텐츠일 때 사용합니다. | 

**참고**  
iOS는 지정된 높이 설정을 무시하고 모든 미디어 높이 값을 동일하게 렌더링합니다. `TALL`를 사용하여 iOS에서 허용 가능한 렌더링을 유지하면서 Android 디바이스의 표시 영역을 최대화합니다.

## 카드 수준 제안
<a name="rcs-rich-cards-suggestions"></a>

`CardContent.Suggestions` 배열에 포함시켜 리치 카드에 최대 4개의 제안을 연결할 수 있습니다. 카드 수준 제안은 카드 콘텐츠 바로 아래에 표시됩니다.

카드 수준 제안 외에도 `RcsMessageContent` 구조의 최상위 `Suggestions` 배열에 최대 11개의 메시지 수준 제안을 포함할 수 있습니다. 메시지 수준 제안은 전체 메시지 아래에 영구 칩으로 표시됩니다.

제안 유형의 전체 목록(`Reply`, , `OpenUrl`, `RequestLocation`, `DialPhone` `ShowLocation`및 포함`CreateCalendarEvent`)은 섹션을 참조하세요[RCS 제안 구성](rcs-suggestions.md).

## RcsMessageContent 구조
<a name="rcs-rich-cards-structure"></a>

다음 JSON은 독립형 리치 카드의 `RcsMessageContent` 파라미터 구조를 보여줍니다. 이 JSON을 AWSCLI의 `--rcs-message-content` 파라미터에 문자열로 전달하거나 SDK의 `RcsMessageContent` 파라미터로 전달합니다.

```
{
  "Content": {
    "RichCard": {
      "StandaloneCard": {
        "CardOrientation": "VERTICAL",
        "CardContent": {
          "Title": "Your card title",
          "Description": "Additional details about the card content.",
          "Media": {
            "FileUrl": "https://example.com/image.jpg",
            "ThumbnailUrl": "https://example.com/thumb.jpg",
            "Height": "MEDIUM"
          },
          "Suggestions": [
            {
              "Reply": {
                "Text": "Confirm",
                "PostbackData": "confirm_action"
              }
            },
            {
              "OpenUrl": {
                "Text": "View details",
                "PostbackData": "view_details",
                "Url": "https://www.example.com/details"
              }
            }
          ]
        }
      }
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Help",
        "PostbackData": "help_menu"
      }
    }
  ]
}
```

이 구조에서:
+ `Content.RichCard.StandaloneCard` 에는 카드 정의가 포함되어 있습니다.
+ `CardOrientation`는 필수이며 `VERTICAL` 또는를 허용합니다`HORIZONTAL`.
+ `ThumbnailImageAlignment`는 선택 사항이며 가로 카드에만 적용됩니다.
+ `CardContent.Suggestions` 에는 카드 수준 제안(최대 4개)이 있습니다.
+ 최상위 `Suggestions` 배열에는 메시지 수준 제안(최대 11개)이 있습니다.

## 리치 카드 전송
<a name="rcs-rich-cards-sending"></a>

`SendRcsMessage` API 작업을 사용하여 리치 카드를 전송합니다. 풀 또는 AWSRCS 에이전트를 로 지정`--origination-identity`하고 리치 카드 JSON 구조를 `--rcs-message-content` 파라미터로 전달합니다.

## 교차 플랫폼 렌더링
<a name="rcs-rich-cards-rendering"></a>

리치 카드 렌더링은 Android 디바이스와 iOS 디바이스에 따라 다릅니다. 일관된 결과를 얻으려면 다음 권장 사항을 따르세요.


**교차 플랫폼 권장 사항**  

| 권장 사항 | 이유 | 
| --- | --- | 
| VERTICAL 방향 사용 | 수평 방향은 iOS에서 이미지 잘림을 유발합니다. | 
| TALL 미디어 높이 사용 | iOS는 높이 값을 무시합니다.는 Android에서 표시 영역을 TALL 최대화합니다. | 
| 제목을 3줄 이하로 유지합니다. | 접근성 설정이 활성화된 iOS에서 미디어 자르기를 방지합니다. | 
| 링크에 대한 OpenUrl 제안 사용 | 설명 텍스트의 URLs은 어느 플랫폼에서도 클릭할 수 없습니다. | 
| iOS에서 GIF 미디어 테스트 | 정적 첫 번째 프레임이 적절하게 렌더링되는지 확인합니다. | 

## 리치 카드 한도
<a name="rcs-rich-cards-limits"></a>


**리치 카드 한도**  

| Resource | Limit | 
| --- | --- | 
| 제목 길이 | 200자 | 
| 설명 길이 | 2,000자 | 
| 카드 수준 제안 | 카드당 4개 | 
| 메시지 수준 제안 | 메시지당 11개 | 
| 총 메시지 페이로드 | 250KB | 
| 미디어 파일 크기 | 100MB | 
| FileUrl 길이 | 2,000자 |