有奖征文:轻量对象存储LighthouseCOS用户实践> HOT

简介

本文档提供关于媒体截图接口的 API 概览以及 SDK 示例代码。
API
操作名
操作描述
查询截图
用于查询媒体文件在某个时间的截图

SDK API 参考

SDK 所有接口的具体参数与方法说明,请参考 SDK API 参考

查询截图

功能说明

用于查询媒体文件在某个时间的截图。
注意
COS Android SDK 版本需要大于等于 v5.7.6。

示例代码

//存储桶名称,格式为 BucketName-APPID
String bucket = "examplebucket-1250000000";
//文档位于存储桶中的位置标识符,即对象键
String cosPath = "exampleobject.mp4";
// 保存在本地文件夹的路径
String localPath = "localdownloadpath";
// 截图的本地文件名
String fileName = "snapshot.jpg";
// 截帧的时间,单位 s
float time = 1;
GetSnapshotRequest getSnapshotRequest = new GetSnapshotRequest(bucket, cosPath, localPath,
fileName, time);
//截图的宽。默认为0
getSnapshotRequest.setWidth(100);
//截图的高。默认为0
getSnapshotRequest.setHeight(100);
//截图的格式,支持 jpg 和 png,默认 jpg
getSnapshotRequest.setFormat("jpg");
//图片旋转方式 auto:按视频旋转信息进行自动旋转 off:不旋转 默认值为 auto
getSnapshotRequest.setRotate("auto");
//截帧方式 keyframe:截取指定时间点之前的最近的一个关键帧 exactframe:截取指定时间点的帧 默认值为 exactframe
getSnapshotRequest.setMode("exactframe");

cosXmlService.getSnapshotAsync(getSnapshotRequest, new CosXmlResultListener() {
@Override
public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
GetSnapshotResult result = (GetSnapshotResult) cosResult;
}

@Override
public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
if (clientException != null) {
clientException.printStackTrace();
} else {
serviceException.printStackTrace();
}
}
});
说明
更多完整示例,请前往 GitHub 查看。