以程式設計方式擷取縮圖 - 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": []
}