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 ms。如果时间戳范围小于采样间隔,则图像来自StartTimestamp如果可用,将退回。

类型:整数

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

必需:是

Status

表示是否ContinuousImageGenerationConfigurationsAPI 已启用或已禁用。

类型:字符串

有效值: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 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: