你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
JpgImage interface
描述用于从输入视频生成一系列 JPEG 图像的属性。
- 扩展
属性
| layers | 编码器要生成的输出 JPEG 图像层的集合。 |
| odata |
多态鉴别器，它指定此对象可以是的不同类型 |
| sprite |
设置缩略图子画面图像中使用的列数。 将自动计算行数，并使用子画面中每个缩略图的坐标映射生成 VTT 文件。 注意：此值应为正整数，建议使用适当的值，以便输出图像分辨率不会超过 JPEG 最大像素分辨率限制 65535x65535。 |
继承属性
| key |
两个关键帧之间的距离。 该值应在以 ISO 8601 格式指定的 [0.5， 20] 秒范围内为非零。 PT2S) (默认值为 2 秒。 请注意，如果设置了 VideoSyncMode.Passthrough，则忽略此设置，其中 KeyFrameInterval 值将跟随输入源设置。 |
| label | 编解码器的可选标签。 标签可用于控制复用行为。 |
| range | 输入视频中相对于转换预设开始时间的位置，在该位置停止生成缩略图。 该值可以是 ISO 8601 格式（例如，PT5M30S 表示从开始时间起 5 分 30 秒停止），也可以是帧计数（例如，300 表示在开始时间帧的第 300 帧停止。如果该值为 1，则表示在开始时间处仅生成一个缩略图），或者是相对于流持续时间的相对值（例如，50% 表示从开始时间起的流持续时间的一半处停止）。 默认值是 100%，这表示在流的末尾处停止。 |
| start | 输入视频中开始生成缩略图的位置。 该值可以是 ISO 8601 格式（例如，PT05S 表示在 5 秒处开始），可以是帧计数（例如，10 表示在第 10 帧处开始），也可以是流持续时间的相对值（例如，10% 表示在流持续时间的 10% 处开始）。 还支持宏 {Best}，它会指示编码器从视频的前几秒中选择最佳的缩略图，并且无论“步距”和“范围”的其他设置如何，都只会生成一个缩略图。 默认值为宏 {Best}。 |
| step | 生成缩略图的时间间隔。 值可以是 ISO 8601 格式 (例如，PT05S 表示每 5 秒) 一张图像，或者帧计数 (例如，每 30 帧) 一张图像 30，或流持续时间 (的相对值例如，每 10% 的流持续时间) 一个图像的 10%。 注意：步骤值将影响第一个生成的缩略图，该缩略图可能不完全是转换预设开始时间指定的缩略图。 这是由于编码器，它尝试在开始时间与开始时间的步长位置之间选择最佳缩略图作为第一个输出。 由于默认值为 10%，这意味着如果流的持续时间较长，则第一个生成的缩略图可能远离在开始时间指定的缩略图。 如果第一个缩略图预计接近开始时间，请尝试为 Step 选择合理的值;如果开始时间只需要一个缩略图，请将 Range 值设置为 1。 |
| stretch |
调整大小模式 - 如何调整输入视频的大小以适应所需的输出分辨率 () 。 默认值为 AutoSize |
| sync |
视频同步模式 |
属性详细信息
layers
odataType
多态鉴别器，它指定此对象可以是的不同类型
odataType: "#Microsoft.Media.JpgImage"属性值
"#Microsoft.Media.JpgImage"
spriteColumn
设置缩略图子画面图像中使用的列数。 将自动计算行数，并使用子画面中每个缩略图的坐标映射生成 VTT 文件。 注意：此值应为正整数，建议使用适当的值，以便输出图像分辨率不会超过 JPEG 最大像素分辨率限制 65535x65535。
spriteColumn?: number属性值
number
继承属性详细信息
keyFrameInterval
两个关键帧之间的距离。 该值应在以 ISO 8601 格式指定的 [0.5， 20] 秒范围内为非零。 PT2S) (默认值为 2 秒。 请注意，如果设置了 VideoSyncMode.Passthrough，则忽略此设置，其中 KeyFrameInterval 值将跟随输入源设置。
keyFrameInterval?: string属性值
string
label
range
输入视频中相对于转换预设开始时间的位置，在该位置停止生成缩略图。 该值可以是 ISO 8601 格式（例如，PT5M30S 表示从开始时间起 5 分 30 秒停止），也可以是帧计数（例如，300 表示在开始时间帧的第 300 帧停止。如果该值为 1，则表示在开始时间处仅生成一个缩略图），或者是相对于流持续时间的相对值（例如，50% 表示从开始时间起的流持续时间的一半处停止）。 默认值是 100%，这表示在流的末尾处停止。
range?: string属性值
string
start
输入视频中开始生成缩略图的位置。 该值可以是 ISO 8601 格式（例如，PT05S 表示在 5 秒处开始），可以是帧计数（例如，10 表示在第 10 帧处开始），也可以是流持续时间的相对值（例如，10% 表示在流持续时间的 10% 处开始）。 还支持宏 {Best}，它会指示编码器从视频的前几秒中选择最佳的缩略图，并且无论“步距”和“范围”的其他设置如何，都只会生成一个缩略图。 默认值为宏 {Best}。
start: string属性值
string
step
生成缩略图的时间间隔。 值可以是 ISO 8601 格式 (例如，PT05S 表示每 5 秒) 一张图像，或者帧计数 (例如，每 30 帧) 一张图像 30，或流持续时间 (的相对值例如，每 10% 的流持续时间) 一个图像的 10%。 注意：步骤值将影响第一个生成的缩略图，该缩略图可能不完全是转换预设开始时间指定的缩略图。 这是由于编码器，它尝试在开始时间与开始时间的步长位置之间选择最佳缩略图作为第一个输出。 由于默认值为 10%，这意味着如果流的持续时间较长，则第一个生成的缩略图可能远离在开始时间指定的缩略图。 如果第一个缩略图预计接近开始时间，请尝试为 Step 选择合理的值;如果开始时间只需要一个缩略图，请将 Range 值设置为 1。
step?: string属性值
string
继承自Image_2.step
stretchMode
调整大小模式 - 如何调整输入视频的大小以适应所需的输出分辨率 () 。 默认值为 AutoSize
stretchMode?: string属性值
string