问题描述
在Azure门户上创建Transform Encoding时候,只能选择 Built-in Preset 编码方式(如:H265ContentAwareEncoding)
在创建编码任务时,除了在门户上可选的几种内置的编码格式外,还可以通过自定义的编码预设文件(Preset.json)对视频文件进行编码。如 az ams transform 命令:
# Create a transform with a custom Standard Encoder preset from a JSON file and Low relative priority. az ams transform create -a myAmsAccount -n transformName -g myResourceGroup --preset "C:\MyPresets\CustomPreset.json" --relative-priority Low
那么,如何来定义创建视频缩略图的预设编码文件呢?
问题解答
准备 preset.json 文件
查阅 az ams transform 命令的参数 --preset 的所介绍的一句话 “ In addition to the allowed values, you can also pass a path to a custom Standard Encoder preset JSON file. See https://docs.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset for further details on the settings to use to build a custom preset.”
查看 standard encoder preset 的介绍中包含 @odata.type,codecs,formats 等内容。
如: { "@odata.type": "#Microsoft.Media.StandardEncoderPreset", "codecs": [ { "@odata.type": "#Microsoft.Media.CopyVideo" }, { "@odata.type": "#Microsoft.Media.CopyAudio" } ], "formats": [ { "@odata.type": "#Microsoft.Media.Mp4Format", "filenamePattern": "{Basename}_{Bitrate}{Extension}" } ] }
- @odata.type 的值为固定值 #Microsoft.Media.StandardEncoderPreset,表示标准编码预设文件
- codecs为一个数组,表示对输入视频进行编码时要使用的编解码器列表。其中的两个 CopyVideo 和 CopyAudio 都是编码标记,告知编码器复复制输入视频比特流 和 制输入音频比特流。
- formats 表示编码要生成输出的文件,这里表示输出一个MP4文件。
当需要创建一个缩略图的编码文件时候,可以使用codecs 中的 JpgImage 或者 PngImage ,输出的 formats 则使用对应的 JpgFormat 和 PngFormat 。本例中使用JpgImage作为参考:
{ "@odata.type": "#Microsoft.Media.StandardEncoderPreset", "codecs": [ { "@odata.type": "#Microsoft.Media.CopyVideo" }, { "@odata.type": "#Microsoft.Media.CopyAudio" }, { "@odata.type": "#Microsoft.Media.JpgImage", "start": "PT05S", "step": "PT05S", "range": 1, "spriteColumn":10, "layers": [ { "width": "1024", "height": "768", "quality": 90 } ] } ], "formats": [ { "@odata.type": "#Microsoft.Media.Mp4Format", "filenamePattern": "{Basename}_{Bitrate}{Extension}" }, { "@odata.type": "#Microsoft.Media.JpgFormat", "filenamePattern": "{Basename}_{Index}{Extension}" } ] }
以上内容会对输入视频的第5秒生成1张缩略图(range为1),宽1024px,高768px,质量为90. 输入的文件名格式为{Basename}_{Index}{Extension}。关于它们的详细说明,参照官网说明:
JpgImage :https://learn.microsoft.com/en-us/rest/api/media/transforms/create-or-update?tabs=HTTP#jpgimage
JpgFormat :https://learn.microsoft.com/en-us/rest/api/media/transforms/create-or-update?tabs=HTTP#jpgformat
执行 transform create 指令
az ams transform create --account-name yourmediaservicename --resource-group yourresourcegroup --name generate-thumbnail --preset custom-preset.json
如果在执行中遇见错误,可以使用 --debug 参数来查看调试详细的错误。
当执行成功后,会输出如下内容:
检验自定义编码文件的输出成果:
参考资料
JpgImage :https://learn.microsoft.com/en-us/rest/api/media/transforms/create-or-update?tabs=HTTP#jpgimage
JpgFormat :https://learn.microsoft.com/en-us/rest/api/media/transforms/create-or-update?tabs=HTTP#jpgformat
az ams transform create :https://learn.microsoft.com/en-us/cli/azure/ams/transform?view=azure-cli-latest#az-ams-transform-create-examples