本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 AWS 最終使用者簡訊簡訊傳送 MMS 訊息的範例
如果您使用的是共用資源，則必須使用資源的完整 Amazon Resource Name (ARN)。您可以使用 AWS CLI 或 AWS 最終使用者傳訊簡訊和語音 v2 API，將 MMS 訊息傳送給客戶。
使用 [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) AWS CLI 命令來傳送 MMS 訊息。如需設定 的詳細資訊 AWS CLI，請參閱[AWS Command Line Interface 《 使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)》中的[設定 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)。
**重要**
MMS 功能僅適用於某些國家/地區。如需 SMS 和 MMS 支援國家/地區的詳細資訊，請參閱 [支援使用 AWS 最終使用者簡訊簡訊的國家和地區](phone-numbers-sms-by-country.md)和 [AWS 最終使用者簡訊簡訊中 MMS 訊息支援的國家和地區](phone-numbers-mms-by-country.md)。
若要檢查原始身分是否支援 MMS，請參閱 [在 AWS 最終使用者簡訊簡訊中檢視電話號碼狀態和功能](phone-numbers-status.md)。
若要使用共用資源，您必須使用完整的 Amazon Resource Name (ARN)。
## 先決條件
開始之前，必須符合下列先決條件：
+ 您必須擁有[支援傳送 MMS 訊息的](phone-numbers-mms-by-country.md#phone-numbers-mms-by-country.title)起始身分。
+ 您必須將媒體檔案上傳至與支援 MMS 的原始身分 AWS 區域 相同的 Amazon S3 儲存貯體，請參閱 [設定 MMS 檔案的 Amazon S3 儲存貯體](#send-mms-message-bucket)。
如需支援檔案類型和大小的清單，請參閱 [ MMS 檔案類型、大小和字元限制 了解 MMS 檔案大小、檔案類型限制，以及 mm 可包含的包機數量上限。 MMS 檔案類型MMS 檔案大小mms 字元限制 所有影像類型 (gif、jpeg、png) 的單一 MMS 媒體檔案最多可達 2 MB，而所有音訊和影片媒體檔案類型的大小最多可達 600 KB。MMS 的文字訊息內文可以包含來自任何字元集的 1600。與 SMS 不同，MS 訊息在傳送時不會分成多個部分。如果您要傳送大型文字訊息，可能會獲得更好的輸送量來傳送 MMS 訊息，因為它們不會分成多個部分。
****
| 檔案類型 | MIME 類型 | 檔案大小上限 |
| --- | --- | --- |
| 圖形交換格式 | `image/gif` | 2 MB |
| 聯合攝影專家群組 | `image/jpeg` | 2 MB |
| 可攜式網路圖形 | `image/png` | 2 MB |
| 標籤影像檔案格式 | `image/tiff` | 600 KB |
| 第三代合作夥伴關係專案 | `audio/3gpp`, `video/3gpp` | 600 KB |
| 第三代合作夥伴關係專案 2 | `audio/3gpp2`, `video/3gpp2` | 600 KB |
| 自適應多費率 | `audio/amr` | 600 KB |
| MPEG-4 | `audio/mp4`, `video/mp4` | 600 KB |
| 移動圖片專家群組 | `audio/mpeg` 僅支援 MP3 檔案 `audio/mpeg` | 600 KB |
| Ogg | `audio/ogg` | 600 KB |
| QuickTime | `video/quicktime` | 600 KB |
| WebM | `video/webm` | 600 KB |
| iCalendar | `text/calendar` | 600 KB |
| vCard | `text/vcard`, `text/x-vcard` | 600 KB |
| 可攜文件格式檔 | `application/pdf` | 600 KB | ](mms-limitations-character.md#mms-limitations-character.title)
+ 每個 MMS 檔案的 S3 URIs。
+ 用於呼叫 的身分`send-media-message`必須具有包含媒體檔案的 Amazon S3 儲存貯體的讀取存取權。如需設定讀取存取權的詳細資訊，請參閱《[Amazon S3 使用者指南》中的 Amazon S3 的身分型政策範例](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html)。 [Amazon S3 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/)
## 使用 傳送 MMS AWS CLI
[send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) 的唯一必要參數是 `destination-phone-number`和 `origination-identity`。您可以省略 `media-urls` 參數，傳送僅是文字的訊息。您也可以透過省略 `message-body` 參數，傳送訊息 只是媒體檔案。
**傳送 MMS 訊息**
+ 在命令列中輸入以下命令：
```
aws pinpoint-sms-voice-v2 --region 'us-east-1' send-media-message --destination-phone-number +12065550150 --origination-identity +14255550120 --message-body 'text body' --media-urls 's3://s3-bucket/media_file.jpg'
```
在上述命令中，進行下列變更：
+ 將 *us-east-1* 取代 AWS 區域 為您的起始身分存放所在的 。
+ 將 *\$112065550150* 取代為目的地電話號碼。
+ 將 *\$114255550120* 取代為您的起始身分。起始身分必須是 `ACTIVE`且能夠傳送目的地電話號碼。
+ 將*文字內文*取代為您的文字訊息。
+ 將 *s3：//s3-bucket/media\$1file.jpg 取代*為 MMS 檔案的 S3 URI。支援的媒體檔案格式會列在 中[MMS 檔案類型、大小和字元限制](mms-limitations-character.md)。如需建立 S3 儲存貯體和管理物件的詳細資訊，請參閱《[Amazon S3 使用者指南](https://docs.aws.amazon.com/AmazonS3/latest/userguide/)》中的 [設定 MMS 檔案的 Amazon S3 儲存貯體](#send-mms-message-bucket)或[建立儲存貯](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)體和[上傳物件](https://docs.aws.amazon.com//AmazonS3/latest/userguide/upload-objects.html)。
如果 AWS 最終使用者傳訊簡訊接受 命令，您將會收到 `MessageID`。僅表示已成功收到命令，但目的地裝置尚未收到訊息。如需錯誤代碼清單，請參閱 [SendMediaMessage Errors](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SendMediaMessage.html#API_SendMediaMessage_Errors)。
```
{
"MessageId": "string"
}
```
## 設定 MMS 檔案的 Amazon S3 儲存貯體
您的 MMS 檔案必須存放在 Amazon S3 儲存貯體中。Amazon S3 儲存貯體必須與具備 MMS 功能的原始身分位於相同的 AWS 帳戶 和 AWS 區域 。這些指示說明如何建立 Amazon S3 儲存貯體、上傳檔案，以及將 URI 建置至 檔案。如需 Amazon S3 命令的詳細資訊，請參閱[搭配 AWS CLI 使用高階 (s3) 命令](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html)。如需設定 的詳細資訊 AWS CLI，請參閱[AWS Command Line Interface 《 使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)》中的[設定 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)。
若要建立 Amazon S3 儲存貯體，請使用 [create-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html) AWS CLI 命令。在命令列中輸入以下命令：
```
aws s3api create-bucket --region 'us-east-1' --bucket BucketName
```
在上述命令中：
+ 將 *us-east-1* 取代為 AWS 區域 具有 MMS 功能的原始身分所在。
+ 將 *BucketName* 取代為新儲存貯體的名稱。
若要將檔案複製到 Amazon S3 儲存貯體，請使用 [cp](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy) AWS CLI 命令。在命令列中輸入以下命令：
```
aws s3 cp SourceFilePathAndName s3://BucketName/FileName
```
在上述命令中：
+ 將 *SourceFilePathAndName* 取代為要複製的檔案路徑和檔案名稱。
+ 將 *BucketName* 取代為儲存貯體的名稱。
+ 將 *FileName* 取代為 檔案要使用的名稱。
傳送時要使用的 URI 為：
```
s3://BucketName/FileName
```