Preset模板
更新时间：2023-04-24
模板是系统预设的对于一个视频资源在做转码计算时所需定义的集合。用户可以更简便的将一个模板应用于一个和多个视频的转码任务，以使这些任务输出相同规格的目标视频资源。
音视频转码为用户预设了丰富且完备的系统模板，以满足用户对于目标规格在格式、码率、分辨率、加解密、水印等诸多方向上的普遍需求，对于不希望过多了解音视频复杂技术背景的用户来说，是最佳的选择。百度为那些在音视频技术上有着丰富积累的用户，提供了可定制化的转码模板，以帮助他们满足复杂业务条件下的转码需求。
当用户仅需对于音视频的容器格式做变化时，百度提供Transmux（转封装, 封装格式转换, 比如mp4转mov）模板帮助用户以秒级的延迟快速完成容器格式的转换，比如从MP4转换成HLS，而保持原音视频的属性不变。
查询当前用户Preset及所有系统Preset
用户可以通过如下代码查询所有的Preset
listPresetsResponse, err := MEDIA_CLIENT.ListPresets()
if err != nil {
fmt.Printf("list preset error: %+v\n", err)
return
}
fmt.Printf("list preset success: %+v\n", listPresetsResponse)查询指定的Preset信息
如下代码通过指定pipelineName查询该Pipeline下的所有Job：
presetName := "test"
getPresetResponse, err := MEDIA_CLIENT.GetPreset(preset)
if err != nil {
fmt.Printf("list preset error: %+v\n", err)
return
}
fmt.Printf("list preset success: %+v\n", getPresetResponse)创建Preset
如果系统预设的Preset无法满足用户的需求，用户可以自定义自己的Preset。根据不同的转码需求，可以使用不同的接口创建Preset。
创建仅支持容器格式转换的Preset
如下代码创建仅执行容器格式转换Preset
presetName := "test"
description := "测试创建模板"
container := "mp4"
err := MEDIA_CLIENT.CreatePreset(presetName, description, container)
if err != nil {
fmt.Printf("create preset error: %+v\n", err)
return
}
fmt.Println("create preset success")创建音频文件的转码Preset，不需要截取片段和加密
如果创建一个不需要截取片段和加密的音频文件转码Preset，可以参考如下代码
preset := &api.Preset{}
preset.PresetName = "go_test_customize"
preset.Description = "自定义创建模板"
preset.Container = "mp3"
audio := &api.Audio{}
audio.BitRateInBps = 256000
preset.Audio = audio
err := MEDIA_CLIENT.CreatePrestCustomize(preset)
if err != nil {
fmt.Printf("create preset error: %+v\n", err)
return
}
fmt.Println("create preset success")创建音频文件转码Preset，需要设置片段截取属性和加密属性
如果创建一个支持截取片段和加密的音频文件转码Preset，可以参考如下代码
preset := &api.Preset{}
preset.PresetName = "go_test_customize_encryption_clip"
preset.Description = "自定义创建模板"
preset.Container = "mp3"
audio := &api.Audio{}
audio.BitRateInBps = 256000
preset.Audio = audio
clip := &api.Clip{}
clip.StartTimeInSecond = 2
clip.DurationInSecond = 10
preset.Clip = clip
encryption := &api.Encryption{}
encryption.Strategy = "PlayerBinding"
preset.Encryption = encryption
err := MEDIA_CLIENT.CreatePrestCustomize(preset)
err := MEDIA_CLIENT.CreatePrestCustomize(preset)
if err != nil {
fmt.Printf("create preset error: %+v\n", err)
return
}
fmt.Println("create preset success")创建视频文件转码Preset，不需要截取片段、加密和水印属性
如果创建一个不需要截取片段，加密和水印的视频文件转码Preset，可以参考如下代码
preset := &api.Preset{}
preset.PresetName = "go_test_customize_audio_video"
preset.Description = "自定义创建模板"
preset.Container = "mp4"
audio := &api.Audio{}
audio.BitRateInBps = 256000
preset.Audio = audio
video := &api.Video{}
video.BitRateInBps = 1024000
preset.Video = video
err := MEDIA_CLIENT.CreatePrestCustomize(preset)
if err != nil {
fmt.Printf("create preset error: %+v\n", err)
return
}
fmt.Println("create preset success")创建视频文件转码Preset，需要设置片段截取、加密和水印属性
如果创建一个需要截取片段，加密和添加水印的视频文件转码Preset，可以参考如下代码
preset := &api.Preset{}
preset.PresetName = "go_test_customize_clp_aud_vid_en_wat"
preset.Description = "自定义创建模板"
preset.Container = "mp4"
clip := &api.Clip{}
clip.StartTimeInSecond = 0
clip.DurationInSecond = 60
preset.Clip = clip
audio := &api.Audio{}
audio.BitRateInBps = 256000
preset.Audio = audio
video := &api.Video{}
video.BitRateInBps = 1024000
preset.Video = video
encryption := &api.Encryption{}
encryption.Strategy = "PlayerBinding"
preset.Encryption = encryption
preset.WatermarkID = "wmk-xxxxxx"
err := MEDIA_CLIENT.CreatePrestCustomize(preset)
if err != nil {
fmt.Printf("create preset error: %+v\n", err)
return
}
fmt.Println("create preset success")创建Preset，指定所有的参数
如果需要定制所有配置参数，可以参考如下代码
preset := &api.Preset{}
preset.PresetName = "go_test_customize_full_args"
preset.Description = "全参数"
preset.Container = "hls"
preset.Transmux = false
clip := &api.Clip{}
clip.StartTimeInSecond = 0
clip.DurationInSecond = 60
preset.Clip = clip
audio := &api.Audio{}
audio.BitRateInBps = 256000
preset.Audio = audio
video := &api.Video{}
video.BitRateInBps = 1024000
preset.Video = video
encryption := &api.Encryption{}
encryption.Strategy = "PlayerBinding"
preset.Encryption = encryption
water := &api.Watermarks{}
water.Image = []string{"wmk-pc0rdhzbm8ff99qw"}
preset.Watermarks = water
transCfg := &api.TransCfg{}
transCfg.TransMode = "normal"
preset.TransCfg = transCfg
extraCfg := &api.ExtraCfg{}
extraCfg.SegmentDurationInSecond = 6.66
preset.ExtraCfg = extraCfg
err := MEDIA_CLIENT.CreatePrestCustomize(preset)
if err != nil {
fmt.Printf("create preset error: %+v\n", err)
return
}
fmt.Println("create preset success")更新Preset
用户可以根据模板名更新自己创建的模板：
preset, _ := MEDIA_CLIENT.GetPreset("go_test_customize")
preset.Description = "test update preset"
err := MEDIA_CLIENT.UpdatePreset(preset)
if err != nil {
fmt.Printf("update preset error: %+v\n", err)
return
}
fmt.Println("update preset success")