自定义媒体处理输出文件路径--视频点播-火山引擎

文档中心

导航

自定义媒体处理输出文件路径

最近更新时间：2024.11.20 20:15:33首次发布时间：2022.09.07 16:11:33

媒体处理输出文件的路径由系统默认生成。但是如果您需要根据自身业务需求管理片源和媒体处理后文件的存储路径，则可自定义媒体处理输出文件路径。

配置方式

在视频点播控制台工作流页面添加视频转码、极智超清、音频转码、自定义转码组或截图任务时，开启并配置自定义文件路径。如下图所示：

此外，在视频点播控制台上传存储设置页面开启自动生成封面时，可配置自动生成的封面图路径。如下图所示：

注意

上传自动生成封面功能仅支持 {{fileName}}、{{fileTitle}} 和 {{filePrefix}} 变量。

文件路径组成说明

文件路径由固定字符串和变量组成。

固定字符串

固定字符串可用来表示具体的业务信息。例如 watermark 表示有水印、encrypt 表示加密。你指定固定字符串时，需遵循文件命名通用字符规则。

变量

变量是指系统会在生成具体文件路径时获取该变量的实际取值进行动态替换的部分。变量引用格式为 {{变量名称}}。视频点播支持的变量如下表所示。

变量名称	说明
`{{fileName}}`	片源的文件路径，即片源在存储桶中的存储位置。假设一个文件 `123.mp4` 的存储位置为 `BucketName/Project/VideoFiles/123.mp4`，则文件路径为 `Project/VideoFiles/123.mp4`。说明文件路径包括文件前缀、文件名称和文件输出格式。若想要在转码输出文件命名中使用完整片源名称，请使用 `{{fileName}}`。若想要部分片源名称参与命名，则可选用 `{{fileTitle}}` 或 `{{filePrefix}}` ，再和 `{{outFormat}}` 搭配使用。
`{{fileTitle}}`	片源的文件名称。例如， `123.mp4` 文件的文件名称就是 `123`。
`{{filePrefix}}`	片源的文件前缀，是片源文件名称前除存储桶名称外的部分。假设一个文件 `123.mp4` 的存储位置为 `BucketName/Project/VideoFiles/123.mp4`，则文件前缀为 `Project/VideoFiles/`。
`{{vid}}`	片源的视频 ID。即文件上传至视频点播服务后系统自动生成的 `Vid`。
`{{templateId}}`	工作流 ID。
`{{random}}`	32 位随机字符串，例如 `a02befg10001c***584k6dpdnmu87g`。
`{{count}}`	5 位数字占位符，例如 `00001`、`00002`。注意此变量仅适用于采样截图和雪碧图的截图任务，可用来区分多张截图。
`{{outFormat}}`	文件输出格式。系统会根据不同类型的媒体处理模板和封装格式自动补齐后缀。具体映射关系请见文件输出格式。注意封装格式为 DASH 时，不支持自定义文件输出格式。在实际指定文件输出格式时，您需要在 `{{outFormat}}` 前添加 `.` 。
`{{width}}`	截图类型为雪碧图时，截取的缩略小图的宽度。注意此变量仅适用于雪碧图截图任务。
`{{height}}`	截图类型为雪碧图时，截取的缩略小图的高度。注意此变量仅适用于雪碧图截图任务。

文件输出格式

模板类型	封装格式	映射后缀
视频转码模板极智超清模板自定义转码组	MP4	mp4
	HLS	m3u8
	FLV	flv
	TS(MPEGTS)	ts
音频转码模板	MP3	mp3
	M4A	m4a
	MP4	mp4
	HLS	m3u8
	OGG	ogg
画质增强模板	N/A	关闭结果独立存储时：采用视频转码、音频转码或极智超清任务封装格式的映射后缀开启结果独立存储时：统一后缀为 mp4
截图模板	JPEG	jpeg
	WebP	webp
	GIF	gif

自定义文件路径示例

假设：

您的片源地址为 http://www.example.com/tos-vod-v/20220803/demo.mp4。
您通过截图模板对该片源进行采样截图。
您设置的输出文件路径为：{{filePrefix}}{{fileTitle}}_{{count}}.jpg

则最终的采样截图地址为：

http://www.example.com/tos-vod-v/20220803/demo_00001.jpg
http://www.example.com/tos-vod-v/20220803/demo_00002.jpg
http://www.example.com/tos-vod-v/20220803/demo_00003.jpg