Agrupe varios parámetros de procesamiento en un estilo reutilizable para simplificar el procesamiento de medios, documentos o imágenes.
Las API y los SDK de procesamiento de datos están disponibles en las regiones con Intelligent Media Management (IMM) endpoints.
Uso de estilos personalizados
Creación de un estilo
Un bucket admite hasta 50 estilos, los cuales se aplican únicamente a los archivos de ese bucket. Para solicitar más estilos, póngase en contacto con soporte técnico.
Inicie sesión en la consola de OSS.
En el panel de navegación izquierdo, haga clic en Buckets y luego haga clic en el nombre del bucket de destino.
En el panel de navegación izquierdo, seleccione Data Processing.
Según el tipo de archivo, elija IMG, Document Processing o Media Processing.
Seleccione la pestaña Style Management y luego haga clic en Create Style.
En el panel Create Style, configure el estilo.
Haga clic en OK.
Uso de un estilo
Utilice un estilo para procesar archivos mediante una URL de objeto (síncrono) o una solicitud asíncrona.
Procesamiento síncrono con una URL de objeto
Para procesar un objeto de forma síncrona, agregue el estilo a su URL: http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName. La siguiente tabla describe los parámetros.
|
Parámetro |
Descripción |
Ejemplo |
|
|
La URL del objeto. Obtain URLs for one or more files. |
|
|
|
Prefijo fijo para el procesamiento basado en estilos. |
|
|
|
El nombre del estilo personalizado. |
Simplifique la URL con un separador personalizado y un nombre de dominio personalizado:
Use el separador
!para reemplazarx-oss-process=style/.Map a custom domain name al bucket para simplificar aún más la URL.
Por ejemplo, si asigna el nombre de dominio personalizado example.com al bucket, puede usar https://example.com/example.jpg!small para procesar la imagen.
Desde el 9 de octubre de 2022 (UTC+8), la vista previa en línea está deshabilitada para los nuevos buckets que no tienen un dominio personalizado asignado. Consulte el anuncio oficial.
Procesamiento asíncrono con un estilo
Utilice x-oss-async-process=style/StyleName para procesar un archivo de forma asíncrona:
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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
// Asynchronously process the file example.avi with the StyleName style and save the output to oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQLa siguiente tabla describe los parámetros.
|
Parámetro |
Descripción |
|
|
El nombre del objeto. |
|
|
Prefijo fijo para el procesamiento basado en estilos. |
|
|
El nombre del estilo personalizado. |
Uso de estilos integrados
OSS también proporciona estilos integrados para el procesamiento de archivos.
Procesamiento asíncrono con un estilo
Utilice x-oss-async-process=style/::systemStyleName para procesar un archivo de forma asíncrona con un estilo integrado:
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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
// Asynchronously process the file example.avi with the built-in style h264-mp4-1080p and save the output to oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/::h264-mp4-1080p|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQLa siguiente tabla describe los parámetros.
|
Parámetro |
Descripción |
|
|
El nombre del objeto. |
|
|
Prefijo fijo para el procesamiento basado en estilos. |
|
|
Prefijo para un estilo integrado. |
|
|
El nombre del estilo integrado. Nota
Puede consultar todos los parámetros de estilos integrados compatibles en la página Data Processing>Media Processing. |
Importación de estilos entre buckets
Esta función solo admite estilos de IMG.
Exporte estilos desde un bucket de origen e impórtelos a un bucket de destino para reutilizar los mismos estilos de procesamiento de imágenes.
-
Exporte los estilos del bucket de origen.
En la página de administración del bucket de origen, seleccione Data Processing>IMG.
En la página IMG, haga clic en Export Style.
En el cuadro de diálogo que aparece, seleccione una ubicación para guardar el archivo de estilo y luego haga clic en Save.
-
Importe los estilos al bucket de destino.
En la página de administración del bucket de destino, seleccione Data Processing>IMG.
En la página IMG, haga clic en Import Style.
-
En el cuadro de diálogo que aparece, seleccione el archivo de estilo exportado y luego haga clic en Open.
Los estilos importados ya están disponibles para procesar archivos de imagen en el bucket de destino.