Skip to content

Latest commit

 

History

History
86 lines (79 loc) · 4.84 KB

pfopcmd.md

File metadata and controls

86 lines (79 loc) · 4.84 KB

生成音视频转码指令

简介

一般情况下，可能对于大量的音视频资源具体需要转码的规格和参数处于未知情况，根据上一步已经获取到的音视频资源的 avinfo 信息，可以来设置规则判断进行某种 自定义的转码并自定义转码后的文件名。参考：七牛数据处理 pfop 文档， 经过该指令生成之后那么又可以回到 pfop 操作进行批量提交处理请求的操作。

  1. 操作需要指定数据源，因为该操作是针对 avinfo 的信息进行判断，需要本地提供 avinfo 信息的列表，所以只支持本地数据源，请先配置数据源
  2. 单次生成一个 pfop 指令请参考 single 操作
  3. 交互式操作随时输入 avinfo 进行指令生成请参考 interactive 操作

配置

config.txt

path=
process=pfopcmd
indexes=
avinfo-index=
pfop-config=
has-duration=
has-size=
combine=true/false
#cmd=
#saveas=
#scale=
参数名 参数值及类型 含义
process=pfopcmd 该操作设置为pfopcmd 表示根据 avinfo 生成音视频转码指令
indexes 字符串 设置输入行中 key 字段的下标（有默认值），参考数据源 indexes 设置
pfop-config 文件路径字符串 进行转码和另存规则设置的 json 配置文件路径，可设置多个转码条件和指令，配置写法
avinfo-index 字符串 读取 avinfo 信息时需要设置的 avinfo 字符串索引（下标），未设置任何索引时根据 parse 类型默认为 1 或 "avinfo"，参见关于 parse 和索引
has-duration true/false 得到的结果行中是否需要保存 duration（音视频时长）信息，会放在转码指令字段之后
has-size true/false 得到的结果行中是否需要保存 size（音视频大小）信息，会放在 duration 字段之后
combine true/false 多个 pfop 命令时，是否组合成一个命令来处理，默认为 true，使用 ; 来拼接多条处理命令，参考persistentOps 多个命令
cmd 字符串 pfop 命令，如 avthumb/mp4，和 pfop-config 中的 cmd 相同，如果不想设置 pfop-config 配置文件则可采用 cmd + saveas + scale 设置的方式
saveas 字符串 saveas 的格式，如 bucket:$(key)F720.mp4，和 pfop-config 中的 saveas 相同，如果不想设置 pfop-config 配置文件则可采用 cmd + saveas + scale 设置的方式
scale 字符串 scale 的格式，如 [1000,1280]，和 pfop-config 中的 scale 相同，如果不想设置 pfop-config 配置文件则可采用 cmd + saveas + scale 设置的方式

运行参数：-config=config.txt

pfop-config 配置文件

{
  "pfopcmd":[
    {
      "scale":[1000,1280],
      "cmd":"avthumb/mp4/s/1280x720/autoscale/1",
      "saveas":"bucket:$(name)_F720.mp4"
    },
    {
      "scale":[1280],
      "cmd":"avthumb/mp4/s/1280x720/autoscale/1",
      "saveas":"bucket:1080P-$(key)"
    },
    {
      "cmd":"avthumb/mp4/s/640x480/autoscale/1",
      "saveas":"bucket:$(name)_F480.mp4"
    },
    {
      "cmd":"avthumb/mp4/s/640x480/autoscale/1/ss/0/t/$(duration)",
      "saveas":"bucket:$(name)_F480.mp4"
    }
  ]
}

如上所示，pfopcmd 操作的配置名称为 "pfopcmd"，配置项为 json array，可参见 pfop-config 配置

必须选项 含义
key 上述配置文件中的 F720 为转码项名称，设置为 json key，key 不可重复，重复情况下后者会覆盖前者
scale 表示视频分辨率 width 的范围，只设置了一个值则表示目标范围大于该值，程序根据 avinfo 判断宽度范围对在此区间的文件生成转码指令
cmd 需要指定的转码指令，这里 cmd 支持魔法变量
saveas 转码结果另存的格式，写法为：<bucket>:<key>，其中 <key> 支持魔法变量

魔法变量

$(duration) 表示使用 avinfo 中 format 封装信息中的 duration 值来设置该参数
$(name) 表示去除后缀的原始文件名（如 a.jpg/a.png/a 的 $(name) 均为 a）
$(ext) 表示文件名的后缀部分（如 a.jpg/b.jpg 的 $(ext) 均为 jpg，c 的 $(ext) 为空字符串）
$(key) 表示完整的原始文件名（如 a.jpg/a.png 的 $(key) 分别为为 a.jpg/a.png）

saveas 格式拼接

格式需要遵循 <bucket>:<key>，允许只有 <bucket>，此时表示由七牛自动生成文件名，但是不允许缺少 <bucket>，且不允许以 : 开头或结尾的格式。

命令行方式

-path= -process=pfopcmd -pfop-config= -has-duration= -has-size=