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

接收入站 RCS 媒体

用户可以在与您的代理的 RCS 对话中发送媒体（图像、视频、音频文件和文档）。配置入站媒体存储时，“AWS最终用户消息” 会从 RCS 提供商处下载媒体，将其上传到您的 Amazon S3 存储桶，然后向您的双向 Amazon SNS 主题发布一条包含 S3 位置和文件元数据的通知。

有关接收入站 RCS 消息（文本、位置和建议回复）的一般信息，请参阅接收入站 RCS 消息。有关向用户发送富媒体的信息，请参阅发送丰富的 RCS 消息。

入站媒体的工作原理

当用户在 RCS 对话中发送媒体文件时，“AWS最终用户消息” 将通过以下步骤处理该消息：

对于LOCATION和SUGGESTION消息类型，不会进行 S3 上传。内容直接在 SNS 通知正文中传送。有关这些消息类型的详细信息，请参阅接收入站 RCS 消息。

配置入站媒体存储

要接收入站媒体，请使用 UpdateRcsAgent API 在 RCS 代理上配置以下字段。 Two-way 在配置媒体存储之前，必须在代理上启用消息传递。

S3 存储桶和 IAM 角色是必需的。如果指定一个，则必须同时指定两个。

S3 密钥格式

媒体对象采用以下密钥格式存储，其中原始文件名附加在#分隔符之后：

{prefix}/rcs/{messageId}#{fileName}

例如，如果您将 key prefix 设置为inbound-media，则媒体文件可能会存储为：

inbound-media/rcs/msg-abc123def456#photo_2026.jpg

为入站媒体创建 IAM 角色

创建一个 IAM 角色以允许AWS最终用户消息服务将媒体文件上传到您的 S3 存储桶。该角色需要一个允许服务担任该角色的信任策略和一个允许s3:PutObject访问您的存储桶的权限策略。

信任策略

以下信任策略允许AWS最终用户消息服务主体担任该角色。123456789012替换为您的AWS账户 ID。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

权限策略

以下权限策略授予角色向您的 S3 存储桶写入对象的访问权限。将 my-rcs-media-bucket替换为存储桶名称。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject"
            ],
            "Resource": "arn:aws:s3:::my-rcs-media-bucket/*"
        }
    ]
}

配置媒体存储 (CLI)

以下 AWS CLI 命令在现有 RCS 代理上配置入站媒体存储：

aws pinpoint-sms-voice-v2 update-rcs-agent \
    --rcs-agent-id rcs-agent-1234567890abcdef0 \
    --two-way-media-s3-bucket-name my-rcs-media-bucket \
    --two-way-media-s3-key-prefix "inbound-media" \
    --two-way-media-s3-role arn:aws:iam::123456789012:role/RcsInboundMediaRole \
    --region us-east-1

入站媒体通知有效负载

当AWS最终用户消息收到媒体文件时，它会向您的双向 SNS 主题发布通知。通知是一个 JSON 对象，其messageBody字段包含字符串化的 JSON 文档，其中包含媒体状态以及成功后的 S3 位置和文件元数据。

以下示例显示了成功的入站媒体通知：

{
    "originationNumber": "+14255551234",
    "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b",
    "messageBody": "{\"mediaStatus\":\"SUCCESS\",\"s3Bucket\":\"my-rcs-media-bucket\",\"s3Key\":\"inbound-media/rcs/msg-abc123def456#photo_2026.jpg\",\"mimeType\":\"image/jpeg\",\"fileName\":\"photo_2026.jpg\",\"fileSizeBytes\":1211843}",
    "inboundMessageId": "8821d750-4bc5-4cb1-a8c3-c3d64a38d019"
}

顶级通知包含以下字段：

messageBodyJSON 包含以下字段：

媒体下载失败处理

如果AWS最终用户消息无法从 RCS 提供商处下载或存储媒体，则该服务仍会向您的双向 SNS 主题发布通知。messageBody带有失败mediaStatus（UPLOAD_FAILED或ROLE_ASSUME_FAILED）和mediaStatusMessage描述原因的，没有 S3 位置字段。

例如，IAM 角色假设失败会生成以下messageBody内容：

{
    "mediaStatus": "ROLE_ASSUME_FAILED",
    "mediaStatusMessage": "Media received but could not assume the configured IAM role",
    "mimeType": "image/heic",
    "fileName": "IMG_7115.heic",
    "fileSizeBytes": 1211843
}

媒体下载失败的常见原因包括：

要对交付失败进行故障排除，请验证您的 IAM 角色信任和权限策略是否配置正确，以及 S3 存储桶是否存在且可通过服务进行访问。监控代理的媒体上传失败 CloudWatch 指标。

可接受的媒体类型

AWS最终用户消息接受以下入站媒体 MIME 类型：

最佳实践