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

Image 类

介绍用于从输入视频生成缩略图的基本属性。

你可能想要使用子类，而不是直接使用此类。 已知子类为：JpgImage、PngImage

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

继承

azure.mgmt.media.models._models_py3.Video

Image

构造函数

Image(*, 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, **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%，这表示在流的末尾处停止。

变量

名称	说明
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%，这表示在流的末尾处停止。