带帧捕获输出的文件组 - MediaConvert
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

带帧捕获输出的文件组

本指南为COMPLETE状态为任务提供了 Amazon EventBridge 示例事件。它还显示了带帧捕获输出的文件组的输出文件路径信息。

帧捕获输出是您可以设置的一种输出，它可用于创建视频的静态图像。您可以将其设置为与常规文件组输出组类似。但是，您可以移除音频组件，为容器选择无容器，然后为视频编解码器选择帧捕捉到 JPEG。

注意

您只能在同时具有常规音频和视频输出的作业中创建帧捕捉输出。 MediaConvert 不支持仅包含帧捕获输出的作业。

创建帧捕捉输出时，COMPLETE 状态包括 outputFilePaths 属性。这将告诉您最终捕获的图像的文件名和路径。

提示

此服务在帧捕获文件名中包含自动编号，因此您可以从最后一个图像名称推断出所有图像名称。例如，如果 outputFilePaths 值为 s3://DOC-EXAMPLE-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://DOC-EXAMPLE-BUCKET/frameoutput/file.0000036.jpg"
                        ],
                        "durationInMs": 185000,
                        "videoDetails": {
                            "widthInPx": 1280,
                            "heightInPx": 720
                        }
                    }
                ],
                "type": "FILE_GROUP"
            },
            {
                "outputDetails": [
                    {
                        "outputFilePaths": [
                            "s3://DOC-EXAMPLE-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 速率控制时可用。