Agrupe vários parâmetros de processamento em um estilo reutilizável para simplificar o processamento de mídia, documentos ou imagens.
As APIs e SDKs de processamento de dados estão disponíveis em regiões com endpoints do Intelligent Media Management (IMM).
Usar estilos personalizados
Criar um estilo
Um bucket suporta até 50 estilos, que se aplicam apenas a arquivos naquele bucket. Para solicitar mais estilos, entre em contato com o suporte técnico.
-
Com base no tipo de arquivo, escolha IMG, Processamento de Documentos ou Processamento de Mídia.
-
Selecione a guia Gerenciamento de Estilos e clique em Criar Estilo.
-
No painel Criar Estilo, configure o estilo.
-
Clique em OK.
Usar um estilo
Use um estilo para processar arquivos por meio de uma URL de objeto (síncrono) ou uma solicitação assíncrona.
Processamento síncrono com URL de objeto
Para processar um objeto de forma síncrona, anexe o estilo à sua URL: http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName. A tabela a seguir descreve os parâmetros.
|
Parâmetro |
Descrição |
Exemplo |
|
|
A URL do objeto. Obtenha URLs para um ou mais arquivos. |
|
|
|
Prefixo fixo para processamento baseado em estilo. |
|
|
|
O nome do estilo personalizado. |
Simplifique a URL com um separador personalizado e um nome de domínio personalizado:
-
Use o separador
!para substituirx-oss-process=style/. -
Mapeie um nome de domínio personalizado para o bucket para simplificar ainda mais a URL.
Por exemplo, se você mapear o nome de domínio personalizado example.com para o bucket, poderá usar https://example.com/example.jpg!small para processar a imagem.
Desde 9 de outubro de 2022 (UTC+8), a visualização online está desativada para novos buckets sem um domínio personalizado mapeado. Anúncio oficial.
Processamento assíncrono com um estilo
Use x-oss-async-process=style/StyleName para processar um arquivo de forma assí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
// Processa assincronamente o arquivo example.avi com o estilo StyleName e salva a saída em oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQA tabela a seguir descreve os parâmetros.
|
Parâmetro |
Descrição |
|
|
O nome do objeto. |
|
|
Prefixo fixo para processamento baseado em estilo. |
|
|
O nome do estilo personalizado. |
Usar estilos integrados
O OSS também fornece estilos integrados para processamento de arquivos.
Processamento assíncrono com um estilo
Use x-oss-async-process=style/::systemStyleName para processar um arquivo de forma assíncrona com um 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
// Processa assincronamente o arquivo example.avi com o estilo integrado h264-mp4-1080p e salva a saída em oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/::h264-mp4-1080p|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQA tabela a seguir descreve os parâmetros.
|
Parâmetro |
Descrição |
|
|
O nome do objeto. |
|
|
Prefixo fixo para processamento baseado em estilo. |
|
|
Prefixo para um estilo integrado. |
|
|
O nome do estilo integrado. Nota
Você pode visualizar todos os parâmetros de estilo integrado compatíveis na página Processamento de Dados>Processamento de Mídia. |
Importar estilos entre buckets
Este recurso suporta apenas estilos IMG.
Exporte estilos de um bucket de origem e importe-os para um bucket de destino para reutilizar os mesmos estilos de processamento de imagem.
-
Exporte os estilos do bucket de origem.
-
Na página de gerenciamento do bucket de origem, escolha Processamento de Dados>IMG.
-
Na página IMG, clique em Exportar Estilo.
-
Na caixa de diálogo exibida, selecione um local para salvar o arquivo de estilo e clique em Salvar.
-
-
Importe os estilos para o bucket de destino.