样式

您可以在一个样式(Style)中包含多个处理参数,快速实现复杂的媒体、文档或图片处理操作。本文介绍如何创建和使用样式。

说明

新版数据处理功能API、SDK支持在IMM服务接入点中的地域进行使用。

创建样式

说明

一个存储空间(Bucket)最多可创建50个样式,这些样式仅支持作用于该Bucket下的文件。如您的业务有更多样式的需求,请联系技术支持

  1. 登录OSS管理控制台

  2. 在左侧导航栏,单击Bucket列表,然后单击目标Bucket名称。

  3. 在左侧导航栏,选择数据处理

  4. 根据您需要处理文件的类型选择图片处理文档处理媒体处理等入口。

  5. 选择样式管理页签,单击创建样式

  6. 创建样式面板,通过图形化方式配置您的样式。

  7. 单击确定

使用样式

样式创建完成后,您可以通过对象URL使用样式来处理文件。

使用对象URL进行同步处理

您可以直接将样式添加到对象访问URL上进行同步处理,格式为http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName,各参数说明如下表所示。

参数

说明

示例

http(s)://BucketName.Endpoint/ObjectName

对象的访问地址。获取方式,请参见如何获取单个或多个文件的URL?

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/small

x-oss-process=style/

固定参数,表示使用样式参数对文件进行处理。

StyleName

创建样式时设置的样式名称。

说明

您还可以设置自定义分隔符以及为Bucket绑定自定义域名,以进一步简化处理URL。例如进行如下设置:

  • 使用分隔符!代替x-oss-process=style/

  • Bucket绑定自定义域名,进一步简化处理。例如绑定自定义域名example.com后,使用https://example.com/example.jpg!small处理图片。更多信息,请参见绑定自定义域名

使用样式进行异步处理

您可以对文件进行异步处理时使用样式,示例如下。

POST /ObjectName?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************
 
 // 使用名为StyleName的样式对文件example.avi进行异步处理,处理后将得到的文件保存为oss://outbucket/outobjprefix.mp4。
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

各参数说明如下表所示。

参数

说明

/ObjectName

对象的Object名称。

x-oss-async-process=style/

固定参数,表示使用样式参数对文件进行处理。

StyleName

创建样式时设置的样式名称。

将源Bucket的样式导入目标Bucket

说明

仅支持图片处理。

您可以导出源Bucket中已创建的样式,并将样式导入到目标Bucket,便于在目标Bucket中快速应用样式来处理图片文件。

  1. 在源Bucket中导出样式。

    1. 在源Bucket管理页面,选择数据处理>图片处理

    2. 图片处理页面,单击导出样式

    3. 在弹出的对话框选择样式的保存位置,然后单击保存

  2. 在目标Bucket导入样式。

    1. 在目标Bucket管理页面,选择数据处理>图片处理

    2. 图片处理页面,单击导入样式

    3. 在弹出的对话框选择已导出的样式文件,然后单击打开

      样式导入完成后,即可在目标Bucket中使用这些样式处理图片文件。

更多参考

  • 关于如何使用处理参数处理文件,请参见同步处理

  • 关于如何将处理后的文件持久化地保存在OSS中,请参见另存为