Todos os produtos
Search
Central de documentação

:Video processing

Última atualização: Sep 14, 2026

Em cenários de streaming de vídeo e áudio sob demanda, o recurso de processamento de vídeo do ESA oferece uma experiência de reprodução contínua. O sistema identifica o keyframe anterior mais próximo da posição de reprodução solicitada e carrega o segmento de vídeo correspondente.

Pré-requisitos

  • O servidor de origem deve suportar solicitações HTTP Range.

  • A configuração query string deve estar definida como Retain All.

Adicionar uma regra de processamento de vídeo

  1. No console do ESA, selecione Websites e, na coluna Websites, clique em o site desejado.

  2. No painel de navegação à esquerda, escolha Websites > Website.

  3. Selecione a aba Video Processing, clique em Rules e insira um Content Optimization.

  4. Na área Create Rule, defina as condições para corresponder às solicitações do usuário. Para obter mais informações sobre como configurar regras, consulte Composition of rule expressions.

  5. Na área Video Seeking, clique em Configure, ative a chave Status e configure os parâmetros.

    image

    Por exemplo, se uma solicitação de URL para um arquivo FLV for www.aliyun.com/test.flv?start=10, o servidor retornará dados a partir do keyframe que precede o 10º byte. A tabela a seguir descreve os formatos de arquivo e de URL compatíveis com o recurso de busca de vídeo.

    Formato de arquivo

    Metainformações

    Parâmetros

    Exemplo

    MP4

    As metainformações do vídeo de source devem estar no cabeçalho do arquivo. Vídeos com metainformações no final do arquivo não são suportados.

    O parâmetro start especifica o tempo em segundos, com suporte a até três casas decimais. Por exemplo, start=1,01 indica que a reprodução começa em 1,01 segundos.

    • Se o tempo especificado por start não for um keyframe, o ESA localiza automaticamente o keyframe anterior.

    • Caso o tempo especificado por start seja um keyframe, o ESA localiza automaticamente o keyframe atual.

    Observações sobre Custom MP4 Parameters:

    1. O parâmetro start é start por padrão, e o parâmetro end é end por padrão.

    2. Os parâmetros personalizados podem conter apenas letras maiúsculas, letras minúsculas, dígitos e sublinhados (_). Exemplos: 123, aabbAABB e aa_BB123.

    Uma solicitação de URL como domain/video.mp4?start=10 indica que a reprodução do vídeo começa no décimo segundo.

    FLV

    O vídeo de source deve conter metainformações.

    O parâmetro start especifica o byte. Valores decimais não são suportados. Embora seja possível especificar um decimal no parâmetro, o módulo de busca de vídeo o arredonda para baixo, resultando em um número inteiro positivo.

    FLV Seeking By Time: A unidade dos parâmetros start e end é segundos.

    Seeking By Byte: A busca por byte é adequada para processamento preciso de dados ou para manipulação de dados brutos de vídeo. Já a busca por segundo proporciona uma experiência mais amigável ao usuário, saltando diretamente para o segundo solicitado.

    • Se o tempo especificado por start não for um keyframe, o ESA localiza automaticamente o keyframe anterior.

    • Caso o tempo especificado por start seja um keyframe, o ESA localiza automaticamente o keyframe atual.

    Notes On Custom Parameters For Video Seeking:

    1. O parâmetro start é start por padrão, e o parâmetro end é end por padrão.

    2. Os parâmetros personalizados podem conter apenas letras maiúsculas, letras minúsculas, dígitos e sublinhados (_). Exemplos: 123, aabbAABB e aa_BB123.

    Uma solicitação de URL como domain/video.flv?start=10 indica que a reprodução do vídeo começa a partir do keyframe anterior ao 10º byte.

Tratamento de parâmetros de busca

Por exemplo, na busca por tempo, os parâmetros padrão de busca de vídeo são start e end. As tabelas a seguir descrevem a lógica de processamento dos valores desses parâmetros em diferentes cenários:

Solicitações de arquivo MP4

Valor de start/end

Exemplo

Tratamento de Busca

start inválido e end inválido

start=foo&end=bar

Ignora os parâmetros de busca de vídeo e responde com o vídeo completo.

start válido e end inválido

start=10

Processa a busca no tempo 10.

start inválido e end válido

end=10

Executa a busca de vídeo no intervalo 0-10.

start válido e end válido

start=0&end=10

Realiza a busca de vídeo no intervalo 0-10.

start e end iguais a 0

start=0&end=0

Ignora os parâmetros de busca de vídeo e responde com o vídeo completo.

start maior que end

start=10&end=0

Processa a busca no tempo 10.

start igual a end

start=10&end=10

Tratamento de busca: processamento no ponto 10.

start maior que a duração do vídeo

start maior que a duração do vídeo

Retorna 400.

Solicitações de arquivo FLV

Valor de start/end

Exemplo

Lógica de tratamento de busca

start inválido e end inválido

start=foo&end=bar

Ignora os parâmetros de busca de vídeo e responde com o vídeo completo.

start válido e end inválido

start=10

Tratamento de busca: duração correspondente a 10.

start inválido e end válido

end=10

Executa a busca de vídeo no intervalo 0-10.

start válido e end válido

start=0&end=10

Permite processar o intervalo 0-10 via busca.

start e end iguais a 0

start=0&end=0

Ignora os parâmetros de busca de vídeo e responde com o vídeo completo.

start maior que end

start=10&end=0

Processa a busca a partir do ponto 10.

start igual a end

start=10&end=10

Trata operações de busca para o ponto 10.

start maior que a duração do vídeo

start maior que a duração do vídeo

Retorna o vídeo completo.

Documentação relacionada

Os recursos relacionados a regras variam quanto à prioridade efetiva, reentrância e granularidade de aplicação. Para mais detalhes, consulte Characteristics of rule-based features.