有奖捉虫:办公协同&微信生态&物联网文档专题 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 查看。