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

# 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>

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/ImageGenerationConfiguration) 
+  [AWS 适用于 Java 的 SDK V2](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)