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

Image interface

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

扩展

属性

odataType

多态鉴别器,它指定此对象可以是的不同类型

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。

继承属性

keyFrameInterval

两个关键帧之间的距离。 该值应为以 ISO 8601 格式指定的 [0.5, 20] 秒范围内的非零。 默认值为 PT2S) (2 秒。 请注意,如果设置了 VideoSyncMode.Passthrough,则忽略此设置,其中 KeyFrameInterval 值将遵循输入源设置。

label

编解码器的可选标签。 标签可用于控制复用行为。

stretchMode

调整大小模式 - 如何调整输入视频的大小以适应所需的输出分辨率 () 。 默认值为 AutoSize

syncMode

视频同步模式

属性详细信息

odataType

多态鉴别器,它指定此对象可以是的不同类型

odataType: "#Microsoft.Media.Image" | "#Microsoft.Media.JpgImage" | "#Microsoft.Media.PngImage"

属性值

"#Microsoft.Media.Image" | "#Microsoft.Media.JpgImage" | "#Microsoft.Media.PngImage"

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

继承属性详细信息

keyFrameInterval

两个关键帧之间的距离。 该值应为以 ISO 8601 格式指定的 [0.5, 20] 秒范围内的非零。 默认值为 PT2S) (2 秒。 请注意,如果设置了 VideoSyncMode.Passthrough,则忽略此设置,其中 KeyFrameInterval 值将遵循输入源设置。

keyFrameInterval?: string

属性值

string

继承自Video.keyFrameInterval

label

编解码器的可选标签。 标签可用于控制复用行为。

label?: string

属性值

string

继承自Video.label

stretchMode

调整大小模式 - 如何调整输入视频的大小以适应所需的输出分辨率 () 。 默认值为 AutoSize

stretchMode?: string

属性值

string

继承自Video.stretchMode

syncMode

视频同步模式

syncMode?: string

属性值

string

继承自Video.syncMode