以编程方式检索缩略图 - MediaLive

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

以编程方式检索缩略图

启用缩略图功能后， MediaLive 会为正在运行的频道中当前处于活动状态的输入生成缩略图。对于标准频道， MediaLive 生成两个缩略图。对于单管道频道， MediaLive 生成一个缩略图。

您可以使用 AWS CLI 以编程方式处理缩略图。以下信息假定您熟悉使用 AWS CLI的基础知识。有关基础知识的信息，请参阅 AWS CLI 命令参考。

使用 DescribeThumbnails 命令。在不同的界面中，此命令的表示方式不同：

  • 在中 AWS CLI，命令是describe-thumbnails。

  • 在 API 中，命令由 describe-thumbnails/kmsKeyId 上的 HTTP GET 表示。

  • 在中 AWS SDKs，命令由适用于该 SDK 语言的构造表示。

要使用检索缩略图 AWS CLI

  1. 确保您已在通道中启用缩略图，并确保该通道正在运行。

  2. 输入以下命令：

    aws medialive describe-thumbnails --channel-id value --pipeline-id value --thumbnail-type value

    其中：

    channel-id 是必需的。

    pipeline-id 为 0 或 1。如果希望获得两个管道的缩略图，请输入命令两次。

    thumbnail-type 始终为 CURRENT_ACTIVE。此选项为必选项，尽管它只有一个值。

  3. 响应将显示在屏幕上。例如：

    {
    "ThumbnailDetails": [
        {
            "PipelineId": "0",
            "Thumbnails": [
                {
                    "Body"base64 string of the JPEG image",
                    "ContentType": "image/jpeg",
                    "ThumbnailType": "CURRENT_ACTIVE",
                    "TimeStamp": "2023-07-15T21:01:11"
                }
            ]
        }
    ]
}

    如果缩略图已禁用，则响应会类似于以下内容：

    {
    "ThumbnailDetails": []
}