com.aliyun.svideo.sdk.external.thumbnail

接口 AliyunIThumbnailFetcher

public interface AliyunIThumbnailFetcher

视频缩略图获取接口

嵌套类概要

嵌套类

限定符和类型	接口和说明
static class	AliyunIThumbnailFetcher.CropMode
static interface	AliyunIThumbnailFetcher.OnThumbnailCompletion

方法概要

限定符和类型	方法和说明
int	addImageSource(java.lang.String path, long durationMills, long overlapDurationMills) 添加图片源（图片转视频时用到）
int	addVideoSource(java.lang.String path) 已过时。 请使用 addVideoSource(String, long, long, long)
int	addVideoSource(java.lang.String path, long startTimeMills, long endTimeMills, long overlapDurationMills) 添加视频源
int	fromConfigJson(java.lang.String jsonPath) 从配置文件加载视频信息（适用于SDK内操作产生的project.json）
long	getTotalDuration() 获取总时长，该接口必须在addVideoSource(String, long, long, long)之后调用
void	release() 释放资源
int	requestThumbnailImage(long[] time, AliyunIThumbnailFetcher.OnThumbnailCompletion callback) 传入时间点获取该时间点的视频缩略图，并通过回调返回结果
int	setParameters(int width, int height, AliyunIThumbnailFetcher.CropMode mode, VideoDisplayMode scaleMode, int cacheSize) 设置输出大小，该方法必须在requestThumbnailImage(long[], OnThumbnailCompletion) 前面调用，否则会抛出IllegalStateException

方法详细资料

addVideoSource

int addVideoSource(java.lang.String path,
                   long startTimeMills,
                   long endTimeMills,
                   long overlapDurationMills)

添加视频源

参数:

path - 视频路径

startTimeMills - 开始时间 单位：ms

endTimeMills - 结束时间 单位：ms

overlapDurationMills - 转场时间 单位：ms

返回:

AliyunErrorCode.OK - 成功 AliyunErrorCode.ERROR_INVALID_ARGUMENTS - 参数不合法，可能的原因：文件路径错误、无效，startTime或者endTime无效

addVideoSource

int addVideoSource(java.lang.String path)

已过时。 请使用 addVideoSource(String, long, long, long)

添加视频源

参数:

path - 视频文件地址

addImageSource

int addImageSource(java.lang.String path,
                   long durationMills,
                   long overlapDurationMills)

添加图片源（图片转视频时用到）

参数:

path - 图片文件地址

durationMills - 单位：ms

overlapDurationMills - 单位：ms

返回:

AliyunErrorCode.OK - 成功

fromConfigJson

int fromConfigJson(java.lang.String jsonPath)

从配置文件加载视频信息（适用于SDK内操作产生的project.json）

参数:

jsonPath - 配置文件地址

返回:

AliyunErrorCode.OK - 成功 AliyunErrorCode.ERROR_INVALID_ARGUMENTS - 参数不合法，可能的原因：json文件路径为空或者json文件无效/json文件中的视频或者图片路径错误、无效，startTime或者endTime无效

setParameters

int setParameters(int width,
                  int height,
                  AliyunIThumbnailFetcher.CropMode mode,
                  VideoDisplayMode scaleMode,
                  int cacheSize)

设置输出大小，该方法必须在requestThumbnailImage(long[], OnThumbnailCompletion) 前面调用，否则会抛出IllegalStateException

参数:

width - 输出图像宽度

height - 输出图像高度

mode - 图像填充方式 VideoDisplayMode

cacheSize - 缓存大小

返回:

成功返回0，失败返回ErrorCode

requestThumbnailImage

int requestThumbnailImage(long[] time,
                          AliyunIThumbnailFetcher.OnThumbnailCompletion callback)

传入时间点获取该时间点的视频缩略图，并通过回调返回结果

参数:

time - 一组时间点，单位毫秒

callback - 获取缩略图结果的回调

返回:

返回该次请求的ID

release

void release()

释放资源

getTotalDuration

long getTotalDuration()

获取总时长，该接口必须在addVideoSource(String, long, long, long)之后调用

返回:

总时长（时间单位：ms）