本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
发送 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、、、OpenUrlDialPhoneShowLocation、RequestLocation和CreateCalendarEvent)的完整列表,请参阅配置 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为必填项并接受VERTICAL或HORIZONTAL。ThumbnailImageAlignment是可选的,仅适用于水平牌。CardContent.Suggestions包含卡牌级别建议(最多 4 个)。顶级数
Suggestions组包含消息级建议(最多 11 个)。
寄一张富豪卡
使用 SendRcsMessage API 操作发送一张富卡片。将您的矿池或 AWS RCS 代理指定为,--origination-identity并将富卡 JSON 结构作为--rcs-message-content参数传递。
Cross-platform 渲染
Android 和 iOS 设备之间的丰富卡片渲染效果各不相同。请遵循以下建议以获得一致的结果:
| 建议 | 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 个字符 |