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

# ImageGenerationConfiguration
<a name="API_ImageGenerationConfiguration"></a>

包含 KVS 影像交付所需資訊的結構。如果為 null，則會從串流中刪除組態。

## 目錄
<a name="API_ImageGenerationConfiguration_Contents"></a>

 ** DestinationConfig **   <a name="KinesisVideo-Type-ImageGenerationConfiguration-DestinationConfig"></a>
此結構包含將映像交付給客戶所需的資訊。  
類型：[ImageGenerationDestinationConfig](API_ImageGenerationDestinationConfig.md) 物件  
必要：是

 ** Format **   <a name="KinesisVideo-Type-ImageGenerationConfiguration-Format"></a>
接受的影像格式。  
類型：字串  
有效值:`JPEG | PNG`   
必要：是

 ** ImageSelectorType **   <a name="KinesisVideo-Type-ImageGenerationConfiguration-ImageSelectorType"></a>
用於產生映像的伺服器或生產者時間戳記來源。  
類型：字串  
有效值:`SERVER_TIMESTAMP | PRODUCER_TIMESTAMP`   
必要：是

 ** SamplingInterval **   <a name="KinesisVideo-Type-ImageGenerationConfiguration-SamplingInterval"></a>
需要從串流產生影像的時間間隔，以毫秒 (ms) 為單位。可以提供的最小值為 200 毫秒。如果時間戳記範圍小於取樣間隔，`StartTimestamp`則會在可用時傳回來自 的影像。  
類型：整數  
必要：是

 ** Status **   <a name="KinesisVideo-Type-ImageGenerationConfiguration-Status"></a>
指出 `ContinuousImageGenerationConfigurations` API 是啟用或停用。  
類型：字串  
有效值:`ENABLED | DISABLED`   
必要：是

 ** FormatConfig **   <a name="KinesisVideo-Type-ImageGenerationConfiguration-FormatConfig"></a>
金鑰值對結構的清單，其中包含可在產生映像時套用的額外參數。`FormatConfig` 金鑰是 `JPEGQuality`，表示要用來產生映像的 JPEG 品質金鑰。此`FormatConfig`值接受從 1 到 100 的整數。如果值為 1，則會以較低的品質和最佳的壓縮產生影像。如果值為 100，則會以最佳品質和較少的壓縮產生影像。如果未提供任何值，`JPEGQuality`金鑰的預設值會設為 80。  
類型：字串到字串映射  
映射項目：最多 1 個項目。  
有效金鑰：`JPEGQuality`  
值長度限制：長度下限為 0。長度上限為 256。  
值模式：`^[a-zA-Z_0-9]+`  
必要：否

 ** HeightPixels **   <a name="KinesisVideo-Type-ImageGenerationConfiguration-HeightPixels"></a>
與 `WidthPixels` 參數搭配使用的輸出映像高度。同時提供 `HeightPixels`和 `WidthPixels` 參數時，影像會延伸以符合指定的長寬比。如果只提供 `HeightPixels` 參數，則會使用其原始長寬比來計算`WidthPixels`比率。如果未提供參數，則會傳回原始影像大小。  
類型：整數  
有效範圍：最小值為 1。最大值為 2160。  
必要：否

 ** WidthPixels **   <a name="KinesisVideo-Type-ImageGenerationConfiguration-WidthPixels"></a>
與 `HeightPixels` 參數搭配使用的輸出映像寬度。同時提供 `WidthPixels`和 `HeightPixels` 參數時，影像會延伸以符合指定的長寬比。如果只提供 `WidthPixels` 參數，則會使用其原始長寬比來計算`HeightPixels`比率。如果未提供參數，則會傳回原始影像大小。  
類型：整數  
有效範圍：最小值為 1。最大值為 3840。  
必要：否

## 另請參閱
<a name="API_ImageGenerationConfiguration_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/ImageGenerationConfiguration) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/ImageGenerationConfiguration) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/ImageGenerationConfiguration)