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

# 傳送 RCS 輪跳功能
<a name="rcs-carousels"></a>

AWS最終使用者傳訊中的浮動傳送訊息會在水平可捲動的長條圖中顯示 2 到 10 張豐富卡片。收件人可以捲動卡片，並在個別卡片上選擇要採取動作的建議。透過浮動切換，您可以建立對話和互動體驗，例如產品目錄、服務功能表、計劃比較和位置清單。

輪跳功能與獨立實物卡共用相同的卡片內容模型 （請參閱[傳送 RCS 豐富的卡片](rcs-rich-cards.md))，但輪跳功能卡一律使用垂直配置，且不支援`TALL`媒體高度。

**重要**  
您可以在支援 RCS 的所有國家/地區傳送 RCS 輪跳功能訊息。

## 何時使用輪跳功能
<a name="rcs-carousels-when"></a>

當您希望收件人瀏覽和比較相同類型的多個項目時，請使用輪跳功能。常用案例包括：
+ **產品目錄**：顯示包含影像、描述和購買按鈕的多個項目。
+ **服務功能表**：並排呈現服務層或選項以供比較。
+ **計劃比較**：讓收件人比較跨計劃的功能，並選擇一個功能。
+ **位置清單**：使用地址和地圖動作顯示附近的商店或辦公室。

如果您需要顯示具有豐富內容的單一項目，請改用獨立的豐富卡。如需詳細資訊，請參閱[傳送 RCS 豐富的卡片](rcs-rich-cards.md)。

## 浮動切換結構
<a name="rcs-carousels-structure"></a>

您可以在`SendRcsMessage`請求的 `RcsMessageContent` 參數內定義 `Content.Carousel` 物件中的輪跳功能。浮動切換物件包含兩個必要欄位：

`CardWidth` (必要)  
輪跳功能中所有卡片的顯示寬度。所有卡片的寬度相同。有效值：`SMALL` 或 `MEDIUM`。

`CardContents` (必要)  
2 到 10 個卡物件的陣列。每張卡片最多可包含標題、描述、媒體和 4 個建議。

### 卡片寬度值
<a name="rcs-carousels-card-width"></a>


**浮動切換卡寬度**  

| Value | Width | 最適合 | 
| --- | --- | --- | 
| SMALL | 180 DP | 精簡清單、縮圖、快速瀏覽體驗 | 
| MEDIUM | 296 DP | 具有較長描述和較大影像的詳細卡片 | 

### 卡片內容欄位
<a name="rcs-carousels-card-content"></a>

`CardContents` 陣列中的每個卡片物件都支援下列欄位：

`Title`  
卡片標題。最多 200 個字元。

`Description`  
卡片描述文字。最多 2，000 個字元。

`Media`  
要在卡片上顯示的影像或影片。包含下列欄位：  
+ `FileUrl` （必要）：媒體檔案的 URL。必須符合模式 `^(https://|s3://).+$`。最多 2，000 個字元。檔案大小上限為 100 MB。
+ `ThumbnailUrl` （選用）：完整媒體載入時顯示的縮圖影像 URL。
+ `Height`：媒體的顯示高度。浮動切換卡的有效值： `SHORT`或 `MEDIUM`。輪跳功能不支援`TALL`高度。

`Suggestions`  
最多 4 個建議的回應或動作陣列，顯示在卡片內容下方。如需建議類型的完整清單，請參閱 [設定 RCS 建議](rcs-suggestions.md)。

## 卡片建議和外部建議
<a name="rcs-carousels-suggestions"></a>

浮動切換訊息支援兩個層級的建議：

卡片層級建議  
每張卡片最多可包含 4 個建議。這些項目會直接顯示在卡片內容下方，且專屬於該卡片 （例如，「購買此項目」或「檢視詳細資訊」)。

外部 （訊息層級） 建議  
最上層`Suggestions`陣列 (`RcsMessageContent`結構`Content`中的 同級） 定義了出現在整個輪跳功能下方的晶片清單。每則訊息最多可包含 11 個外部建議。

針對套用至整體訊息的導覽動作使用外部建議，例如「返回選單」、「說明」或「完成瀏覽」。避免在外部晶片清單中複製卡片層級動作。

## 卡片高度和截斷
<a name="rcs-carousels-height-truncation"></a>

輪跳功能中的所有卡片都會進行縮放，以符合最高卡片的高度。如果卡片的內容超過最大顯示高度，訊息用戶端會依下列順序截斷內容：

1. 描述截斷為單行。

1. 標題截斷為單行。

1. 已移除建議。

1. 已移除描述。

1. 已移除標題 （僅保留媒體）。

套用截斷時，會出現「更多」指示器，讓收件人可以將卡片展開為全螢幕檢視。

## 媒體長寬比
<a name="rcs-carousels-aspect-ratios"></a>

卡片媒體的長寬比取決於卡片寬度和媒體高度的組合。


**中寬卡長寬比**  

| Height | 長寬比 | 
| --- | --- | 
| MEDIUM | 4：3 | 
| SHORT | 2：1 | 


**小型寬度卡長寬比**  

| Height | 長寬比 | 
| --- | --- | 
| MEDIUM | 4：5 | 
| SHORT | 5：4 | 

**注意**  
浮動切換卡不支援`TALL`媒體高度。對於高媒體，請使用獨立的多張卡片。請參閱 [傳送 RCS 豐富的卡片](rcs-rich-cards.md)。

## 浮動切換 JSON 結構
<a name="rcs-carousels-schema"></a>

下列 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"
      }
    }
  ]
}
```

此值會以參數 (CLI) 或 `--rcs-message-content` 參數 `RcsMessageContent`(SDK) 中的 JSON 字串傳遞。您也可以在`send-rcs-message`請求中指定 `--destination-phone-number`和 `--origination-identity`（集區或 RCS 代理程式）。

## 浮動切換限制
<a name="rcs-carousels-limits"></a>


**浮動切換訊息限制**  

| 參數 | 下限 | 上限 | 
| --- | --- | --- | 
| 每個浮動切換的卡片數 | 2 | 10 | 
| 每張卡片的建議 | 0 | 4 | 
| 每則訊息的外部建議 | 0 | 11 | 
| 標題長度 | - | 200 個字元 | 
| 描述長度 | - | 2,000 個字元 | 
| 媒體檔案大小 | - | 100 MB | 
| 總承載大小 | - | 250 KB | 

如需媒體格式和交付詳細資訊，請參閱 [傳送 RCS 檔案訊息](rcs-file-messages.md)。