API | 描述 |
初始化 SDK。支持两种形式： 1. initSDK(Context context, String resPath) 使用静态库并指定 light_assets 目录。2. initSDK(Context context, String resPath, String libsPath) 支持自定义动态库目录。 | |
拷贝 AI 模型文件：将已下载好的 AI 模型文件从 srcPath 复制到 resDir 对应的资源目录。返回 0 表示成功，-1 表示 srcPath 不存在，-2 表示 IO 错误。 | |
将 assets 下的 AI 模型文件拷贝到本地指定路径 path，需与 initSDK 传入的路径保持一致。返回 0 表示成功，-1 表示 context 为空，-2 表示 IO 错误。 | |
获取 SDK 初始化时保存的全局 Application Context。 | |
获取当前 SDK 版本号，格式为 VERSION_NAME.VERSION_CODE。 | |
获取当前使用的 Light Assets 根目录路径。 | |
设置缩略图文件缓存目录根路径。 | |
设置缩略图的内存缓存大小。 | |
设置缩略图的磁盘缓存容量上限。 | |
设置缩略图软件解码使用的线程数量。 | |
设置 SDK 日志等级。 setLogLevel(int level) 仅设置日志等级；setLogLevel(int level, ITELogger logger) 同时设置日志等级并接入自定义日志回调。 |
public static boolean initSDK(Context context, String resPath)参数名 | 类型 | 说明 |
context | Context | Android 上下文对象，内部会使用 getApplicationContext() 保存全局引用。 |
resPath | String | Light Assets 根目录路径，用于安装 light_assets 资源。 |
boolean true，加载 SO 或资源失败返回 false。public static boolean initSDK(Context context, String resPath, String libsPath)参数名 | 类型 | 说明 |
context | Context | Android 上下文对象，内部会使用 getApplicationContext() 保存全局引用。 |
resPath | String | Light Assets 根目录路径，用于安装 light_assets 资源。 |
libsPath | String | 自定义动态库目录路径，用于加载 TAV 相关 SO 文件。 |
boolean true，加载 SO 或资源失败返回 false。public static int installAIModelFile(String srcPath, String resDir)参数名 | 类型 | 说明 |
srcPath | String | 存放 AI 模型文件的源目录路径（已下载完成的模型文件所在目录）。 |
resDir | String | 用于存放美颜资源的根目录，此目录与创建 XmagicApi 对象时传入的路径一致。 |
int 0：拷贝成功。-1：srcPath 不存在。-2：IO 错误。assets 目录下的 AI 模型文件拷贝到本地指定路径。 public static int installAIModelFilesFromAssets(Context context, String path)参数名 | 类型 | 说明 |
context | Context | Android 上下文对象，拷贝 assets 资源时需要使用。 |
path | String | 拷贝资源的目标路径，需要与 initSDK 时传入的 Light Assets 路径保持一致。 |
int 0：复制成功。-1：context 为 null。-2：IO 错误。initSDK 时保存的 Application Context，用于在 SDK 内部全局复用，避免泄漏 Activity / Service 等组件。 public static Context getApplicationContext()Context Context；如未初始化可能为 null（调用前请确保已执行 initSDK）。public static String getSDKVersion()String "{VERSION_NAME}.{VERSION_CODE}" 的版本字符串，例如：1.2.3.45。public static String getLightAssetsDir()String initSDK 传入并经 TAVResourceUtil.fixPathSuffix 处理后的 Light Assets 根目录；若未初始化可能为 null。initSDK 内部会默认设置为 context.getCacheDir()/thumbnails，如业务需要自定义目录可再次调用该方法覆盖。 public static void setThumbnailCacheDir(String cacheDirPath)参数名 | 类型 | 说明 |
cacheDirPath | String | 缩略图磁盘缓存目录的路径（文件夹）。 |
void TAVFrameExtractorConfig 的实现），用于控制缩略图内存占用。 public static void setThumbnailMemoryCacheSize(int cacheSize)参数名 | 类型 | 说明 |
cacheSize | int | 内存缓存大小配置值。 |
void public static void setThumbnailCacheCapacity(long capacity)参数名 | 类型 | 说明 |
capacity | long | 磁盘缓存最大容量（单位：字节）。 |
void public static void setThumbnailThreadCount(int count)参数名 | 类型 | 说明 |
count | int | 线程数量（>0 的整数）。 |
void setLogLevel(level, null)，仅控制内部统一日志级别，不接入自定义日志回调。 public static void setLogLevel(int level)参数名 | 类型 | 说明 |
level | int | 日志级别，推荐使用 Log.VERBOSE / Log.DEBUG / Log.INFO / Log.WARN / Log.ERROR / TAVMagicBase.NO_LOG。 |
void ITELogger。 public static void setLogLevel(int level, ITELogger logger)参数名 | 类型 | 说明 |
level | int | 日志级别，推荐使用 Log.VERBOSE / Log.DEBUG / Log.INFO / Log.WARN / Log.ERROR / TAVMagicBase.NO_LOG。 |
logger | ITELogger | 自定义日志回调接口实现；传入 null 则仅通过内部 TELog 输出，不再回调到业务层。 |
void API | 描述 |
初始化编辑器，传入预览参数（父容器和渲染方式等）。 | |
销毁编辑器，释放内部资源。 | |
设置模板目录路径，返回模板加载结果码。 0：SUCCESS -1：PATH_INVALID -2：AUTH_INVALID | |
获取当前模板目录的绝对路径。 | |
获取指定模板路径的坑位配置信息（模板占位、文案、素材要求等）。 | |
从当前编辑对象复制创建一个新的编辑实例，可根据预览参数创建上屏 / 离屏实例并决定是否创建渲染链。 | |
读取当前渲染画面的快照，结果通过回调异步返回。 | |
获取当前预览使用的渲染尺寸。 | |
根据导出质量等级获取导出视频使用的渲染尺寸。 | |
设置画布宽高比例（存为比例，不直接作为最终像素宽高）。 | |
添加视频资源：支持在末尾追加或在指定位置插入视频列表，返回成功添加后的索引。 | |
添加图片资源：支持在末尾追加或在指定位置插入图片列表，可指定播放时长，返回成功添加后的索引。 | |
获取当前正在编辑的资源（视频/图片）总数量。 | |
按资源下标移除对应的视频或图片资源。 | |
设置指定资源的播放时间区间（startTimeUs ~ endTimeUs），视频会在该区间内截取播放。 | |
设置指定视频资源的音量（0–1f）。 | |
设置所有输入资源的统一背景音量（0–1f）。 | |
获取指定视频资源的当前音量。 | |
设置指定视频资源的播放速度。 | |
获取指定视频资源的播放速度。 | |
调整资源顺序，将资源从旧下标移动到新下标，返回是否调整成功。 | |
获取输入视频路径对应的基础信息（时长、宽、高等）。 | |
获取原始视频帧抽帧接口，可配置是否强制使用软解码。 | |
添加背景音乐，指定插入到视频时间轴的位置、素材起始时间和播放时长，返回唯一 BGM ID。 | |
按 BGM 唯一 ID 删除背景音乐，返回删除是否成功。 | |
调整背景音乐在视频时间轴上的起始播放位置。 | |
设置指定背景音乐在素材内的播放区间（开始时间和持续时长）。 | |
设置指定背景音乐的音量（建议范围 0–3f）。 | |
设置所有背景音乐的统一音量（建议范围 0–3f）。 | |
获取指定背景音乐的当前音量。 | |
设置指定背景音乐的播放速度。 1为正常 大于1为变快 小于1为变慢 | |
获取指定背景音乐的播放速度。 | |
设置播放器是否启用循环播放。 | |
设置预览监听器，用于接收播放进度、完成、错误等回调。 | |
开始播放预览。 | |
设置预览播放的时间区间（开始时间与持续时长）。 | |
在暂停后继续播放预览。 | |
暂停当前预览播放。 | |
获取当前工程的总播放时长（单位：us）。 | |
判断当前是否处于播放中状态。 | |
将播放位置移动到指定时间点，可选择非精准 seek（跳到临近关键帧）。 | |
设置指定视频资源的顺时针旋转角度（0–360°）。 | |
设置指定视频资源的裁剪区域（相对渲染尺寸归一化的 RectF）。 | |
设置自定义纹理处理回调，用于对渲染纹理做二次处理。 | |
移除自定义纹理处理回调。 | |
添加滤镜效果，传入 LUT 路径、强度和时间区间，返回唯一滤镜 ID。 | |
调整指定滤镜的强度（0–1f）。 | |
删除指定滤镜效果。 | |
获取贴纸管理接口，用于添加、编辑和删除贴纸。 | |
获取画中画管理接口，用于添加、编辑和删除画中画内容。 | |
在指定位置设置转场素材，配置资源路径与时长，返回转场 ID。 | |
更新指定转场效果的持续时长。 | |
删除指定转场效果，返回删除是否成功。 | |
添加动效，支持基础版本和带 scaleMode 的版本，返回动效 ID。 | |
调整指定动效的播放时间区间（开始节点与持续时长）。 | |
删除指定动效。 | |
获取某一时间点的渲染结果图像，按长边缩放并指定渲染场景，通过回调返回。 | |
获取帧提供接口，根据长边长度和渲染场景持续生成渲染结果。 | |
导出视频：支持按预设导出等级或自定义编码配置导出至指定路径，并通过监听器获取进度和结果。 | |
取消当前正在进行的视频导出任务。 | |
立即刷新当前渲染，支持无参调用或携带 tag 与回调，在刷新完成后执行回调。 | |
获取草稿管理接口，用于保存、恢复和管理编辑草稿。 |
void initWithPreview(TAVEditorConstants.PreviewParam param)参数名 | 类型 | 说明 |
param | 预览参数（父容器、渲染方式等）。 |
void void release()void param.videoView = null：创建离屏实例。param.videoView != null：创建上屏实例。param = null：创建默认离屏实例。param != null：根据 param.scene 决定是否创建渲染链。TAVEditor fork(TAVEditorConstants.PreviewParam param)参数名 | 类型 | 说明 |
param | 新实例的预览配置参数。 |
TAVEditor void readSnapshot(TAVSnapshotCallback callback)参数名 | 类型 | 说明 |
callback | TAVSnapshotCallback | 快照获取成功时回调。 |
void int setTemplateDir(String path)参数名 | 类型 | 说明 |
path | String | 模板目录路径。 |
int TAVTemplateCode：0表示 SUCCESS，-1为 PATH_INVALID，-2为 AUTH_INVALID。String getTemplateDir()String TAVTemplateConfig getTemplateConfig(String templatePath)参数名 | 类型 | 说明 |
templatePath | String | 模板路径。 |
TAVTemplateConfig Size getRenderSize()Size VIDEO_LEVEL_360P = 0：360×640 VIDEO_LEVEL_480P = 1：640×480 VIDEO_LEVEL_540P = 2：960×540 VIDEO_LEVEL_720P = 3：1280×720 VIDEO_LEVEL_1080P = 4：1920×1080Size getGeneratingRenderSize(@TAVEditorConstants.GenerateLevel int level)参数名 | 类型 | 说明 |
level | int（@GenerateLevel） | 导出质量等级（分辨率档位）。 |
Size void setRenderSizeRatio(int width, int height)参数名 | 类型 | 说明 |
width | int | 画布比例宽度。 |
height | int | 画布比例高度。 |
void int addVideoClip(String path)参数名 | 类型 | 说明 |
path | String | 视频文件路径。 |
int int addVideoClip(int clipIndex, List<String> paths)参数名 | 类型 | 说明 |
clipIndex | int | 插入位置的目标下标。 |
paths | List\\<String> | 待编辑的视频源路径列表。 |
int duration <= 0 时默认使用 3 秒时长。int addImageClip(String path, long duration)参数名 | 类型 | 说明 |
path | String | 图片源路径。 |
duration | long | 图片展示时长（单位：us，<=0 默认 3s）。 |
int duration <= 0 时默认使用 3 秒时长。int addImageClip(int clipIndex, List<String> paths, long duration)参数名 | 类型 | 说明 |
clipIndex | int | 插入位置的目标下标。 |
paths | List\\<String> | 图片源路径列表。 |
duration | long | 每张图片展示时长（单位：us，<=0 默认 3s）。 |
int int getClipCount()int void removeClip(int clipIndex)参数名 | 类型 | 说明 |
clipIndex | int | 需要移除的下标。 |
void startTimeUs 和 endTimeUs 用于截取视频的播放区间。void setClipRange(int clipIndex, long startTimeUs, long endTimeUs)参数名 | 类型 | 说明 |
clipIndex | int | 资源下标。 |
startTimeUs | long | 资源播放开始时间（us）。 |
endTimeUs | long | 资源播放结束时间（us）。 |
void void setVideoClipVolume(int clipIndex, float volume)参数名 | 类型 | 说明 |
clipIndex | int | 视频资源下标。 |
volume | float | 音量，范围 0–1f。 |
void void setAllClipsVolume(float volume)参数名 | 类型 | 说明 |
volume | float | 音量，范围 0–1f。 |
void float getVideoClipVolume(int clipIndex)参数名 | 类型 | 说明 |
clipIndex | int | 视频下标。 |
float void setVideoClipSpeed(int clipIndex, float speed)参数名 | 类型 | 说明 |
clipIndex | int | 视频下标。 |
speed | float | 播放速度倍数。 |
void float getVideoClipSpeed(int clipIndex)参数名 | 类型 | 说明 |
clipIndex | int | 视频下标。 |
float boolean updateClipIndex(int oldClipIndex, int newClipIndex)参数名 | 类型 | 说明 |
oldClipIndex | int | 调整前的下标。 |
newClipIndex | int | 调整后的下标。 |
boolean TAVVideoInfo getVideoInfo(String path)参数名 | 类型 | 说明 |
path | String | 视频文件路径。 |
TAVVideoInfo ITAVThumbProvider getThumbnailProvider(boolean forceUseSoftwareDecoding)参数名 | 类型 | 说明 |
forceUseSoftwareDecoding | boolean | 是否强制使用软解码抽帧。 |
int addBgm(String path, long startAtVideoTimeUS, long startTimeUS, long duration)参数名 | 类型 | 说明 |
path | String | 背景音乐素材文件路径。 |
startAtVideoTimeUS | long | 音乐添加到视频中的时间位置（us）。 |
startTimeUS | long | 音频素材自身的起始播放时间（us）。 |
duration | long | 音频播放时长（us）。 |
int boolean removeBgm(int bgmID)参数名 | 类型 | 说明 |
bgmID | int | 添加背景音乐时生成的唯一 ID。 |
boolean void updateBgmPlayOffset(int bgmID, long videoStartTime)参数名 | 类型 | 说明 |
bgmID | int | 背景音乐唯一 ID。 |
videoStartTime | long | 在视频中的起始 position（Us）。 |
void void updateBgmPlayRange(int bgmID, long startTime, long duration)参数名 | 类型 | 说明 |
bgmID | int | 背景音乐唯一 ID。 |
startTime | long | 背景音乐开始播放时间（us）。 |
duration | long | 背景音乐持续时长（us）。 |
void void setBgmVolume(int bgmID, float volume)参数名 | 类型 | 说明 |
bgmID | int | 背景音乐唯一 ID。 |
volume | float | 音量，建议范围 0–3f。 |
void void setAllBgmVolume(float volume)参数名 | 类型 | 说明 |
volume | float | 音量，建议范围 0–3f。 |
void float getBgmVolume(int bgmID)参数名 | 类型 | 说明 |
bgmID | int | 背景音乐唯一 ID。 |
float void setBgmSpeed(int bgmID, float speed)参数名 | 类型 | 说明 |
bgmID | int | 背景音乐唯一 ID。 |
speed | float | 播放速度倍数，1 为正常，大于 1 变快，小于 1 变慢。 |
void float getBgmSpeed(int bgmID)参数名 | 类型 | 说明 |
bgmID | int | 背景音乐唯一 ID。 |
float void setPlayerLoop(boolean loop)参数名 | 类型 | 说明 |
loop | boolean | 是否循环播放。 |
void void setVideoPreviewListener(TAVPreviewListener listener)参数名 | 类型 | 说明 |
listener | 预览播放监听回调。 |
void void startPlay()void void setPlayTimeRange(long startTime, long duration)参数名 | 类型 | 说明 |
startTime | long | 播放开始时间（us）。 |
duration | long | 播放持续时长（us）。 |
void void resumePlay()void void pausePlay()void long getTotalDuration()long boolean isPlaying()boolean true 表示正在播放，false 表示未播放。void seekToTime(long timeUs, boolean isInAccurate)参数名 | 类型 | 说明 |
timeUs | long | 跳转的目标时间（us）。 |
isInAccurate | boolean | 是否开启非精准 seek： true 跳至临近关键帧，false 精准到指定位置。 |
void void setClipRotation(int clipIndex, @FloatRange(from = 0, to = 360f) float degrees)参数名 | 类型 | 说明 |
clipIndex | int | 视频片段索引。 |
degrees | float | 旋转角度，范围 0–360（度数）。 |
void rectF 为相对于渲染尺寸归一化后的裁剪矩形。void setClipRect(int clipIndex, RectF rectF)参数名 | 类型 | 说明 |
clipIndex | int | 视频片段索引。 |
rectF | RectF | 相对渲染尺寸归一化的裁剪区域矩形。 |
void void setCustomVideoProcessListener(TAVCustomProcessListener listener)参数名 | 类型 | 说明 |
listener | TAVCustomProcessListener | 自定义纹理处理回调。 |
void void removeCustomVideoProcessListener()void int addFilter(String lutPath, float strength, long startPts, long endPts)参数名 | 类型 | 说明 |
lutPath | String | 滤镜素材路径（LUT 文件等）。 |
strength | float | 滤镜强度（0–1f）。 |
startPts | long | 生效开始时间（us）。 |
endPts | long | 生效结束时间（us）。 |
int void setFilterStrength(int filterId, float strength)参数名 | 类型 | 说明 |
filterId | int | 滤镜唯一 ID。 |
strength | float | 滤镜强度（0–1f）。 |
void void removeFilter(int filterId)参数名 | 类型 | 说明 |
filterId | int | 滤镜唯一 ID。 |
void ITAVStickerManager getStickerManager()ITAVPipManager getPipManager()int setTransition(int clipIndex, String path, long durationUS)参数名 | 类型 | 说明 |
clipIndex | int | 转场所在位置（片段之间的索引）。 |
path | String | 转场资源路径。 |
durationUS | long | 转场持续时长（us）。 |
int void updateTransitionDuration(int transitionId, long durationUS)参数名 | 类型 | 说明 |
transitionId | int | 转场 ID |
durationUS | long | 新的转场时长（us） |
void boolean removeTransition(int transitionId)参数名 | 类型 | 说明 |
transitionId | int | 转场 ID |
boolean int addMotionEffect(String path, long startOffset, long duration)参数名 | 类型 | 说明 |
path | String | 动效素材路径 |
startOffset | long | 生效开始时间偏移（us） |
duration | long | 播放时长（us） |
int int addMotionEffect(String path, long startOffset, long duration, int scaleMode)参数名 | 类型 | 说明 |
path | String | 动效素材路径 |
startOffset | long | 生效开始时间偏移（us） |
duration | long | 播放时长（us） |
scaleMode | int | 缩放模式 |
int void updateMotionEffectPlayRange(int motionId, long startOffset, long duration)参数名 | 类型 | 说明 |
motionId | int | 动效唯一 ID |
startOffset | long | 生效开始时间偏移（us） |
duration | long | 播放时长（us） |
void void removeMotionEffect(int motionId)参数名 | 类型 | 说明 |
motionId | int | 动效唯一 ID |
void void getFrameAtTime(long positionUs, int longSideLength, int scene, TAVGetFrameListener listener)参数名 | 类型 | 说明 |
positionUs | long | 时间点（us） |
longSideLength | int | 输出图片的最长边长度，内部会按比例计算另一边 |
scene | int（@RenderScene） | 渲染场景，参考 TAVEditorConstants.SCENE_PLAY 等 |
listener | TAVGetFrameListener | 获取结果回调 |
void ITAVFrameProvider getFrameProvider(int longSideLength, @TAVEditorConstants.RenderScene int scene)参数名 | 类型 | 说明 |
longSideLength | int | 输出帧的长边长度，会按渲染比例缩放到长边对齐 |
scene | int（@RenderScene） | 渲染场景，参考 TAVEditorConstants.SCENE_PLAY 等 |
ITAVFrameProvider（可为 null） void generateVideo(int level, String outputPath, TAVEditorGenerateListener listener)参数名 | 类型 | 说明 |
level | int（@GenerateLevel） | 导出质量等级（360P/480P/540P/720P/1080P 等） |
outputPath | String | 导出文件路径 |
listener | 导出过程回调（进度、完成、错误等） |
void void generateVideo(TAVEditorGenerateConfig config, String outputPath, TAVEditorGenerateListener listener)参数名 | 类型 | 说明 |
config | 导出配置，如 width/height/frameRate/videoBitRate/profile 等 | |
outputPath | String | 导出文件路径 |
listener | 导出过程回调 |
void void cancelGenerate()void void flushImmediately()void void flushImmediately(@Nullable String tag, @Nullable TAVConsumer<String> callback)参数名 | 类型 | 说明 |
tag | String（可为 null） | 当前刷新操作的标记 |
callback | TAVConsumer\\<String>（可为 null） | 刷新完成后回调执行的任务，参数为 tag |
void TAVDraftManager getDraftManager()TAVDraftManager API | 描述 |
设置抽帧输入源，传入视频路径和目标抽帧尺寸的最长边；若 longSide < 16，则按视频原始分辨率抽帧。 | |
按时间间隔批量抽帧，根据给定间隔（微秒）从视频中提取连续帧，通过回调返回结果。 | |
按指定时间点列表批量抽帧，结合颗粒度（秒/帧）从 ptsList 对应位置提取帧，通过回调返回结果。 | |
获取指定时间点（微秒）的单帧图像，结合颗粒度（秒/帧）抽取对应帧，通过回调返回结果。 | |
从内存或磁盘缓存中获取指定视频、时间点、尺寸和颗粒度对应的已缓存帧，可能返回空。 | |
将某一时间点、指定尺寸与颗粒度对应的帧图像缓存到内存/磁盘，用于后续快速读取。 | |
获取当前视频的时长，单位为微秒（us）。 | |
请求停止当前正在进行的抽帧任务。 | |
释放抽帧相关资源，清理内部状态。 |
longSide 小于 MIN_LONG_SIDE 时，会按视频原始分辨率进行抽帧。 void setDataSource(String videoPath, int longSide)参数名 | 类型 | 说明 |
videoPath | String | 视频文件路径 |
longSide | int | 目标抽帧尺寸的最长边长度，若小于 MIN_LONG_SIDE 则使用原始分辨率抽帧 |
void void getFramesInterval(long intervalUs, FrameExtractingCallback callback)参数名 | 类型 | 说明 |
intervalUs | long | 抽帧时间间隔（单位：微秒） |
callback | FrameExtractingCallback | 抽帧结果回调接口 |
void ptsList，并指定一个“颗粒度（granularity）”用于控制帧间隔精度。 void getFrames(List<Long> ptsList, float granularity, FrameExtractingCallback callback)参数名 | 类型 | 说明 |
ptsList | List\\<Long> | 需要抽帧的时间点列表（单位：微秒） |
granularity | float | 颗粒度，代表多少秒一帧，用于控制抽帧间隔的精度/容差 |
callback | FrameExtractingCallback | 抽帧结果回调接口 |
void granularity 控制帧间隔精度，用于在时间附近选择合适的关键帧。 void getFrameAtTime(long pts, float granularity, FrameExtractingCallback callback)参数名 | 类型 | 说明 |
pts | long | 目标抽帧时间点（单位：微秒） |
granularity | float | 颗粒度，代表多少秒一帧，用于控制抽帧间隔的精度/容差 |
callback | FrameExtractingCallback | 抽帧结果回调接口 |
void null。 Bitmap getCacheFrame(String path, long pts, int longSide, float granularity)参数名 | 类型 | 说明 |
path | String | 视频路径，与抽帧时的输入路径保持一致 |
pts | long | 目标时间点（单位：微秒） |
longSide | int | 抽帧目标长边，与抽帧时使用的 longSide 一致 |
granularity | float | 颗粒度，与抽帧时使用的 granularity 一致 |
Bitmap null。getCacheFrame 快速复用。 void saveCacheFrame(String path, Bitmap bmp, long pts, int longSide, float granularity)参数名 | 类型 | 说明 |
path | String | 视频路径 |
bmp | Bitmap | 需要缓存的帧图像 |
pts | long | 该帧对应的时间点（单位：微秒） |
longSide | int | 抽帧目标长边尺寸 |
granularity | float | 抽帧颗粒度，用于缓存索引区分不同精度的抽帧结果 |
void long getDuration()long void requestStop()void void release()void API | 描述 |
创建一个贴纸对象，指定贴纸类型和贴纸资源路径，返回新建的 TAVSticker。 | |
加载一个贴纸并立即渲染到画面上。 | |
移除指定贴纸对象，立即生效。 | |
添加贴纸观察者，用于监听贴纸列表变化等事件。 | |
移除指定贴纸观察者。 | |
获取当前已加载的所有贴纸列表。 | |
通过贴纸 ID 获取对应的贴纸对象，不存在时返回 null。 | |
注册保底字体，当 PAG 未找到字体时优先回退到注册的字体列表，而不是系统字体，返回是否注册成功。 |
loadSticker 使用后才会显示在画面中。TAVSticker createSticker(TAVSticker.TAVStickerType type, String stickerPath)参数名 | 类型 | 说明 |
type | TAVSticker.TAVStickerType | 贴纸类型 |
stickerPath | String | 贴纸资源路径 |
TAVSticker void loadSticker(TAVSticker sticker)参数名 | 类型 | 说明 |
sticker | TAVSticker | 要加载的贴纸对象 |
void void removeSticker(TAVSticker sticker)参数名 | 类型 | 说明 |
sticker | TAVSticker | 要移除的贴纸对象 |
void void addStickerObserver(ITAVStickerContextObserver observer)参数名 | 类型 | 说明 |
observer | ITAVStickerContextObserver | 贴纸列表监听器 |
void void removeStickerObserver(ITAVStickerContextObserver observer)参数名 | 类型 | 说明 |
observer | ITAVStickerContextObserver | 要移除的监听器 |
void List<TAVSticker> getStickers()List<TAVSticker> TAVSticker getSticker(int id)参数名 | 类型 | 说明 |
id | int | 贴纸 ID |
TAVSticker null。boolean registerFallbackFont(String fontPath)参数名 | 类型 | 说明 |
fontPath | String | 字体文件路径 |
返回值 | | |
boolean true 表示注册成功，false 表示注册失败（例如路径无效或读取失败）。API | 描述 |
创建一个画中画对象，指定媒体类型和视频/图片路径，返回 TAVPip 实例。 | |
加载一个画中画并立即渲染到画面上。 | |
移除指定画中画对象，立即生效。 | |
添加画中画观察者，用于监听画中画列表变化等事件。 | |
移除指定画中画观察者。 | |
获取当前已加载的所有画中画列表。 | |
通过画中画 ID 获取对应的画中画对象，不存在时返回 null。 |
TAVPip createPip(TAVMediaType type, String mediaPath)参数名 | 类型 | 说明 |
type | TAVMediaType | 资源类型（视频 / 图片等） |
mediaPath | String | 画中画媒体资源路径（视频或图片路径） |
TAVPip createPip 创建画中画对象之后调用。 void loadPip(TAVPip pip)参数名 | 类型 | 说明 |
pip | TAVPip | 要加载的画中画对象 |
void void removePip(TAVPip pip)参数名 | 类型 | 说明 |
pip | TAVPip | 要移除的画中画对象 |
void void addPipObserver(ITAVPipContextObserver observer)参数名 | 类型 | 说明 |
observer | ITAVPipContextObserver | 画中画列表监听器 |
void addPipObserver 成对使用，避免内存泄漏。 void removePipObserver(ITAVPipContextObserver observer)参数名 | 类型 | 说明 |
observer | ITAVPipContextObserver | 要移除的监听器 |
void List<TAVPip> getPips()List<TAVPip> TAVPip getPip(int id)参数名 | 类型 | 说明 |
id | int | 画中画 ID |
TAVPip null。API | 描述 |
设置贴纸进度处理器，用于外部自定义贴纸播放进度计算，返回当前 TAVSticker 支持链式调用。 | |
计算在指定时间点的贴纸播放进度（0~1），优先使用外部注册的进度处理器，否则根据时间范围与动画模式自动计算。 | |
设置贴纸文字内容，将新的 TAVStickerTextItem 替换原有文字图层内容。 | |
获取贴纸文字内容，返回当前的 TAVStickerTextItem，若不存在则返回 null。 | |
设置贴纸图片内容，将新的 TAVStickerImageItem 替换原有图片图层内容。 | |
获取贴纸图片内容，返回当前的 TAVStickerImageItem，若不存在则返回 null。 | |
获取贴纸动画持续时长，单位为微秒（us），内部基于 PAGFile.duration()。 | |
获取贴纸对应 PAG 资源的宽度，像素单位。 | |
获取贴纸对应 PAG 资源的高度，像素单位。 | |
获取文字区域相对于整个贴纸的偏移矩形区域，仅在文字贴纸（TEXT 类型）下有效。 | |
获取图片相对于整个贴纸的偏移矩形区域，仅在图片贴纸（IMAGE 类型）下有效。 | |
获取贴纸资源文件路径（本地路径或 assets 资源路径）。 | |
设置贴纸是否自动播放， true 自动循环播放，false 不自动播放，返回当前 TAVSticker 支持链式调用。 | |
获取当前贴纸是否开启自动播放标志。 | |
获取贴纸类型，如动画贴纸、文字贴纸、图片贴纸等。 | |
设置贴纸层级，从 0 开始，数值越大层级越高，返回当前 TAVSticker 支持链式调用。 | |
获取贴纸当前的层级索引，从 0 开始，数值越大层级越高。 | |
获取贴纸动画播放模式（循环、播放到最后一帧静止、拉伸时长等）。 | |
设置贴纸动画播放模式，并同步更新内部 PAG 的 TimeStretch 模式。 | |
获取贴纸当前是否可见。 | |
设置贴纸是否可见，控制贴纸在渲染结果中的显示与否。 | |
设置贴纸的生效时间区间，并将时间范围同步到内部 PAG 图层，返回当前 TAVSticker 支持链式调用。 | |
设置贴纸在画布中的位置，支持传入 PointF 或 x/y 坐标，返回当前 TAVSticker 支持链式调用。 | |
设置贴纸整体缩放比例，返回当前 TAVSticker 支持链式调用。 | |
设置贴纸允许的最小缩放比例，返回当前 TAVSticker 支持链式调用。 | |
设置贴纸允许的最大缩放比例，返回当前 TAVSticker 支持链式调用。 | |
设置贴纸旋转角度，单位为度，返回当前 TAVSticker 支持链式调用。 | |
设置贴纸是否可编辑（是否响应手势等交互），返回当前 TAVSticker 支持链式调用。 | |
克隆当前贴纸对象， clone() 为默认浅拷贝，内部调用 clone(boolean deep)。 | |
克隆当前贴纸对象， clone(boolean deep) 可控制是否对文字、图片图层做深拷贝。 |
ITAVStickerProgressHandler。public TAVSticker setProgressHandler(ITAVStickerProgressHandler progressHandler)参数名 | 类型 | 说明 |
progressHandler | ITAVStickerProgressHandler | 自定义贴纸进度处理器回调接口 |
TAVSticker TAVSticker 实例，便于链式调用。progressHandler，则优先调用其 computeProgress，否则按照贴纸时长、时间范围及 animationMode 自动计算： FREEZE 播放至最后一帧后静止； SCALE_UP 在用户选择时长大于原始时长时以慢速播放。public double computeProgress(long presentationTimeUs)参数名 | 类型 | 说明 |
presentationTimeUs | long | 当前时间点（单位：微秒） |
double layerIndex，仅替换文字内容数据。public void setTextItem(TAVStickerTextItem textItem)参数名 | 类型 | 说明 |
textItem | TAVStickerTextItem | 文本内容对象 |
void null。public TAVStickerTextItem getTextItem()TAVStickerTextItem null。layerIndex，仅替换图片内容数据。public void setImageItem(TAVStickerImageItem imageItem)参数名 | 类型 | 说明 |
imageItem | TAVStickerImageItem | 图片内容对象 |
void null。public TAVStickerImageItem getImageItem()TAVStickerImageItem null。public long durationTime()long pagFile 为空则返回 0。public int getWidth()int pagFile 为空则返回 0。public int getHeight()int pagFile 为空则返回 0。TAVStickerType.TEXT 时有效；其他类型返回 null。 PAGPlayer 来规避可见区域为 0 的情况。public RectF getTextOffsetRect()RectF null。TAVStickerType.IMAGE 且图片有效时返回有效矩形。public RectF getImageOffsetRect()RectF null。public String getPath()String public TAVSticker setAutoPlay(boolean autoPlay)参数名 | 类型 | 说明 |
autoPlay | boolean | true 表示自动播放，false 表示不自动播放 |
TAVSticker TAVSticker 实例，便于链式调用。public boolean isAutoPlay()boolean true 表示自动播放，false 表示不自动播放。public TAVStickerType getType()TAVStickerType MOTION、TEXT、IMAGE。public TAVSticker setLayerIndex(int layerIndex)参数名 | 类型 | 说明 |
layerIndex | int | 贴纸层级索引 |
TAVSticker TAVSticker 实例，便于链式调用。public int getLayerIndex()int public TAVStickerAnimationMode getAnimationMode()TAVStickerAnimationMode DEFAULT（循环）、FREEZE（播放后静止）、SCALE_UP（慢放）。public void setAnimationMode(TAVStickerAnimationMode animationMode)参数名 | 类型 | 说明 |
animationMode | TAVStickerAnimationMode | 贴纸动画播放模式 |
void public boolean isVisible()boolean true 表示贴纸当前可见，false 表示不可见。public void setVisible(boolean visible)参数名 | 类型 | 说明 |
visible | boolean | 是否可见， true 为可见 |
void PAGFile 图层上。@Override public TAVSticker setTimeRange(TAVTimeRange timeRange)参数名 | 类型 | 说明 |
timeRange | TAVTimeRange | 贴纸在时间线上的时间范围 |
TAVSticker TAVSticker 实例，便于链式调用。@Override public TAVSticker setPosition(PointF point)参数名 | 类型 | 说明 |
point | PointF | 贴纸中心位置坐标 |
TAVSticker TAVSticker 实例，便于链式调用。@Override public TAVSticker setPosition(float x, float y)参数名 | 类型 | 说明 |
x | float | X 坐标 |
y | float | Y 坐标 |
TAVSticker TAVSticker 实例，便于链式调用。@Override public TAVSticker setScale(float scale)参数名 | 类型 | 说明 |
scale | float | 缩放比例因子 |
TAVSticker TAVSticker 实例，便于链式调用。@Override public TAVSticker setMinScale(float minScale)参数名 | 类型 | 说明 |
minScale | float | 最小缩放比例 |
TAVSticker TAVSticker 实例，便于链式调用。@Override public TAVSticker setMaxScale(float maxScale)参数名 | 类型 | 说明 |
maxScale | float | 最大缩放比例 |
TAVSticker TAVSticker 实例，便于链式调用。@Override public TAVSticker setRotate(float rotate)参数名 | 类型 | 说明 |
rotate | float | 旋转角度，单位：度 |
TAVSticker TAVSticker 实例，便于链式调用。@Override public TAVSticker setEditable(boolean editable)参数名 | 类型 | 说明 |
editable | boolean | 是否允许编辑 |
TAVSticker TAVSticker 实例，便于链式调用。TAVSticker 实例。 clone(false)，即浅拷贝文本与图片项引用。@Override public TAVSticker clone()TAVSticker PAGFile 内容。deep == false 时：textList、imageList 引用与原对象共享； deep == true 时：重新读取文本与图片图层，并逐项拷贝数据，形成独立副本。public TAVSticker clone(boolean deep)参数名 | 类型 | 说明 |
deep | boolean | 是否进行深拷贝： true 深拷贝，false 浅拷贝 |
TAVSticker API | 描述 |
获取画中画资源文件路径。 | |
获取画中画对应的媒体类型（视频或图片）。 | |
获取画中画当前音量，范围为 [0, 3]。 | |
设置画中画音量，范围为 [0, 3]。 | |
获取画中画当前播放速度。 | |
设置画中画播放速度。 | |
获取画中画在主视频时间轴上的起始时间（单位：微秒）。 | |
设置画中画在主视频时间轴上的起始时间（单位：微秒）。 | |
获取画中画原始媒体时长（单位：微秒）。 | |
获取画中画源媒体的宽度（像素）。 | |
获取画中画源媒体的高度（像素）。 | |
设置画中画在时间轴上的生效区间，返回当前 TAVPip，支持链式调用。 | |
设置画中画在画布中的位置（支持传入 PointF 或 x/y 坐标），返回当前 TAVPip，支持链式调用。 | |
设置画中画的整体缩放比例，返回当前 TAVPip，支持链式调用。 | |
设置画中画允许的最小缩放比例，返回当前 TAVPip，支持链式调用。 | |
设置画中画允许的最大缩放比例，返回当前 TAVPip，支持链式调用。 | |
设置画中画旋转角度，返回当前 TAVPip，支持链式调用。 | |
设置画中画是否可编辑（是否响应手势等交互），返回当前 TAVPip，支持链式调用。 | |
克隆当前画中画对象，生成一个具有相同路径、时间区间、变换参数等属性的新 TAVPip 实例。 |
public String getPath()String public TAVMediaType getMediaType()TAVMediaType public float getVolume()float public void setVolume(float volume)参数名 | 类型 | 说明 |
volume | float | 画中画音量，范围为 [0, 3]，1 为原始音量 |
void public float getSpeed()float public void setSpeed(float speed)参数名 | 类型 | 说明 |
speed | float | 播放速度倍数，范围建议 [0, 1] |
void public long getStartAtVideoUs()long public void setStartAtVideoUs(long startAtVideoUs)参数名 | 类型 | 说明 |
startAtVideoUs | long | 画中画在主视频中的开始时间，单位：微秒（us） |
void public long getOriginDuration()long public int getWidth()int public int getHeight()int TAVPip 以支持链式调用。public TAVPip setTimeRange(TAVTimeRange timeRange)参数名 | 类型 | 说明 |
timeRange | TAVTimeRange | 画中画在时间线中的时间范围 |
TAVPip TAVPip 实例，便于链式调用。PointF 指定。public TAVPip setPosition(PointF point)参数名 | 类型 | 说明 |
point | PointF | 画中画中心位置坐标 |
TAVPip TAVPip 实例，便于链式调用。public TAVPip setPosition(float x, float y)参数名 | 类型 | 说明 |
x | float | X 坐标 |
y | float | Y 坐标 |
TAVPip TAVPip 实例，便于链式调用。public TAVPip setScale(float scale)参数名 | 类型 | 说明 |
scale | float | 缩放比例因子 |
TAVPip TAVPip 实例，便于链式调用。public TAVPip setMinScale(float minScale)参数名 | 类型 | 说明 |
minScale | float | 最小缩放比例 |
TAVPip TAVPip 实例，便于链式调用。public TAVPip setMaxScale(float maxScale)参数名 | 类型 | 说明 |
maxScale | float | 最大缩放比例 |
TAVPip TAVPip 实例，便于链式调用。public TAVPip setRotate(float rotate)参数名 | 类型 | 说明 |
rotate | float | 旋转角度，单位：度 |
TAVPip TAVPip 实例，便于链式调用。public TAVPip setEditable(boolean editable)参数名 | 类型 | 说明 |
editable | boolean | 是否允许编辑 |
TAVPip TAVPip 实例，便于链式调用。TAVPip 实例。 public TAVPip clone()TAVPip extraInfo 为同一引用）。API | 描述 |
设置草稿保存目录路径，后续所有草稿读写都会使用该目录。 | |
读取当前草稿保存目录下的所有草稿列表，并按时间倒序排序返回。 | |
删除指定草稿对象对应的草稿文件及目录，返回是否删除成功。 | |
删除当前草稿保存目录下的所有草稿文件及目录，返回是否删除成功。 | |
保存当前编辑状态为草稿，使用给定封面图路径，返回生成的草稿路径，失败时返回 null。 | |
加载指定草稿对象，加载完成后通过 DraftLoadingCallback 回调草稿加载结果。 | |
设置草稿状态监听器，用于监听是否可撤销、可重做等草稿状态变化。 | |
重置草稿记录，从头开始记录草稿变更历史。 | |
提交一次草稿快照，如果自上次提交以来效果未发生变化，则本次提交不生效，返回是否生效。 | |
判断当前是否存在可撤销的草稿记录。 | |
判断当前是否存在可重做的草稿记录。 | |
获取当前的草稿模型实例 TAVDraft。 | |
设置草稿组件变更监听器，当草稿中的 TAVDraftComponent 发生变化时回调通知。 |
File.separator），内部会自动追加。public static void setDraftStorageDir(String storageDir)参数名 | 类型 | 说明 |
storageDir | String | 草稿保存根目录的绝对路径 |
void public static List<TAVDraft> readDraftList()List<TAVDraft> public static boolean deleteDraft(TAVDraft draft)参数名 | 类型 | 说明 |
draft | TAVDraft | 需要删除的草稿对象 |
boolean draft == null 时直接返回 false。public static boolean deleteAllDrafts()boolean public abstract String generateDraft(String thumbPath)参数名 | 类型 | 说明 |
thumbPath | String | 草稿封面图文件的路径 |
String null。public abstract void loadDraft(TAVDraft draft, DraftLoadingCallback callback)参数名 | 类型 | 说明 |
draft | TAVDraft | 需要加载的草稿对象 |
callback | 草稿加载过程与结果回调 |
void public abstract void setDraftStateListener(DraftStateListener listener)参数名 | 类型 | 说明 |
listener | 草稿状态监听器实现 |
void public abstract void resetDraftRecord()void public abstract boolean commit(String tag)参数名 | 类型 | 说明 |
tag | String | 本次提交的标记字符串 |
boolean true 表示生成了新的草稿记录，false 表示状态未变化未生成新记录。public abstract boolean canUndo()boolean true 表示当前可以执行撤销操作，false 表示无可撤销记录。public abstract boolean canRedo()boolean true 表示当前可以执行回退/重做操作，false 表示无可回退记录。DraftActionCallback 回调通知。public abstract void undo(DraftActionCallback callback)参数名 | 类型 | 说明 |
callback | 撤销动作结果回调 |
void public abstract void redo(DraftActionCallback callback)参数名 | 类型 | 说明 |
callback | 回退动作结果回调 |
void public abstract TAVDraft getCurrentDraft()TAVDraft public abstract void setDraftComponentObserver(DraftComponentObserver observer)参数名 | 类型 | 说明 |
observer | 草稿组件变更监听器实例 |
void void onUndoStateChange(boolean canUndo)参数名 | 类型 | 说明 |
canUndo | boolean | 当前是否存在可撤销的操作记录状态 |
void void onRedoStateChange(boolean canRedo)参数名 | 类型 | 说明 |
canRedo | boolean | 当前是否存在可重做的操作记录状态 |
void void onCheckoutDraft(String tag, TAVDiffResult diffResult)参数名 | 类型 | 说明 |
tag | String | 提交草稿时传入的标记（TAG），用于区分不同提交 |
diffResult | TAVDiffResult | 本次切换草稿时发生的变更结果模型 |
void void onError(int errorCode)参数名 | 类型 | 说明 |
errorCode | int | 错误码，用于标识具体错误类型 |
void loadDraft 进行草稿恢复操作结束后触发，用于通知业务侧本次草稿加载的结果状态及相关信息。 void onDraftLoadingFinished(DraftLoadingResult result)参数名 | 类型 | 说明 |
result | 草稿加载结果模型，包含本次加载是否成功及附加信息 |
void TAVDraftComponent 发生变化（新增、删除、更新等）时，都会触发该方法，用于通知业务侧进行 UI 刷新或状态同步。void onComponentUpdate(TAVDraftComponent component)参数名 | 类型 | 说明 |
component | TAVDraftComponent | 发生变化的草稿组件实例 |
void errors == null 或 errors.length == 0 时视为加载成功。public boolean isSuccess()boolean true 表示本次草稿加载无错误；false 表示加载过程中存在至少一个组件加载错误。void onGenerateStarted()void 0-1f 的浮点数形式返回，调用频率由内部导出流程控制。 void onGenerateProgress(float progress)参数名 | 类型 | 说明 |
progress | float | 导出进度，范围为 0.0-1.0 |
void TAVEditorGenerateResult 中的状态字段区分）。 void onGenerateCompleted(TAVEditorGenerateResult result)参数名 | 类型 | 说明 |
result | TAVEditorGenerateResult | 导出结果数据模型，如导出文件路径、状态码等 |
void void onGenerateCanceled()void VideoConfig 与音频配置 AudioConfig。 TAVEditor.generateVideo(TAVEditorGenerateConfig config, String outputPath, TAVEditorGenerateListener listener) 接口，实现对导出分辨率、帧率、码率、声道数等参数的精细控制。TAVEditorGenerateConfig 自定义导出配置时，通过修改该对象的字段来调整视频输出质量和时长约束。参数名 | 类型 | 说明 |
width | int | 导出视频宽度（像素），默认值为 720。 |
height | int | 导出视频高度（像素），默认值为 1280。 |
frameRate | int | 导出视频帧率（FPS），默认值为 30。 |
videoBitRate | int | 视频码率（bps，bit per second），默认值约为 720 * 1280 * 30 * 0.08，比特率因子推荐范围 0.05~0.1。 |
profile | VideoConfig.Profile | H.264 编码 Profile，默认 H264_BASE，可选：H264_BASE / H264_HIGH。 |
maxGenerateDuration | long | 最大导出时长（微秒），超过该时长的内容会被裁剪；默认值为 -1 表示不限制。 |
minGenerateDuration | long | 最小导出时长（微秒），小于该时长会报错；默认值为 -1 表示不限制。 |
参数名 | 类型 | 说明 |
channelCount | int | 声道数，默认值为 1，可选：单声道（1）、立体声（2）。 |
sampleRate | int | 采样率（Hz），默认值为 44100。 |
audioBitRate | int | 音频比特率（bps），默认值为 128000（约 128kbps）；未压缩比特率 = 采样率 × 位深 × 声道数。 |
void onPreviewProgress(long time)参数名 | 类型 | 说明 |
time | long | 当前预览时间，单位：us（微秒） |
void void onStatusChanged(@Nullable TAVEditorConstants.EditorPlayerStatus status)参数名 | 类型 | 说明 |
status | TAVEditorConstants.EditorPlayerStatus|null | 播放器当前状态；可能为 null 表示未知或未初始化 |
void TAVEditor.initWithPreview(PreviewParam param)、TAVEditor.fork(PreviewParam param)）时指定预览容器、手势层、是否自动/循环播放、渲染场景以及预览渲染尺寸等。参数名 | 类型 | 说明 |
videoView | FrameLayout | 用于承载视频预览画面的父容器 View，内部会在该容器中创建渲染 Surface 等 |
contentView | TAVWidgetContentView | 手势操作层 View，用于承载贴纸、画中画等可交互组件的触摸事件与显示 |
autoPlay | boolean | 是否在预览初始化完成后自动开始播放，默认值为 true |
loopPlay | boolean | 是否循环播放，播放到末尾后是否自动从头开始，默认值为 true |
scene | int ( @RenderScene) | 使用场景，默认 SCENE_PLAY SCENE_PLAY：预览场景 SCENE_EXPORT 导出场景 |
renderSize | Size|null | 指定渲染尺寸（宽高），若为 null 则由 SDK 根据输入素材与容器自动适配 |
常量名 | 类型 | 说明 |
SCENE_PLAY | int | 预览场景，用于编辑页面实时预览、交互渲染 |
SCENE_EXPORT | int | 导出场景，用于离屏高质量渲染与视频导出 |
TAVPreviewListener.onStatusChanged 回调通知业务方当前播放状态，以便更新 UI 和逻辑控制。枚举值 | 说明 |
IDLE | 空闲状态，尚未准备或已释放 |
READY | 已准备好，可调用播放 |
PLAYING | 正在播放 |
STOPPED | 已停止播放 |
PAUSED | 已暂停播放 |
COMPLETED | 播放到预设区间末尾触发完成回调 |
FINISHED | 播放流程结束 |
ERROR | 播放过程中发生错误 |
REPLAY | 完成后重新开始播放（循环播放触发的状态） |
TAVEditor.generateVideo(@GenerateLevel int level, ...) 中作为导出质量参数传入。常量名 | 类型 | 分辨率说明 |
VIDEO_LEVEL_480P | int | 压缩至 480P（640×480） |
VIDEO_LEVEL_540P | int | 压缩至 540P（960×540） |
VIDEO_LEVEL_720P | int | 压缩至 720P（1280×720） |
VIDEO_LEVEL_1080P | int | 压缩至 1080P（1920×1080） |
常量名 | 类型 | 说明 |
FILL_MODE_GAUSSIAN_BLUR | int | 使用高斯模糊处理背景填充 |
FILL_MODE_SOLID_COLOR | int | 使用纯色背景填充画布 |
常量名 | 类型 | 说明 |
PREVIEW_GL_THREAD | int | 预览渲染使用的 GL 线程 |
GENERATE_GL_THREAD | int | 导出渲染使用的 GL 线程 |
setTemplateDir）时的错误码常量集合。 常量名 | 类型 | 说明 |
SUCCESS | int | 设置模板目录成功 |
PATH_INVALID | int | 模板目录路径无效 |
AUTH_INVALID | int | 模板鉴权失败 |
错误码 | 错误信息 | 描述 |
-1 | BuildRenderChainManager failed | 渲染链创建异常1 |
-4 | BuildRenderChainManager failed | 渲染链创建异常2 |
-10 | "error code ${errCode}: TAVMagic export error | 导出结束过程中出现问题 |
-14 | | 导出时视频帧处理异常 |
-15 | | 导出时音频帧处理异常 |
-16 | | 导出器初始化视频解码失败 |
-17 | | 导出器初始化音频解码失败 |
-18 | | 启动编码失败 |
-19 | | 启动解码失败 |
-101 | "error code ${errCode}: TAVMagic export error | 启动视频编码失败 |
-102 | | 启动音频编码失败 |
-103 | | 视频编码信息配置失败 |
-104 | | 音频编码信息配置失败 |
-105 | Failed to create output file | 创建文件失败 |
-111 | "error code ${errCode}: TAVMagic export error | 导出渲染异常1 |
-112 | | 导出渲染异常2 |
-113 | | 导出渲染异常3 |
-121 | | 写入视频样本异常 |
-122 | | 写入音频样本异常 |
-123 | | 结束写入视频样本异常 |
-124 | | 结束写入音频样本异常 |
-131 | | 停止 muxer 异常 |
-132 | | 停止编码器异常 |
-201 | Minimum generate duration cannot exceed maximum duration | 设置的最小导出时长，大于最大导出时长 |
-202 | The total generate duration is shorter than the minimum required duration | 总时长小于最小导出时长 |
-203 | Retry software encode error. Config is null. | 软编码重试失败，配置文件为空 |
-1001 | on load asset error | 加载资源异常 |
文档反馈