

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

# 输出文件名和路径
<a name="output-file-names-and-paths"></a>

 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_cn/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_cn/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_cn/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 平滑流式处理组](microsoft-smooth-streaming-group.md)

# 文件组
<a name="file-group"></a>

以下是带有`COMPLETE`状态的任务的 Amazon EventBridge 示例事件。它包含 CMAF 组的输出文件路径信息。

```
{
    "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 速率控制时可用。

# 带帧捕获输出的文件组
<a name="file-group-with-frame-capture-output"></a>

本指南为`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 组
<a name="apple-hls-group"></a>

以下是带有`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 组
<a name="dash-iso-group"></a>

以下是带有`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 组
<a name="cmaf-group"></a>

以下是带有`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 平滑流式处理组
<a name="microsoft-smooth-streaming-group"></a>

以下是带有`COMPLETE`状态的作业的 EventBridge 示例事件。其包含Microsoft 平滑流式处理群组的输出文件路径信息。

```
{
    "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 速率控制时可用。