Package com.seeshiontech.vesdk
Class VeProcessRenderTask
- java.lang.Object
-
- com.seeshiontech.vesdk.VeProcessRenderTask
-
public class VeProcessRenderTask extends java.lang.Object
-
-
Constructor Summary
Constructors Constructor Description VeProcessRenderTask(java.lang.String license, java.lang.String tplFolder, java.lang.String outputPath)VeProcessRenderTask(java.lang.String license, java.lang.String tplFolder, java.lang.String outputFile, java.lang.String[] assetPaths)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddAudioTrack(AudioTrack track)添加音轨voiddestroy()销毁渲染资源,必须调用java.util.List<AudioTrack>getAudioTrackList()ErrorCodegetErrorCode()获取渲染错误码java.lang.StringgetErrorMsg()获取渲染错误信息java.lang.StringgetLicenseProfile()获取 license 信息VeResolutionRatiogetOutputRatio()floatgetRenderProgress()获取渲染进度 无论成功失败,最终都会返回 1.0java.lang.StringgetStatus()获取渲染任务状态java.lang.StringgetTaskRenderedInfo()获取渲染后的信息, 在 render() 后调用java.util.List<Watermark>getWatermarkList()booleanisLicenseValid()检查 license 是否有效booleanrender()启动渲染voidsetAssetDir(java.lang.String assetPath)设置引擎生成的素材存放目录voidsetAssetLoop(boolean assetLoop)设置视频素材在时长小于图层时是否循环,默认 truevoidsetAssetPaths(java.lang.String[] paths)设置替换素材路径voidsetAudioTrackList(java.util.List<AudioTrack> audioTrackList)设置音轨列表voidsetBitrateControl(float control)设置视频比特率控制参数,默认 0.25voidsetDrawTextMode(VeDrawTextMode drawTextMode)设置文字绘制方式voidsetDynamicAdaptVideo(boolean adaptVideo)是否启用视频素材自适应功能,只对动态模板有效 开启后,视频素材展示为下列两种情况: + 视频时长 < 片段时长,视频素材只会播放一遍,然后停留在最后1帧 + 视频时长 > 片段时长,视频素材会被分拆成多段,在连续的片段中播放voidsetDynamicSubFiles(java.lang.String json)设置动态模板附加素材voidsetDynamicSubTexts(java.lang.String subTextJson)为动态模板设置关联的附加文字voidsetEnableSourceManager(boolean enable)开启素材缓存管理voidsetFontDirPath(java.lang.String fontDirPath)设置字符动画字体路径voidsetMusicEnable(boolean musicEnable)设置音乐是否启用voidsetMusicFadeoutDuration(int musicFadeoutDuration)设置背景淡出时间, 单位秒voidsetMusicLoop(boolean musicLoop)设置音乐是否循环voidsetMusicPath(java.lang.String musicPath, boolean loopMusic)设置背景音乐文件voidsetMusicVolume(float musicVolume)设置背景音量 0 - 1.0, 输出音量为原音量 * musicVolumevoidsetOutputRatio(VeResolutionRatio outputRatio)设置视频的输出缩放比例,默认100%voidsetReplaceableJson(java.lang.String json)设置替换素材 json 参考 http://www.seeshiontech.com/docs/page_103.htmlvoidsetRetainAudioOfVideo(boolean retainAudioOfVideo)是否保留视频素材的音频,voidsetScriptData(java.lang.String scriptData)设置脚本参数voidsetScriptDir(java.lang.String scriptDir)设置脚本目录voidsetScriptMainFile(java.lang.String scriptMainFile)设置脚本主文件路径voidsetSnapShotFrames(int[] snapShotFrames)设置快照帧索引 [1, 100] 表示第1, 100 帧会被生成 1.png , 100.png 到 snapshot path 目录中voidsetSnapShotPath(java.lang.String snapShotPath)设置快照保存目录 2.voidsetSourceManagerCacheSize(int size)设置素材管理器缓存大小,单位 MvoidsetTemplateType(TemplateType type)设置模板类型voidsetTextPainterDir(java.lang.String textPainterPath)设置文字绘制工具目录voidsetWatermarkList(java.util.List<Watermark> watermarkList)设置水印列表
-
-
-
Constructor Detail
-
VeProcessRenderTask
public VeProcessRenderTask(java.lang.String license, java.lang.String tplFolder, java.lang.String outputPath)
-
VeProcessRenderTask
public VeProcessRenderTask(java.lang.String license, java.lang.String tplFolder, java.lang.String outputFile, java.lang.String[] assetPaths)
-
-
Method Detail
-
setTemplateType
public void setTemplateType(TemplateType type)
设置模板类型- Parameters:
type-
-
isLicenseValid
public boolean isLicenseValid()
检查 license 是否有效- Returns:
- boolean
-
getLicenseProfile
public java.lang.String getLicenseProfile()
获取 license 信息- Returns:
- String
-
getErrorMsg
public java.lang.String getErrorMsg()
获取渲染错误信息- Returns:
- String, see
RenderStatus
-
setAssetPaths
public void setAssetPaths(java.lang.String[] paths)
设置替换素材路径- Parameters:
paths-
-
setReplaceableJson
public void setReplaceableJson(java.lang.String json)
设置替换素材 json 参考 http://www.seeshiontech.com/docs/page_103.html- Parameters:
json-
-
setMusicPath
public void setMusicPath(java.lang.String musicPath, boolean loopMusic)设置背景音乐文件- Parameters:
musicPath- , 禁用背景音乐传空字符串 ""loopMusic-
-
setMusicLoop
public void setMusicLoop(boolean musicLoop)
设置音乐是否循环- Parameters:
musicLoop-
-
setMusicEnable
public void setMusicEnable(boolean musicEnable)
设置音乐是否启用- Parameters:
musicEnable-
-
setMusicFadeoutDuration
public void setMusicFadeoutDuration(int musicFadeoutDuration)
设置背景淡出时间, 单位秒- Parameters:
musicFadeoutDuration-
-
setMusicVolume
public void setMusicVolume(float musicVolume)
设置背景音量 0 - 1.0, 输出音量为原音量 * musicVolume- Parameters:
musicVolume-
-
addAudioTrack
public void addAudioTrack(AudioTrack track)
添加音轨- Parameters:
track- , seeAudioTrack
-
setAudioTrackList
public void setAudioTrackList(java.util.List<AudioTrack> audioTrackList)
设置音轨列表- Parameters:
audioTrackList-
-
getAudioTrackList
public java.util.List<AudioTrack> getAudioTrackList()
-
setBitrateControl
public void setBitrateControl(float control)
设置视频比特率控制参数,默认 0.25- Parameters:
control-
-
setWatermarkList
public void setWatermarkList(java.util.List<Watermark> watermarkList)
设置水印列表- Parameters:
watermarkList-
-
getWatermarkList
public java.util.List<Watermark> getWatermarkList()
-
setDynamicSubFiles
public void setDynamicSubFiles(java.lang.String json)
设置动态模板附加素材- Parameters:
json- , 附加素材数据, json 字符串
-
setDynamicSubTexts
public void setDynamicSubTexts(java.lang.String subTextJson)
为动态模板设置关联的附加文字1. 当前文字是由 TextPainter 绘制,使用这个接口, 必须先设置好 assetPath 和 textpianter path
2. 非动态模板设置无效- Parameters:
subTextJson- , 文字素材数组
-
setAssetDir
public void setAssetDir(java.lang.String assetPath)
设置引擎生成的素材存放目录1. TextPainter 绘制的文字图片会被放到设置的目录, 引擎不会对该目录执行清理动作, 需要调用方在渲染完成后,删除该目录进行清理
2. 为避免文件被其他任务修改覆盖,确保该目录只被当前任务读写- Parameters:
assetPath- , 素材存放目录
-
setTextPainterDir
public void setTextPainterDir(java.lang.String textPainterPath)
设置文字绘制工具目录1. 引擎使用该目录的 TextPainter 和 font_list.json 进行文字绘制
- Parameters:
textPainterPath- , 文字绘制工具目录
-
setDrawTextMode
public void setDrawTextMode(VeDrawTextMode drawTextMode)
设置文字绘制方式1. 如果调用了 setTextPainterDir, mode 会被强制设置成 USE_TEXTPAINTER 2. 使用 USE_COREPAINTER 时,请先调用 setFontDirPath 设置好字体目录 3. 必须调用 setAssetDir 设置临时文件的存储路径
- Parameters:
drawTextMode- ,VeDrawTextMode
-
setScriptDir
public void setScriptDir(java.lang.String scriptDir)
设置脚本目录- Parameters:
scriptDir-
-
setScriptData
public void setScriptData(java.lang.String scriptData)
设置脚本参数- Parameters:
scriptData-
-
setScriptMainFile
public void setScriptMainFile(java.lang.String scriptMainFile)
设置脚本主文件路径- Parameters:
scriptMainFile-
-
setSnapShotPath
public void setSnapShotPath(java.lang.String snapShotPath)
设置快照保存目录 2. 为避免文件被其他任务修改覆盖,确保该目录只被当前任务读写- Parameters:
snapShotPath- , 目录
-
setSnapShotFrames
public void setSnapShotFrames(int[] snapShotFrames)
设置快照帧索引 [1, 100] 表示第1, 100 帧会被生成 1.png , 100.png 到 snapshot path 目录中- Parameters:
snapShotFrames- , 帧数组
-
setEnableSourceManager
public void setEnableSourceManager(boolean enable)
开启素材缓存管理- Parameters:
enable- , true or false
-
setSourceManagerCacheSize
public void setSourceManagerCacheSize(int size)
设置素材管理器缓存大小,单位 M- Parameters:
size- , 默认 300
-
setRetainAudioOfVideo
public void setRetainAudioOfVideo(boolean retainAudioOfVideo)
是否保留视频素材的音频,- Parameters:
retainAudioOfVideo- , true or false, 默认: false
-
setDynamicAdaptVideo
public void setDynamicAdaptVideo(boolean adaptVideo)
是否启用视频素材自适应功能,只对动态模板有效 开启后,视频素材展示为下列两种情况: + 视频时长 < 片段时长,视频素材只会播放一遍,然后停留在最后1帧 + 视频时长 > 片段时长,视频素材会被分拆成多段,在连续的片段中播放- Parameters:
adaptVideo-
-
setFontDirPath
public void setFontDirPath(java.lang.String fontDirPath)
设置字符动画字体路径- Parameters:
fontDirPath-
-
setAssetLoop
public void setAssetLoop(boolean assetLoop)
设置视频素材在时长小于图层时是否循环,默认 true- Parameters:
assetLoop-
-
getOutputRatio
public VeResolutionRatio getOutputRatio()
-
setOutputRatio
public void setOutputRatio(VeResolutionRatio outputRatio)
设置视频的输出缩放比例,默认100%- Parameters:
outputRatio-
-
render
public boolean render() throws InvalidLicenseException, RenderException, NotSupportedTemplateException启动渲染- Returns:
- boolean
- Throws:
InvalidLicenseExceptionRenderExceptionNotSupportedTemplateException
-
getRenderProgress
public float getRenderProgress()
获取渲染进度 无论成功失败,最终都会返回 1.0- Returns:
- float, 范围 0.0 - 1.0
-
getStatus
public java.lang.String getStatus()
获取渲染任务状态- Returns:
- String, see
RenderStatus
-
getTaskRenderedInfo
public java.lang.String getTaskRenderedInfo()
获取渲染后的信息, 在 render() 后调用
-
destroy
public void destroy()
销毁渲染资源,必须调用
-
-