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

傳送 RCS 輪跳功能

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

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

何時使用輪跳功能

當您希望收件人瀏覽和比較相同類型的多個項目時，請使用輪跳功能。常用案例包括：

如果您需要顯示具有豐富內容的單一項目，請改用獨立的豐富卡。如需詳細資訊，請參閱傳送 RCS 豐富的卡片。

浮動切換結構

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

卡片寬度值

卡片內容欄位

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

卡片建議和外部建議

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

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

卡片高度和截斷

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

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

媒體長寬比

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

浮動切換 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"
      }
    }
  ]
}

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

浮動切換限制

如需媒體格式和交付詳細資訊，請參閱 傳送 RCS 檔案訊息。