图片处理 - 对象存储 OSS

图片处理是OSS提供的海量、安全、低成本、高可靠的图片处理服务。原始图片上传到OSS后，您可以通过简单的RESTful接口，在任何时间、任何地点、任何互联网设备上对图片进行处理。

图片处理支持的参数请参见处理参数。

使用图片处理参数处理图片

使用单个图片处理参数处理图片

let OSS = require('ali-oss');

let client = new OSS({
// 拥有目标Bucket访问权限的AccessKey。阿里云账号的AccessKey拥有所有资源的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。
  accessKeyId: 'YourAccessKeyId',
  accessKeySecret: 'YourAccessKeySecret',
// 目标Bucket名称。
  bucket: 'YourBucketName',
// 目标Bucket所在地域的Endpoint，以华东1（杭州）地域为例。
  endpoint: 'http://oss-cn-hangzhou.aliyuncs.com'
});

// 将目标图片缩放为固定宽高100 px。
async function scale () {
  try {
    let result = await client.signatureUrl('YourObjectName', {expires: 3600, process: 'image/resize,m_fixed,w_100,h_100'})
  } catch (e) {
    console.log(e);
  }
}

scale();

使用多个图片处理参数处理图片

使用多个图片处理参数处理图片时，多个参数之间以正斜线（/）分隔。

let OSS = require('ali-oss');

let client = new OSS({
// 拥有目标Bucket访问权限的AccessKey。阿里云账号的AccessKey拥有所有资源的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。
  accessKeyId: 'YourAccessKeyId',
  accessKeySecret: 'YourAccessKeySecret',
// 目标Bucket名称。
  bucket: 'YourBucketName',
// 目标Bucket所在地域的Endpoint，以华东1（杭州）地域为例。
  endpoint: 'http://oss-cn-hangzhou.aliyuncs.com'
});

// 将目标图片缩放为固定宽高100 px后，再旋转90°。
async function resize () {
  try {
    let result = await client.signatureUrl('YourObjectName', {expires: 3600, process: 'image/resize,m_fixed,w_100,h_100/rotate,90'})
  } catch (e) {
    console.log(e);
  }
}

resize();

使用图片样式处理图片

您可以将多个图片处理参数封装在一个样式中，之后使用样式批量处理图片。如何创建图片样式，请参见图片样式。

let OSS = require('ali-oss');

let client = new OSS({
// 拥有目标Bucket访问权限的AccessKey。阿里云账号的AccessKey拥有所有资源的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。
  accessKeyId: 'YourAccessKeyId',
  accessKeySecret: 'YourAccessKeySecret',
// 目标Bucket名称。
  bucket: 'YourBucketName',
// 目标Bucket所在地域的Endpoint，以华东1（杭州）地域为例。
  endpoint: 'http://oss-cn-hangzhou.aliyuncs.com'
});
// 使用指定图片样式处理目标图片。
async function style () {
  try {
    let result = await client.signatureUrl('YourObjectName', {expires: 3600, process: 'style/YourStyleName'});
  } catch (e) {
    console.log(e);
  }
}

style();

图片处理持久化

以下代码用于图片处理持久化：

let OSS = require('ali-oss');

let client = new OSS({
  // 原图所在Bucket名称。
  bucket: 'SourceBucketName',
  // 源Bucket所在地域的Endpoint，以华东1（杭州）地域为例。
  endpoint: 'http://oss-cn-hangzhou.aliyuncs.com',
  // 阿里云主账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维，请登录RAM控制台创建RAM账号。
  accessKeyId: 'YourAccessKeyId',
  accessKeySecret: 'YourAccessKeySecret',
});
// 原图名称。
let sourceImage = 'SourceObjectName';
// 处理后的图片名称。
let targetImage = 'TargetObjectName';
async function processImage(processStr, targetBucket) {
  let result = await client.processObjectSave(
    sourceImage,
    targetImage,
    processStr,
    targetBucket
  );
  console.log(result.res.status);
}

// 将原图缩放为固定宽高100 px后，存储至指定Bucket。
processImage("image/resize,m_fixed,w_100,h_100", "TargetBucketName")

生成带图片处理参数的文件签名URL

私有文件的访问URL带有签名。OSS不支持在带签名的URL后直接添加图片处理参数。如果您想要对私有文件进行图片处理，需要将图片处理参数加入到签名中，相关的代码示例如下：

let OSS = require('ali-oss');

let client = new OSS({
// 拥有目标Bucket访问权限的AccessKey。阿里云账号的AccessKey拥有所有资源的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。
  accessKeyId: 'YourAccessKeyId',
  accessKeySecret: 'YourAccessKeySecret',
// 目标Bucket名称。
  bucket: 'YourBucketName',
// 目标Bucket所在地域的Endpoint，以华东1（杭州）地域为例。
  endpoint: 'http://oss-cn-hangzhou.aliyuncs.com'
});
// 生成带图片处理参数的文件签名URL，过期时间600秒。
let signUrl = client.signatureUrl('example.jpg', {expires: 600, 'process' : 'image/resize,w_300'});
console.log("signUrl="+signUrl);

图片处理工具

您可以通过可视化图片处理工具ImageStyleViewer直观地看到OSS图片处理结果。