翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 入力サムネイルの表示
<a name="thumbnails"></a>

MediaLive は、チャネルの入力からビデオのサムネイルを生成できます。サムネイルは、コンテンツに動画が含まれていることを視覚的に検証します。MediaLive コンソールで各チャンネルのサムネイルを表示できます。また、いずれかの AWS APIs を使用して、プログラムでサムネイルを操作することもできます。

**サムネイルの生成方法**

チャンネルでサムネイルを有効にし、チャンネルが実行されている場合、MediaLive は 2 秒ごとに JPEG サムネイルを生成します。サムネイルは、次のサムネイルに置き換えられるまで 2 秒間だけ存在します。各入力には独自のサムネイルがあります。つまり、MediaLive は 1 つのパイプラインチャネルに対して 1 つのサムネイルを生成し、標準チャネルに対して 2 つのサムネイルを生成します。

サムネイルが生成されるとすぐに、MediaLive はそれをコンソールのチャンネルの詳細ページに表示されます。また、サムネイルをバイナリデータとして使用できます。 AWS API を使用して、バイナリデータをプログラムで操作できます。



**サムネイルの暗号化**

MediaLive は、作成された各サムネイルを常に暗号化します。



**Topics**
+ [チャネルでのサムネイルの有効化](thumbnails-enable.md)
+ [コンソールでのサムネイルの表示](thumbnails-view.md)
+ [プログラムによるサムネイルの取得](thumbnails-work-cli.md)
+ [MediaLive のサムネイルの制限](thumbnail-limits.md)



# チャネルでのサムネイルの有効化
<a name="thumbnails-enable"></a>

各 MediaLivechannel でサムネイル機能を有効にする必要があります。

サムネイルを有効または無効にできるのは、チャネルがアイドル状態 (実行されていない) の場合のみです。

**Topics**
+ [IAM アクセスの提供](#thumbnails-enable-iam)
+ [コンソールでのサムネイルの有効化](#thumbnails-enable-console)
+ [プログラムによるサムネイルの有効化](#thumbnails-enable-progammatically)

## IAM アクセスの提供
<a name="thumbnails-enable-iam"></a>

サムネイル機能を使用するには、MediaLive が Amazon S3 にアクセスする必要があります。
+ 組織が MediaLiveAccessRole の信頼されたエンティティを使用している場合は、チャンネル設定のチャンネル**と入力の詳細**ページに移動し、**全般情報**セクションを参照してください。このセクションに**ロールの更新**ボタンが表示された場合は、ボタンを選択します。ボタンが表示されない場合、信頼されたエンティティにはすでに必要なアクセスがあります
+ 組織がカスタムの信頼されたエンティティロールを使用している場合、IAM 管理者は適切な信頼されたエンティティロールを更新する必要があります。追加する操作については、「[信頼されるエンティティのアクセス要件](trusted-entity-requirements.md)」を参照してください。そのページで「**thumbnails**」 を検索します。ロールを更新する方法については、「[信頼されたエンティティを作成する - 複雑なオプション](setup-trusted-entity-complex.md)」を参照してください。

## コンソールでのサムネイルの有効化
<a name="thumbnails-enable-console"></a>

**注記**  
このセクションでは、「[ゼロからのチャンネルの作成](creating-channel-scratch.md)」で説明しているチャンネルの作成または編集に精通していることを前提としています。

1. [https://console.aws.amazon.com/medialive/](https://console.aws.amazon.com/medialive/) で MediaLive コンソールを開きます。

1. **チャンネルの作成**ページまたは**チャンネルの編集**ページで、**全般設定 **を選択し、**サムネイル設定**セクションを開きます。

1. **サムネイル設定を有効にする **を選択します。**状態** で、**AUTO** または **DISABLED **を選択します。

## プログラムによるサムネイルの有効化
<a name="thumbnails-enable-progammatically"></a>

サムネイル機能を有効にするには、チャンネルの JSON にパラメータの「`ThumbnailConfiguration`」グループを含めます。「`State`」パラメータを「`AUTO`」（有効にする）または「`DISABLED`」に設定します。

次の例は、チャンネルの JSON 内のパラメータの相対的な位置を示しています。

```
{
  "ChannelClass": "SINGLE_PIPELINE",
  .
  .
  . 
  "EncoderSettings": {
    .
    .
    .
    "TimecodeConfig": {
      "Source": "EMBEDDED"
    },
    "ThumbnailConfiguration": {
      "State": "DISABLED"
     },
    .
    .
    .
```

# コンソールでのサムネイルの表示
<a name="thumbnails-view"></a>

サムネイルを有効にすると、MediaLive は実行中のチャネルで現在アクティブな入力のサムネイルを生成します。標準チャンネルの場合、MediaLive は 2 つのサムネイルを生成します。単一パイプラインチャネルの場合、MediaLive は 1 つのサムネイルを生成します。

1. [https://console.aws.amazon.com/medialive/](https://console.aws.amazon.com/medialive/) で MediaLive コンソールを開きます。

1. ナビゲーションバーから**チャンネル**を選択します。チャンネルのリストで、チャンネル名を選択します。[詳細] ページが表示されます。

   **ステータス**セクションにはサムネイルフレームが含まれます。チャネルに 2 つの入力がある場合、画面には入力ごとにタブが含まれます。

チャネルが実行されていて、詳細ページが表示されると、アクティブなタブのパイプラインのサムネイルが 2 秒ごとに自動的に更新されます。このページが表示されない場合、MediaLive はサムネイルを生成しません。

チャンネルが実行されていない場合、フレームは黒になります。

チャンネルの実行が停止すると、サムネイルプレビューの更新が停止します。数秒後、現在のサムネイルはメッセージに置き換えられます。

# プログラムによるサムネイルの取得
<a name="thumbnails-work-cli"></a>

サムネイル機能を有効にすると、MediaLive は実行中のチャネルで現在アクティブな入力のサムネイルを生成します。標準チャンネルの場合、MediaLive は 2 つのサムネイルを生成します。単一パイプラインチャネルの場合、MediaLive は 1 つのサムネイルを生成します。

を使用して 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 です。両方のパイプラインのサムネイルが必要な場合は、 コマンドを 2 回入力します。

   「`thumbnail-type`」 は常に 「`CURRENT_ACTIVE`」 です。このオプションは、値が 1 つだけであっても必要です。

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": []
   }
   ```

# MediaLive のサムネイルの制限
<a name="thumbnail-limits"></a>

表示または取得できる MediaLivethumbnails の数には制限があります。上限は:

`A number of API transactions per second, per account, in one Region`

トランザクション制限は、コンソールに表示されるサムネイルと 「 AWS 」 API を使用して取得するサムネイルのすべてで共有されます。現在の制限については、[Service Quotas](https://console.aws.amazon.com/servicequotas/home?region=us-east-1#!/services/medialive/quotas) コンソールの MediaLive ページを参照してください。

コンソールでは、チャネルの詳細ページが表示され、アクティブなタブ (つまり、チャネル内のパイプラインが 1 つだけ) にのみ、チャネルのサムネイルが生成されます。関連するパイプラインの場合、MediaLive はおよそ 2 秒ごとに API を呼び出します。