java sdk for picture service of tencentyun.
支持2.0版本的图片restful api。内部实现了高度封装,对开发者透明。
增加视频分片上传功能,较大视频可使用分片上传。
稳定版本,支持微视频的基本api。 包括视频的上传、下载、查询和删除。
稳定版本,支持图片云的基本api。 包括图片的上传、下载、复制、查询和删除。
初始非稳定版本,仅支持上传。后续将会继续完善。
1. 在腾讯云 申请业务的授权
授权包括:
APP_ID
SECRET_ID
SECRET_KEY
2.0版本的云服务在使用前,还需要先创建空间。在使用2.0 api时,需要使用空间名(Bucket)。
如果要使用图片,需要创建图片操作类对象
//v1版本
PicCloud pc = new PicCloud(APP_ID, SECRET_ID, SECRET_KEY);
//v2版本
PicCloud pc = new PicCloud(APP_ID, SECRET_ID, SECRET_KEY, Bucket);
如果要使用视频,需要创建视频操作类对象
VideoCloud vc = new VideoCloud(APP_ID, SECRET_ID, SECRET_KEY);
在创建完对象后,根据实际需求,调用对应的操作方法就可以了。sdk提供的方法包括:签名计算、上传、复制、查询、下载和删除等。
String version = pc.GetVersion();
如果需要上传图片,根据不同的需求,可以选择不同的上传方法
//UploadResult是上传的返回结果
UploadResult result = new UploadResult();
//最简单的上传接口,提供userid和图片路径即可
int ret = Upload(userid, fileName, result);
//可以自定义fileid的上传接口
int ret = Upload(userid, fileName, fileid, result);
如果需要上传视频
//直接上传
int ret = vc.Upload(userid, video,"test_title","test_Desc","test_magic_context", result);
//视频分片上传
ret = vc.SliceUpload(userid, video,"test_title","test_Desc","test_magic_context", result);
UploadResult result = new UploadResult();
int ret = pc.Copy(userid, fileid, result);
//图片查询
PicInfo picInfo = new PicInfo();
int ret = pc.Stat(userid, fileid, picInfo);
//视频查询
VideoInfo videoInfo = new VideoInfo();
ret = vc.Stat(userid, fileid, videoInfo);
ret = pc.Delete(userid, fileid);
下载图片直接利用图片的下载url即可,开发者可以自行处理,这里提供的是本地下载的方法。 如果开启了防盗链,还需要在下载url后面追加签名,如果要自行处理,请参考腾讯云的wiki页,熟悉鉴权签名的算法。
//不开启防盗链
//ret = pc.Download(userid, result.fileid, "./download.jpg");
//开启防盗链
ret = pc.DownloadEx(userid, result.fileid, "./download.jpg");
//直接提供url下载
//ret = pc.Download(result.download_url, "./download.jpg");