View a markdown version of this page

发送 RCS 富豪卡 - AWS 最终用户消息 SMS

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

发送 RCS 富豪卡

一张富卡片将媒体、文本和建议的操作组合成一条结构化消息。收件人将卡片视为其消息传递客户端中的原生用户界面元素,可提供类似应用程序的体验。使用丰富的卡片来展示鼓励互动的信息,例如产品详情、预订确认或促销优惠。

重要

您可以在所有支持 RCS 的国家/地区使用 RCS 富媒体消息(包括富卡)。有关更多信息,请参阅 发送丰富的 RCS 消息

要将多张卡片组合成一个可滚动的集合,请参阅。发送 RCS 旋转木马

何时使用富卡

丰富的卡片非常适合存放受益于带有交互元素的视觉布局的消息。常见使用案例包括:

  • 产品展示柜:在一条消息中显示图片、产品名称、价格和购买按钮。

  • 预订确认:使用日历链接和路线按钮显示预订详情。

  • 预约详情:当前日期、时间、地点以及确认或重新安排的选项。

  • 促销优惠:重点介绍与媒体达成的协议和明确的号召性用语。

如果您的消息只需要带有可选建议的文本,请发送 RCS 短信改用。如果您需要发送不带额外卡片结构的文件,请参阅发送 RCS 文件消息

丰富的卡片组件

独立的富卡由以下组件组成。中至少需要有MediaTitle、或Description中的一个CardContent

丰富的卡片组件
组件 必需 说明
Media 卡片中显示的图像、GIF 或视频。支持的格式包括 JPEG、PNG、GIF 和 MP4。最大 文件大小为 100MB。
Title 这张卡片的简短标题。最多 200 个字符。
Description 正文提供了更多细节。最多 2000 个字符。
Suggestions 卡片上最多附有 4 条建议的操作或回复。请参阅配置 RCS 建议

卡片方向

CardOrientation字段控制媒体内容和文本内容之间的布局关系。该字段为必填。

VERTICAL

媒体内容显示在卡片的顶部,标题、描述和建议如下。为了实现跨平台兼容性,建议将垂直方向设置为默认方向。

HORIZONTAL

媒体显示在卡片的左侧或右侧,旁边有文字内容。媒体区域的固定宽度为 128 个密度无关像素 (DP)。ThumbnailImageAlignment用于控制媒体显示在左侧还是右侧。

警告

在 iOS 设备上,水平方向会导致图像被截断。使用VERTICAL方向进行跨平台部署。

媒体和高地

Media对象包含一个FileUrl(必填)、一个可选ThumbnailUrl值和一个可选Height值。FileUrl必须与模式^(https://|s3://).+$相匹配,最多可包含 2,000 个字符。媒体文件的最大大小为 100 MB。

有关支持的媒体格式、传送选项和 S3 预签名 URL 的详细信息,请参阅发送 RCS 文件消息

媒体高度值
高度 Size 说明
SHORT 112 DP 紧凑型显示屏。用于缩略图或以文本内容为主要焦点的情况。
MEDIUM 168 DP 平衡显示。对于大多数用例,建议使用默认值。
TALL 264 DP 最大显示区域。当媒体是主要内容时使用。
注意

iOS 以相同的方式呈现所有媒体高度值,忽略指定的高度设置。TALL用于最大化 Android 设备上的显示区域,同时在 iOS 上保持可接受的渲染。

Card-level 建议

通过将多达 4 条建议包含在CardContent.Suggestions数组中,您可以将这些建议附加到一张富卡片中。 Card-level 建议显示在卡片内容的正下方。

除了卡片级别的建议外,您还可以在结构的顶级Suggestions数组中包含最多 11 条消息级别的建议。RcsMessageContent Message-level 建议在整条消息下方显示为永久性筹码。

有关建议类型(包括Reply、、、OpenUrlDialPhoneShowLocationRequestLocationCreateCalendarEvent)的完整列表,请参阅配置 RCS 建议

RcsMessageContent 结构

以下 JSON 显示了独立富卡的RcsMessageContent参数结构。将此 JSON 作为字符串传递给 AWS CLI 中的--rcs-message-content参数或作为RcsMessageContent参数传递给 SDK 中的参数。

{ "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为必填项并接受VERTICALHORIZONTAL

  • ThumbnailImageAlignment是可选的,仅适用于水平牌。

  • CardContent.Suggestions包含卡牌级别建议(最多 4 个)。

  • 顶级数Suggestions组包含消息级建议(最多 11 个)。

寄一张富豪卡

使用 SendRcsMessage API 操作发送一张富卡片。将您的矿池或 AWS RCS 代理指定为,--origination-identity并将富卡 JSON 结构作为--rcs-message-content参数传递。

Cross-platform 渲染

Android 和 iOS 设备之间的丰富卡片渲染效果各不相同。请遵循以下建议以获得一致的结果:

Cross-platform 建议
建议 Reason
使用VERTICAL方向 在 iOS 上,水平方向会导致图像被截断。
使用TALL介质高度 iOS 会忽略高度值。 TALL最大化安卓系统的显示区域。
将标题保持在 3 行或更少 启用辅助功能设置后,可防止在 iOS 上裁剪媒体。
使用链接OpenUrl建议 描述文本中的 URL 在任何一个平台上都不可点击。
在 iOS 上测试 GIF 媒体 确认静态第一帧的渲染是否可接受。

丰富的卡牌限额

丰富的卡牌限额
资源 限制
标题长度 200 个字符
描述长度 2000 个字符
Card-level 建议 每张卡 4 张
Message-level 建议 每条消息 11 个
消息负载总量 250 KB
媒体文件大小 100 MB
FileUrl长度 2000 个字符