本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 以程式設計方式擷取縮圖
<a name="thumbnails-work-cli"></a>

啟用縮圖功能時，MediaLive 會在執行中的頻道中為目前作用中的輸入產生縮圖。對於標準頻道，MediaLive 會產生兩個縮圖。對於單一管道頻道，MediaLive 會產生一個縮圖。

您可以使用 AWS CLI 以程式設計方式使用縮圖。下列資訊假設您熟悉使用 的基本概念 AWS CLI。如需基本資訊，請參閱 [AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/)。

使用 `DescribeThumbnails` 命令。此命令在不同界面的表示方式不同：
+ 在 中 AWS CLI，命令為 `describe-thumbnails`。
+ 在 API 中，命令由 `describe-thumbnails/kmsKeyId` 上的 `HTTP GET` 表示。
+ 在 AWS SDKs 中，命令由適合該 SDK 語言的建構表示。

**使用 擷取縮圖 AWS CLI**

1. 請確定已在[頻道中啟用縮圖](thumbnails-enable.md)，並確認頻道正在執行中。

1. 輸入此命令：

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

   其中：

   `channel-id` 是必要的。

   `pipeline-id` 為 0 或 1。如果您想要兩個管道的縮圖，請輸入 命令兩次。

   `thumbnail-type` 始終是 `CURRENT_ACTIVE`。此選項是必要的，即使它只有一個值。

1. 回應會顯示於畫面。例如：

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

   如果縮圖已停用，回應如下所示：

   ```
   {
       "ThumbnailDetails": []
   }
   ```