本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 傳送 RCS 豐富的卡片
<a name="rcs-rich-cards"></a>

豐富的卡片將媒體、文字和建議的動作合併為單一結構化訊息。收件人會在訊息用戶端中將卡片視為原生 UI 元素，提供類似應用程式的體驗。使用多張卡片來呈現鼓勵互動的資訊，例如產品詳細資訊、預訂確認或促銷優惠。

**重要**  
您可以在支援 RCS 的所有國家/地區使用 RCS 豐富媒體傳訊 （包括豐富卡）。如需詳細資訊，請參閱[傳送豐富的 RCS 訊息](rcs-rich-messaging.md)。

若要將多張卡片分組為可捲動集，請參閱 [傳送 RCS 輪跳功能](rcs-carousels.md)。

**Topics**
+ [何時使用 RTF 卡](#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)

## 何時使用 RTF 卡
<a name="rcs-rich-cards-when"></a>

豐富的卡片非常適合從具有互動式元素的視覺化配置中受益的訊息。常用案例包括：
+ **產品展示**：在一個訊息中顯示影像、產品名稱、價格和購買按鈕。
+ **預訂確認**：使用行事曆連結和指示按鈕顯示預訂詳細資訊。
+ **預約詳細資訊**：目前日期、時間、位置和確認或重新排程的選項。
+ **促銷優惠**：重點介紹媒體的交易，以及明確的行動呼籲。

如果您的訊息只需要包含選用建議的文字，請[傳送 RCS 文字訊息](rcs-text-messages.md)改用 。如果您需要在沒有其他卡片結構的情況下傳送檔案，請參閱 [傳送 RCS 檔案訊息](rcs-file-messages.md)。

## 豐富的卡片元件
<a name="rcs-rich-cards-components"></a>

獨立實物卡包含下列元件。中至少`Description`需要其中一個 `Media``Title`、 或 `CardContent`。


**豐富的卡片元件**  

| 元件 | 必要 | 說明 | 
| --- | --- | --- | 
| Media | 否 | 卡片內顯示的影像、GIF 或影片。支援的格式包括 JPEG、PNG、GIF 和 MP4。 檔案大小上限為 100 MB。 | 
| 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` 必須符合模式`^(https://|s3://).+$`，且最多可達 2，000 個字元。媒體檔案大小上限為 100 MB。

如需支援的媒體格式、交付選項和 S3 預先簽章 URLs的詳細資訊，請參閱 [傳送 RCS 檔案訊息](rcs-file-messages.md)。


**媒體高度值**  

| Height | 大小 | 說明 | 
| --- | --- | --- | 
| SHORT | 112 DP | 精簡顯示。用於縮圖或當文字內容是主要焦點時。 | 
| MEDIUM | 168 DP | 平衡顯示。建議大多數使用案例使用預設值。 | 
| TALL | 264 DP | 最大顯示區域。當媒體是主要內容時使用。 | 

**注意**  
iOS 會以相同的方式轉譯所有媒體高度值，忽略指定的高度設定。使用 `TALL`將 Android 裝置上的顯示區域最大化，同時在 iOS 上維持可接受的轉譯。

## 卡片層級建議
<a name="rcs-rich-cards-suggestions"></a>

您可以將最多 4 個建議包含在`CardContent.Suggestions`陣列中，以連接至豐富的卡片。卡片層級建議會顯示在卡片內容的正下方。

除了卡片層級建議之外，您可以在`RcsMessageContent`結構的最上層`Suggestions`陣列中包含最多 11 個訊息層級建議。訊息層級建議會在整個訊息下方顯示為持久性晶片。

如需建議類型的完整清單 （包括 `Reply`、`OpenUrl`、`DialPhone`、`RequestLocation`、 和 `CreateCalendarEvent`)`ShowLocation`，請參閱 [設定 RCS 建議](rcs-suggestions.md)。

## RcsMessageContent 結構
<a name="rcs-rich-cards-structure"></a>

下列 JSON 顯示獨立豐富卡的 `RcsMessageContent` 參數結構。將此 JSON 做為字串傳遞至 CLI AWS中的 `--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 裝置之間有豐富的卡轉譯。請遵循這些建議以取得一致的結果：


**跨平台建議**  

| 建議 | Reason | 
| --- | --- | 
| 使用VERTICAL方向 | 水平方向會導致 iOS 上的影像截斷。 | 
| 使用TALL媒體高度 | iOS 會忽略高度值。 會將 Android 上的顯示區域TALL最大化。 | 
| 將標題保留為 3 行或更少 | 在啟用可存取性設定的情況下，防止 iOS 上的媒體裁切。 | 
| 使用連結OpenUrl的建議 | 描述文字中的 URLs 無法在任一平台上按一下。 | 
| 在 iOS 上測試 GIF 媒體 | 確認靜態第一個影格轉譯可接受。 | 

## 豐富的卡片限制
<a name="rcs-rich-cards-limits"></a>


**豐富的卡片限制**  

| 資源 | 限制 | 
| --- | --- | 
| 標題長度 | 200 個字元 | 
| 描述長度 | 2,000 個字元 | 
| 卡片層級建議 | 每張卡 4 個 | 
| 訊息層級建議 | 每則訊息 11 個 | 
| 訊息承載總計 | 250 KB | 
| 媒體檔案大小 | 100 MB | 
| FileUrl 長度 | 2,000 個字元 |