你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

JpgImage 类

介绍用于从输入视频生成一系列 JPEG 图像的属性。

必须填充所有必需的参数才能发送到 Azure。

继承

azure.mgmt.media.models._models_py3.Image

JpgImage

构造函数

JpgImage(*, start: str, label: str | None = None, key_frame_interval: timedelta | None = None, stretch_mode: str | _models.StretchMode | None = None, sync_mode: str | _models.VideoSyncMode | None = None, step: str | None = None, range: str | None = None, layers: List[_models.JpgLayer] | None = None, sprite_column: int | None = None, **kwargs)

仅限关键字的参数

名称	说明
label	str 编解码器的可选标签。 标签可用于控制复用行为。
key_frame_interval	timedelta 两个关键帧之间的距离。 该值应为以 ISO 8601 格式指定的 [0.5， 20] 秒范围内的非零。 默认值为 PT2S) (2 秒。 请注意，如果设置了 VideoSyncMode.Passthrough，则忽略此设置，其中 KeyFrameInterval 值将遵循输入源设置。
stretch_mode	str 或 StretchMode 调整大小模式 - 如何调整输入视频的大小以适应所需的输出分辨率 () 。 默认值为 AutoSize。 已知值为：“None”、“AutoSize”和“AutoFit”。
sync_mode	str 或 VideoSyncMode 视频同步模式。 已知值为：“Auto”、“Passthrough”、“Cfr”和“Vfr”。
start	str 输入视频中开始生成缩略图的位置。 该值可以是 ISO 8601 格式（例如，PT05S 表示在 5 秒处开始），可以是帧计数（例如，10 表示在第 10 帧处开始），也可以是流持续时间的相对值（例如，10% 表示在流持续时间的 10% 处开始）。 还支持宏 {Best}，它会指示编码器从视频的前几秒中选择最佳的缩略图，并且无论“步距”和“范围”的其他设置如何，都只会生成一个缩略图。 默认值为宏 {Best}。 必需。
step	str 生成缩略图的间隔。 该值可以采用 ISO 8601 格式 (例如，PT05S 每 5 秒) 一个图像，或者帧计数 (例如，对于每 30 帧) 一个图像为 30，或者流持续时间 (例如，每 10% 流持续时间) 一个图像的 10%。 注意：步骤值将影响第一个生成的缩略图，该缩略图可能不完全是转换预设开始时间指定的缩略图。 这是由于编码器尝试选择开始时间与步骤位置之间的最佳缩略图作为第一个输出。 由于默认值为 10%，这意味着如果流具有较长的持续时间，则生成的第一个缩略图可能远离在开始时间指定的缩略图。 如果预计第一个缩略图接近开始时间，请尝试为 Step 选择合理的值;如果开始时间只需要一个缩略图，则尝试将 Range 值设置为 1。
range	str 相对于转换输入视频中预设开始时间的位置，该时间将停止生成缩略图。 该值可以是 ISO 8601 格式（例如，PT5M30S 表示从开始时间起 5 分 30 秒停止），也可以是帧计数（例如，300 表示在开始时间帧的第 300 帧停止。如果该值为 1，则表示在开始时间处仅生成一个缩略图），或者是相对于流持续时间的相对值（例如，50% 表示从开始时间起的流持续时间的一半处停止）。 默认值是 100%，这表示在流的末尾处停止。
layers	list[JpgLayer] 要由编码器生成的输出 JPEG 图像层的集合。
sprite_column	int 设置缩略图子画面图像中使用的列数。 将自动计算行数，并使用子画面中每个缩略图的坐标映射生成 VTT 文件。 注意：此值应为正整数，建议使用适当的值，以便输出图像分辨率不会超出 JPEG 最大像素分辨率限制 65535x65535。

变量

名称	说明
odata_type	str 派生类型的鉴别器。 必需。
label	str 编解码器的可选标签。 标签可用于控制复用行为。
key_frame_interval	timedelta 两个关键帧之间的距离。 该值应为以 ISO 8601 格式指定的 [0.5， 20] 秒范围内的非零。 默认值为 PT2S) (2 秒。 请注意，如果设置了 VideoSyncMode.Passthrough，则忽略此设置，其中 KeyFrameInterval 值将遵循输入源设置。
stretch_mode	str 或 StretchMode 调整大小模式 - 如何调整输入视频的大小以适应所需的输出分辨率 () 。 默认值为 AutoSize。 已知值为：“None”、“AutoSize”和“AutoFit”。
sync_mode	str 或 VideoSyncMode 视频同步模式。 已知值为：“Auto”、“Passthrough”、“Cfr”和“Vfr”。
start	str 输入视频中开始生成缩略图的位置。 该值可以是 ISO 8601 格式（例如，PT05S 表示在 5 秒处开始），可以是帧计数（例如，10 表示在第 10 帧处开始），也可以是流持续时间的相对值（例如，10% 表示在流持续时间的 10% 处开始）。 还支持宏 {Best}，它会指示编码器从视频的前几秒中选择最佳的缩略图，并且无论“步距”和“范围”的其他设置如何，都只会生成一个缩略图。 默认值为宏 {Best}。 必需。
step	str 生成缩略图的间隔。 该值可以采用 ISO 8601 格式 (例如，PT05S 每 5 秒) 一个图像，或者帧计数 (例如，对于每 30 帧) 一个图像为 30，或者流持续时间 (例如，每 10% 流持续时间) 一个图像的 10%。 注意：步骤值将影响第一个生成的缩略图，该缩略图可能不完全是转换预设开始时间指定的缩略图。 这是由于编码器尝试选择开始时间与步骤位置之间的最佳缩略图作为第一个输出。 由于默认值为 10%，这意味着如果流具有较长的持续时间，则生成的第一个缩略图可能远离在开始时间指定的缩略图。 如果预计第一个缩略图接近开始时间，请尝试为 Step 选择合理的值;如果开始时间只需要一个缩略图，则尝试将 Range 值设置为 1。
range	str 相对于转换输入视频中预设开始时间的位置，该时间将停止生成缩略图。 该值可以是 ISO 8601 格式（例如，PT5M30S 表示从开始时间起 5 分 30 秒停止），也可以是帧计数（例如，300 表示在开始时间帧的第 300 帧停止。如果该值为 1，则表示在开始时间处仅生成一个缩略图），或者是相对于流持续时间的相对值（例如，50% 表示从开始时间起的流持续时间的一半处停止）。 默认值是 100%，这表示在流的末尾处停止。
layers	list[JpgLayer] 要由编码器生成的输出 JPEG 图像层的集合。
sprite_column	int 设置缩略图子画面图像中使用的列数。 将自动计算行数，并使用子画面中每个缩略图的坐标映射生成 VTT 文件。 注意：此值应为正整数，建议使用适当的值，以便输出图像分辨率不会超出 JPEG 最大像素分辨率限制 65535x65535。