文件名变量

最近更新时间:2025-06-09 10:17:22

我的收藏
媒体处理支持使用变量渲染输出文件的目标路径。目前已支持的变量如下:
变量名称
含义
用途说明
inputName
输入文件的文件名。
适用于点播任务。
inputFormat
输入文件的格式。
适用于点播任务。
number
输出文件序号。注意,该变量仅对 HLS 格式下转出的 TS 分片生效。
适用于点播任务。
taskId
任务 ID。
适用于直播任务。
rand
随机数变量。在直播流录制任务中,可以用于自定义录制输出路径,这样在其它路径变量参数相同的情况下,此随机数变量可以避免多个录制结果文件相互覆盖。
适用于直播任务。
streamId
直播任务中的直播流 ID。
适用于直播任务。
subStreamNumber
转自适应码流任务中,描述子流的变量名。
适用于转自适应码流任务。
segmentNumber
开启分片规则后,描述子流分片的变量名。
适用于开启了分片规则的任务。
format
输出文件的格式。
适用于点播任务、直播任务。
definition
参数模板 ID。
适用于点播任务、直播任务。

示例1

如果您的转码要求如下:
输入文件的文件名是 AnimalWorldE01.mp4。
使用100010、100020和100030转码模板做转码。
转出的文件名分别是 AnimalWorldE01_100010.mp4、AnimalWorldE01_100020.mp4 和 AnimalWorldE01_100030.mp4。
则使用 ProcessMedia 接口发起转码时: 应将 InputInfo.CosInputInfo.OutputObjectPath 参数指定为{inputName}_{definition}.{format}

示例2

如果您的转码要求如下:
输入文件的文件名是 AnimalWorldE01.mp4。
使用100210转码模板做转码。
转出的 M3U8 文件名是 AnimalWorldE01_from_mp4.m3u8。
转出的 TS 文件名是 AnimalWorldE01_from_mp4_0.ts、AnimalWorldE01_from_mp4_1.ts 和 AnimalWorldE01_from_mp4_2.ts 等。
则使用 ProcessMedia 接口发起转码时:
应将 InputInfo.CosInputInfo.OutputObjectPath 参数指定为{inputName}_from_{inputFormat}.{format}
应将 InputInfo.CosInputInfo.SegmentObjectName 参数指定为{inputName}_from_{inputFormat}_{number}.{format}