管道(|)用于串联多个数据处理任务,无需手动传递中间结果,TOS 会按照管道定义的顺序依次执行数据处理任务,提高数据处理的效率。本文介绍管道的注意事项、串联规则和使用示例。
注意事项
仅支持使用管道(|)执行两种操作:串联图片处理和图片处理,串联视频截帧和图片处理,关于图片处理和视频截帧的详细介绍,请参见图片处理概述和视频截帧。
串联规则
管道功能的分隔符是竖线(|)。您可以通过竖线(|)在文件 URL 中串联多个数据处理任务,TOS 按照文件 URL 从左到右的顺序依次执行数据处理任务。具体串联规则说明如下:
串联的任务类型 | 说明 |
---|
图片处理和图片处理 | 使用管道符号串联多个图片处理操作时,串联的第二个以及后续的图片处理操作可以携带 image/ 参数,也可以不携带 image/ 参数。
文件 URL 格式为 x-tos-process=image/<图片处理参数>|<图片处理参数>|<图片处理参数> 或 x-tos-process=image/<图片处理参数>|image/<图片处理参数>|image/<图片处理参数> 。 |
视频截帧和图片处理 | 使用管道符号串联视频截帧和图片处理时,文件 URL 需要遵循以下规则: - 第一个数据处理操作必须是视频截帧。
- 第二个数据处理操作只能是图片处理,且图片处理操作必须携带
image/ 参数。 - 第三个以及后续数据处理操作只能是图片处理,可以携带
image/ 参数,也可以不携带 image/ 参数。
文件 URL 格式为x-tos-process=image/<视频截帧参数>|image/<图片处理参数>|<图片处理参数> 或 x-tos-process=image/<视频截帧参数>|image/<图片处理参数>|image/<图片处理参数> 。 |
使用示例
- 示例一:串联图片缩放和图片水印
- 对图片进行缩放
指定图片缩放宽度为 200,高度为 200,模式为 fixed。
https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_fixed

- 串联图片缩放和图片水印
指定图片缩放宽度为 200,高度为 200,模式为 fixed,然后在图片上添加 Hello 的文字水印,文字大小设置为 72,颜色设置为红色,字体设置为方正书宋。
https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_fixed|watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw

- 示例二:串联视频截帧和图片旋转