Todos os produtos
Search
Central de documentação

:Video processing

Última atualização: Jun 29, 2026

Em cenários de streaming de áudio e vídeo sob demanda, o recurso de processamento de vídeo do ESA identifica o keyframe anterior mais próximo da posição de reprodução para carregar o trecho desejado pelo usuário, garantindo uma experiência contínua.

Antes de começar

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

  • A string de consulta 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 no site desejado.

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

  3. Clique na aba Rules. Clique em Content Optimization e insira um Video Processing .

  4. Em Create Rule, defina as condições de correspondência para as solicitações recebidas. Para saber mais sobre expressões de regra, consulte Composição de uma expressão de regra.

  5. Na seção Rule Name, clique em If requests match..., ative a chave Video Seeking e configure os parâmetros.

    image

    A lista a seguir descreve os formatos de arquivo compatíveis com busca de vídeo e exemplos de URLs:

    Arquivos MP4

    • Metadados: Os metadados do arquivo de vídeo no servidor de origem devem constar no cabeçalho do arquivo, não no final.

    • Parâmetro: O parâmetro start especifica o tempo em segundos, com valor arredondável para até três casas decimais. Por exemplo, start=1.01 indica reprodução a partir do segundo 1,01.

      • Se a posição especificada pelo parâmetro start não for um keyframe, o ESA localiza automaticamente o último keyframe anterior à posição indicada.

      • Caso a posição definida no parâmetro start não corresponda a um keyframe, o ESA encontra automaticamente o keyframe apropriado.

    • Parâmetros personalizados para MP4:

      • O valor padrão do parâmetro start é start; o do parâmetro end é end.

      • Valores de parâmetros personalizados aceitam apenas letras, dígitos e sublinhados (_).

    • Exemplo:

      domain/video.mp4?start=10: indica que a reprodução começa no décimo segundo.

    Arquivos FLV

    • Metadados: Os arquivos de vídeo no servidor de origem devem conter metadados.

    • Parâmetro: O parâmetro start especifica a posição e aceita apenas valores em bytes. Números decimais não são suportados; o valor é arredondado para baixo até o inteiro positivo mais próximo.

      • Configure

        • Status: A unidade dos parâmetros start e end é segundos. Este método navega até a imagem do vídeo no ponto temporal especificado, proporcionando uma experiência mais amigável ao usuário.

        • FLV Seeking: Recomendado para processamento preciso de dados ou manipulação de dados brutos de vídeo.

          • Quando a posição indicada pelo parâmetro start não for um keyframe, o ESA localiza automaticamente o último keyframe anterior a essa posição.

          • Se a posição definida pelo parâmetro start não corresponder a um keyframe, o ESA identifica automaticamente o keyframe correto.

    • Parâmetros personalizados de busca de vídeo:

      • O valor padrão do parâmetro start é start; o do parâmetro end é end.

      • Valores de parâmetros personalizados aceitam apenas letras, dígitos e sublinhados (_).

    • Exemplo:

      domain/video.flv?start=10: indica que a reprodução começa no décimo byte.

Lógica de processamento dos parâmetros de busca de vídeo

O exemplo abaixo utiliza a busca por tempo com os parâmetros start e end padrão. As tabelas a seguir descrevem a lógica de processamento dos valores dos parâmetros em diferentes cenários:

Solicitações para arquivo MP4

Valores de start/end

Exemplo

Lógica de processamento

Valores inválidos para os parâmetros start e end

start=foo&end=bar

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

Valor válido para o parâmetro start e valor inválido para o parâmetro end

start=10

Busca o vídeo de 10 até o final do arquivo.

Valor inválido para o parâmetro start e valor válido para o parâmetro end

end=10

Busca o vídeo no intervalo 0-10.

Valores válidos para os parâmetros start e end

start=0&end=10

Busca o vídeo no intervalo 0-10.

Ambos os parâmetros start e end definidos como 0

start=0&end=0

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

O valor do parâmetro start é maior que o valor do parâmetro end

start=10&end=0

Busca o vídeo de 10 até o final do arquivo.

O valor do parâmetro start é igual ao valor do parâmetro end

start=10&end=10

Busca o vídeo a partir de 10 até o final do arquivo.

O valor do parâmetro start excede a duração do vídeo

O valor do parâmetro start excede a duração do vídeo

Retorna uma resposta com código de status HTTP 400.

Solicitações para arquivo FLV

Valores de start/end

Exemplo

Lógica de processamento

Valores inválidos para os parâmetros start e end

start=foo&end=bar

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

Valor válido para o parâmetro start e valor inválido para o parâmetro end

start=10

Busca o vídeo de 10 até o final do arquivo.

Valor inválido para o parâmetro start e valor válido para o parâmetro end

end=10

Busca o vídeo no intervalo 0-10.

Valores válidos para os parâmetros start e end

start=0&end=10

Busca o vídeo no intervalo 0-10.

Ambos os parâmetros start e end definidos como 0

start=0&end=0

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

O valor do parâmetro start é maior que o valor do parâmetro end

start=10&end=0

Busca o vídeo de 10 até o final do arquivo.

O valor do parâmetro start é igual ao valor do parâmetro end

start=10&end=10

Busca o vídeo a partir de 10 até o final do arquivo.

O valor do parâmetro start excede a duração do vídeo

O valor do parâmetro start excede a duração do vídeo

Retorna o vídeo completo.

Documentação relacionada

Os recursos relacionados a regras variam em prioridade efetiva, reentrância e granularidade de aplicação. Para mais detalhes, consulte Propriedades de recursos relacionados a regras.