ImageGenerationConfiguration - Amazon Kinesis Video Streams
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

ImageGenerationConfiguration

包含 KVS 图像交付所需信息的结构。如果为 null,则配置将从流中删除。

内容

DestinationConfig

包含向客户交付图像所需的信息的结构。

类型:ImageGenerationDestinationConfig 对象

必需:是

Format

可接受的图像格式。

类型:字符串

有效值:JPEG | PNG

必需:是

ImageSelectorType

用于生成图像的服务器或制作者时间戳的来源。

类型:字符串

有效值:SERVER_TIMESTAMP | PRODUCER_TIMESTAMP

必需:是

SamplingInterval

需要从流中生成图像的时间间隔,以毫秒 (ms) 为单位。可以提供的最小值为 200 毫秒。如果时间戳范围小于采样间隔,则StartTimestamp将返回的图像(如果有)。

类型:整数

有效范围:最小值为 3000。最大值为 20000。

必需:是

Status

指示 ContinuousImageGenerationConfigurations API 是启用还是禁用。

类型:字符串

有效值:ENABLED | DISABLED

必需:是

FormatConfig

键值对结构的列表,其中包含可在生成图像时应用的额外参数。FormatConfig密钥是JPEGQuality,它表示用于生成图像的 JPEG 质量密钥。该FormatConfig值接受介于 1 到 100 之间的整数。如果该值为 1,则将生成质量较低且压缩效果最佳的图像。如果该值为 100,则将生成质量最好、压缩率更低的图像。如果未提供任何值,则JPEGQuality密钥的默认值将设置为 80。

类型:字符串到字符串映射

映射条目:最多 1 个物品。

有效密钥:JPEGQuality

值长度限制:最小长度为 0。最大长度为 256。

价值模式:^[a-zA-Z_0-9]+

必需:否

HeightPixels

WidthPixels参数一起使用的输出图像的高度。当同时提供HeightPixelsWidthPixels参数时,图像将被拉伸以适合指定的纵横比。如果仅提供了HeightPixels参数,则将使用其原始纵横比来计算该WidthPixels比率。如果两个参数均未提供,则将返回原始图像尺寸。

类型:整数

有效范围:最小值为 1。最大值为 2160。

必需:否

WidthPixels

HeightPixels参数一起使用的输出图像的宽度。当同时提供WidthPixelsHeightPixels参数时,图像将被拉伸以适合指定的纵横比。如果仅提供了WidthPixels参数,则将使用其原始纵横比来计算该HeightPixels比率。如果两个参数均未提供,则将返回原始图像尺寸。

类型:整数

有效范围:最小值为 1。最大值为 3840。

必需:否

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: