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

发送 RCS 文件消息

您可以使用 SendRcsMessage API 中的FileMessage内容类型将图像、视频、音频文件和 PDF 作为独立消息发送给收件人。文件消息在收件人的消息应用程序中显示为内联媒体。

文件消息不同于富卡媒体。文件消息将单个媒体作为全部消息内容传送，而富卡片则将媒体与文本和建议的操作结合在一起。有关富卡的信息，请参阅发送 RCS 富豪卡。

您可以将消息级别的建议（例如回复片或操作按钮）附加到文件消息中。有关建议的详细信息，请参阅配置 RCS 建议。

FileMessage 结构

该FileMessage对象嵌套在RcsMessageContent参数的Content字段中。 Message-levelSuggestions是Content（未嵌套在其中）的兄弟姐妹。

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/welcome-thumb.jpg"
        }
    },
    "Suggestions": []
}

文件网址来源

该FileUrl参数接受两种 URL 格式：

用于文件传输的 S3 存储桶策略

要允许 AWS 最终用户消息从您的 Amazon S3 存储桶中检索文件，请将以下基于资源的策略附加到该存储桶：

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
        }
    ]
}

将 YOUR-BUCKET替换为存储桶名称。要限制对特定前缀的访问，请/*替换为所需的路径（例如，arn:aws:s3:::YOUR-BUCKET/rcs-media/*）。

支持的媒体类型和大小限制

下表列出了支持的媒体类型FileMessage。

缩略图

您可以使用ThumbnailUrl参数为视频和 PDF 文件消息提供缩略图。在收件人打开或下载完整文件之前，缩略图将在对话中显示为预览。

发送文件消息

要发送文件消息，请使用RcsMessageContent参数内的FileMessage对象调用 SendRcsMessage API。您可以使用参数指定源身份（池或 AWS RCS 代理）。--origination-identity

以下 JSON 显示了带有建议的文件消息的RcsMessageContent值：

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/documents/invoice.pdf",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/invoice-thumb.jpg"
        }
    },
    "Suggestions": [
        {
            "Reply": {
                "Text": "Download receipt",
                "PostbackData": "action=download_receipt"
            }
        }
    ]
}

交付和备用

当您发送文件消息时，“ AWS 最终用户消息” 会尝试通过 RCS 通道传送该消息。如果收件人的设备不支持 RCS，或者消息在传送前过期（基于该TimeToLive值），则该服务可以根据您的回退配置回退到短信或彩信。

您可以在池级别或每条消息上配置短信或彩信后备功能。有关回退行为的详细信息，请参阅发送丰富的 RCS 消息。