控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

简介

本文档提供关于媒体截图接口的 API 概览以及 SDK 示例代码。

API 操作名 操作描述
GetSnapshot 查询截图 用于查询媒体文件在某个时间的截图

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 查看。

目录