【Azure 媒体服务】使用编码预设文件(Preset.json)来自定义编码任务 -- 创建视频缩略图

问题描述

在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