简介
本文档提供关于图像智能裁剪的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
腾讯云数据万象通过 AIImageCrop 接口对图像进行智能裁剪,支持持久化、云上处理及下载时处理 |
SDK API 参考
图像智能裁剪
功能说明
腾讯云数据万象通过 AIImageCrop 接口对图像进行智能裁剪,支持持久化、云上处理及下载时处理。
注意:
COS Android SDK 版本需要大于等于 v5.9.32。
示例代码
// 存储桶名称,格式为 BucketName-APPIDString bucket = "examplebucket-1250000000";AIImageCropRequest request = new AIImageCropRequest(bucket);request.objectKey = "folder/document.jpg";request.detectUrl = "http://www.example.com/abc.jpg";// 设置您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey detect-url 示例:http://www.example.com/abc.jpgrequest.width = 10;// 设置需要裁剪区域的宽度,与height共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片宽度的像素值request.height = 6;// 设置需要裁剪区域的高度,与width共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片高度的像素值;width : height建议取值在[1, 2.5]之间,超过这个范围可能会影响效果request.fixed = 0;// 设置是否严格按照 width 和 height 的值进行输出。取值为0时,宽高比例(width : height)会简化为最简分数,即如果width输入10、height输入20,会简化为1:2;取值为1时,输出图片的宽度等于width,高度等于height;默认值为0request.ignoreError = 1;// 设置当此参数为1时,针对文件过大等导致处理失败的场景,会直接返回原图而不报错// 设置结果文件保存路径request.saveLocalPath = "保存到本地的路径";cosXmlService.aiImageCropAsync(request, new CosXmlResultListener() {@Overridepublic void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {// result 图像智能裁剪的结果// 详细字段请查看api文档或者SDK源码GetObjectResult result = (GetObjectResult) cosResult;}@Overridepublic void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {if (clientException != null) {clientException.printStackTrace();} else {serviceException.printStackTrace();}}});
说明: