本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
傳送 RCS 豐富的卡片
豐富的卡片將媒體、文字和建議的動作合併為單一結構化訊息。收件人會在訊息用戶端中將卡片視為原生 UI 元素,提供類似應用程式的體驗。使用多張卡片來呈現鼓勵互動的資訊,例如產品詳細資訊、預訂確認或促銷優惠。
重要
您可以在支援 RCS 的所有國家/地區使用 RCS 豐富媒體傳訊 (包括豐富卡)。如需詳細資訊,請參閱傳送豐富的 RCS 訊息。
若要將多張卡片分組為可捲動集,請參閱 傳送 RCS 輪跳功能。
何時使用 RTF 卡
豐富的卡片非常適合從具有互動式元素的視覺化配置中受益的訊息。常用案例包括:
產品展示:在一個訊息中顯示影像、產品名稱、價格和購買按鈕。
預訂確認:使用行事曆連結和指示按鈕顯示預訂詳細資訊。
預約詳細資訊:目前日期、時間、位置和確認或重新排程的選項。
促銷優惠:重點介紹媒體的交易,以及明確的行動呼籲。
如果您的訊息只需要包含選用建議的文字,請傳送 RCS 文字訊息改用 。如果您需要在沒有其他卡片結構的情況下傳送檔案,請參閱 傳送 RCS 檔案訊息。
豐富的卡片元件
獨立實物卡包含下列元件。中至少Description需要其中一個 MediaTitle、 或 CardContent。
| 元件 | 必要 | 說明 |
|---|---|---|
Media |
否 | 卡片內顯示的影像、GIF 或影片。支援的格式包括 JPEG、PNG、GIF 和 MP4。 檔案大小上限為 100 MB。 |
Title |
否 | 卡片的簡短標題。最多 200 個字元。 |
Description |
否 | 內文文字提供其他詳細資訊。最多 2,000 個字元。 |
Suggestions |
否 | 最多 4 個連接到卡片的建議動作或回應。請參閱 設定 RCS 建議。 |
卡片方向
CardOrientation 欄位控制媒體和文字內容之間的配置關係。此欄位為必填。
VERTICAL媒體會顯示在卡片頂端,標題、描述和建議如下。垂直方向是跨平台相容性的建議預設值。
HORIZONTAL媒體會顯示在卡片的左側或右側,並在其旁邊顯示文字內容。媒體區域的固定寬度為 128 個獨立於密度的像素 (DP)。使用
ThumbnailImageAlignment控制媒體是否出現在左側或右側。
警告
水平方向會導致 iOS 裝置上的影像截斷。使用跨平台部署的VERTICAL方向。
媒體和高度
Media 物件包含 FileUrl(必要)ThumbnailUrl、選用 和選用Height值。FileUrl 必須符合模式^(https://|s3://).+$,且最多可達 2,000 個字元。媒體檔案大小上限為 100 MB。
如需支援的媒體格式、交付選項和 S3 預先簽章 URLs的詳細資訊,請參閱 傳送 RCS 檔案訊息。
| Height | 大小 | 說明 |
|---|---|---|
SHORT |
112 DP | 精簡顯示。用於縮圖或當文字內容是主要焦點時。 |
MEDIUM |
168 DP | 平衡顯示。建議大多數使用案例使用預設值。 |
TALL |
264 DP | 最大顯示區域。當媒體是主要內容時使用。 |
注意
iOS 會以相同的方式轉譯所有媒體高度值,忽略指定的高度設定。使用 TALL將 Android 裝置上的顯示區域最大化,同時在 iOS 上維持可接受的轉譯。
卡片層級建議
您可以將最多 4 個建議包含在CardContent.Suggestions陣列中,以連接至豐富的卡片。卡片層級建議會顯示在卡片內容的正下方。
除了卡片層級建議之外,您可以在RcsMessageContent結構的最上層Suggestions陣列中包含最多 11 個訊息層級建議。訊息層級建議會在整個訊息下方顯示為持久性晶片。
如需建議類型的完整清單 (包括 Reply、OpenUrl、DialPhone、RequestLocation、 和 CreateCalendarEvent)ShowLocation,請參閱 設定 RCS 建議。
RcsMessageContent 結構
下列 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 個)。
傳送多張卡片
使用 SendRcsMessage API 動作來傳送豐富的卡片。將集區或 AWSRCS 代理程式指定為 ,--origination-identity並將豐富的卡片 JSON 結構傳遞為 --rcs-message-content 參數。
跨平台轉譯
Android 和 iOS 裝置之間有豐富的卡轉譯。請遵循這些建議以取得一致的結果:
| 建議 | Reason |
|---|---|
使用VERTICAL方向 |
水平方向會導致 iOS 上的影像截斷。 |
使用TALL媒體高度 |
iOS 會忽略高度值。 會將 Android 上的顯示區域TALL最大化。 |
| 將標題保留為 3 行或更少 | 在啟用可存取性設定的情況下,防止 iOS 上的媒體裁切。 |
使用連結OpenUrl的建議 |
描述文字中的 URLs 無法在任一平台上按一下。 |
| 在 iOS 上測試 GIF 媒體 | 確認靜態第一個影格轉譯可接受。 |
豐富的卡片限制
| 資源 | 限制 |
|---|---|
| 標題長度 | 200 個字元 |
| 描述長度 | 2,000 個字元 |
| 卡片層級建議 | 每張卡 4 個 |
| 訊息層級建議 | 每則訊息 11 個 |
| 訊息承載總計 | 250 KB |
| 媒體檔案大小 | 100 MB |
FileUrl 長度 |
2,000 個字元 |