本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 輸出檔案名稱和路徑
EventBridge 任務`COMPLETE`通知包含 JSON 中輸出的詳細資訊。此資訊包含任務輸出的檔案名稱和路徑，包括資訊清單和媒體資產。
AWS Elemental MediaConvert 建立的檔案取決於您在任務中設定的輸出群組。例如，DASH ISO 套件包含了 .mpd 資訊清單和 .mp4 媒體片段檔案。
您可以在下列屬性中找到輸出檔案名稱和路徑資訊：
`playlistFilePaths`
多變量播放清單的 Amazon S3 檔案路徑清單。
`outputFilePaths`
媒體或資訊清單的檔案路徑，取決於輸出群組類型而定。
`type`
輸出群組類型決定了 `playlistFilePaths` 和 `outputFilePaths` 中會列出哪些檔案。
以下資料表總結了這些屬性的值，取決於輸出群組類型而定。
| Type | playlistFilePaths | outputFilePaths |
| --- | --- | --- |
| FILE\$1GROUP (標準輸出) | 未傳回 | 媒體檔案的檔案名稱和路徑。 範例：`s3://amzn-s3-demo-bucket/file/file.mp4` |
| FILE\$1GROUP (包含額外影格擷取輸出) | 未傳回 | 最終擷取影像的檔案名稱和路徑。 範例：`s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg` |
| HLS\$1GROUP | 多變量播放清單的檔案名稱和路徑。 範例：`s3://amzn-s3-demo-bucket/hls/main.m3u8` | 個別輸出資訊清單的檔案名稱和路徑。 範例： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediaconvert/latest/ug/output-file-names-and-paths.html) |
| DASH\$1ISO\$1GROUP | 資訊清單的檔案名稱和路徑。 範例：`s3://amzn-s3-demo-bucket/dash/1.mpd` | 未傳回 |
| CMAF\$1GROUP | 每個最上層資訊清單的檔案名稱和路徑。 範例： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediaconvert/latest/ug/output-file-names-and-paths.html) | 未傳回 |
| MS\$1SMOOTH\$1GROUP | 伺服器端資訊清單的檔案名稱和路徑。 範例：`s3://amzn-s3-demo-bucket/smooth/1.ism` | 每個個別輸出的視訊資訊清單檔案名稱和路徑。 範例： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/mediaconvert/latest/ug/output-file-names-and-paths.html) |
關於每個輸出群組類型中 JSON 的 範本 回應，請參閱以下主題：
**Topics**
+ [檔案群組](file-group.md)
+ [具有影格擷取輸出的檔案群組](file-group-with-frame-capture-output.md)
+ [Apple HLS 群組](apple-hls-group.md)
+ [DASH ISO 群組](dash-iso-group.md)
+ [CMAF 群組](cmaf-group.md)
+ [Microsoft Smooth Streaming 群組](microsoft-smooth-streaming-group.md)
# 檔案群組
以下是`COMPLETE`狀態為 之任務的 Amazon EventBridge 範例事件。此範例包含檔案群組的輸出檔案路徑資訊。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
"start": 0,
"end": 10
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/file/file.mp4"
],
"durationInMs": 180041,
"videoDetails": {
"averageBitrate": 200000,
"widthInPx": 1280,
"heightInPx": 720,
"qvbrAvgQuality": 7.38,
"qvbrMinQuality": 7,
"qvbrMaxQuality": 8,
"qvbrMinQualityLocation": 2168,
"qvbrMaxQualityLocation": 25025
},
}
],
"type": "FILE_GROUP"
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
],
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注意**
只有當您的視訊輸出使用品質定義的可變位元速率 (QVBR) 控制時，才能使用 QVBR 統計資料。
# 具有影格擷取輸出的檔案群組
本指南為`COMPLETE`狀態為 的任務提供 Amazon EventBridge 範例事件。它也會顯示具有影格擷取輸出之檔案群組的輸出檔案路徑資訊。
*影格擷取輸出*是您設定用來建立視訊靜態影像的輸出。您可以設定它，類似於一般**檔案群組**輸出群組。不過，您移除音訊元件，選擇**容器**沒有容器，然後選擇視訊轉碼器的影**格擷取至 JPEG**。
**注意**
您只能在具有一般音訊和視訊輸出的任務中建立影格擷取輸出。MediaConvert 不支援僅由影格擷取輸出組成的任務。
當您建立影格擷取輸出時，`COMPLETE`狀態會包含 `outputFilePaths` 屬性。這會告訴您最終擷取影像的檔案名稱和路徑。
**提示**
由於該服務包含了影格擷取檔案名稱中的自動編號，您可以從最後一個影像名稱推斷所有的影像名稱。例如，如果您的 `outputFilePaths` 值為 `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg`，您便可推斷相同位置中有另外 35 個影像，並名為 `file.0000001`、`file.0000002`，依此類推。
以下是`COMPLETE`狀態為 之任務的 EventBridge 範例事件。它包含具有影格擷取輸出之檔案群組的輸出檔案路徑資訊。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg"
],
"durationInMs": 185000,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720
}
}
],
"type": "FILE_GROUP"
},
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/file/file.mp4"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "FILE_GROUP"
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注意**
只有在您的視訊輸出使用 QVBR 速率控制時，才能使用品質定義的可變位元速率 (QVBR) 統計資料。
# Apple HLS 群組
以下是`COMPLETE`狀態為 之任務的 Amazon EventBridge 範例事件。它包含 Apple HLS 群組的輸出檔案路徑資訊。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/hls/mainv2.m3u8"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 426,
"heightInPx": 240,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
},
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/hls/mainv1.m3u8"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "HLS_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/hls/main.m3u8"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注意**
只有在您的視訊輸出使用 QVBR 速率控制時，才能使用品質定義的可變位元速率 (QVBR) 統計資料。
# DASH ISO 群組
以下是`COMPLETE`狀態為 之任務的 Amazon EventBridge 範例事件。它包含 DASH ISO 群組的輸出檔案路徑資訊。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "DASH_ISO_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/dash/1.mpd"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注意**
只有在您的視訊輸出使用 QVBR 速率控制時，才能使用品質定義的可變位元速率 (QVBR) 統計資料。
# CMAF 群組
以下是`COMPLETE`狀態為 之任務的 EventBridge 範例事件。它包含 CMAF 群組的輸出檔案路徑資訊。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "CMAF_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/cmaf/1.mpd",
"s3://amzn-s3-demo-bucket/cmaf/1.m3u8"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注意**
只有在您的視訊輸出使用 QVBR 速率控制時，才能使用品質定義的可變位元速率 (QVBR) 統計資料。
# Microsoft Smooth Streaming 群組
以下是`COMPLETE`狀態為 之任務的 EventBridge 範例事件。它包含 Microsoft Smooth Streaming 群組的輸出檔案路徑資訊。
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/smooth/1_va.ismv"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 534,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "MS_SMOOTH_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/smooth/1.ism"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**注意**
只有在您的視訊輸出使用 QVBR 速率控制時，才能使用品質定義的可變位元速率 (QVBR) 統計資料。