Todos os produtos
Search

Este produto

    CDN:Configure busca de vídeo

    Central de documentação

    CDN:Configure busca de vídeo

    Última atualização: Sep 06, 2026

    A busca de vídeo é um recurso para vídeos sob demanda em que o cliente envia uma solicitação de URL ao servidor quando você avança ou retrocede para um ponto específico do vídeo. Este tópico descreve como ative a busca de vídeo.

    Nota

    Ative a busca de vídeo adiciona aproximadamente 30 ms ao tempo até o primeiro byte (TTFB). Esse atraso geralmente não é perceptível.

    Como funciona

    Com a busca de vídeo ativada, o sistema envia uma solicitação ao servidor sempre que o usuário ajusta a posição de reprodução. O CDN identifica o keyframe anterior mais próximo para carregar o segmento de vídeo solicitado e proporcionar uma experiência de reprodução contínua.

    Pré-requisitos

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

    • O recurso Ignore Parameters está desativado.

    Formatos de arquivo e parâmetros

    Por exemplo, se um cliente enviar uma solicitação de URL para um arquivo FLV como www.aliyun.com/test.flv?start=10, o servidor retornará dados a partir do keyframe anterior ao décimo byte. A tabela a seguir descreve os formatos de arquivo e de URL compatíveis com a busca de vídeo.

    Formato de arquivo

    Metadados

    Parâmetro start

    Exemplo

    MP4

    Os metadados do vídeo no servidor de origem devem estar no cabeçalho do arquivo. Vídeos com metadados no final do arquivo não são compatíveis.

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

    • Se o tempo inicial não estiver em um keyframe, o CDN buscará automaticamente o keyframe anterior.

    • Caso o tempo inicial esteja em um keyframe, o CDN buscará automaticamente esse keyframe.

    Uma solicitação de URL para domain/video.mp4?start=10 significa que a reprodução começa a partir do décimo segundo.

    FLV

    O vídeo no servidor de origem deve conter metadados.

    O parâmetro start especifique o deslocamento em bytes. Valores decimais não são compatíveis. Se você definir um valor decimal, o módulo de busca o arredondará para baixo até o inteiro mais próximo. Ao ative a opção Time-based FLV Seeking, os parâmetros start e end representarão o tempo em segundos.

    Nota

    A busca baseada em bytes é adequada para processamento preciso de dados ou fluxos de trabalho de vídeo bruto, enquanto a busca baseada em tempo oferece uma experiência mais amigável ao permitir saltos para um segundo específico.

    • Se o deslocamento inicial não estiver em um keyframe, o CDN buscará automaticamente o keyframe anterior.

    • Quando o deslocamento inicial coincidir com um keyframe, o CDN buscará automaticamente esse keyframe.

    Uma solicitação de URL para domain/video.flv?start=10 inicia a reprodução a partir do keyframe anterior ao décimo byte.

    Procedimento

    1. Faça login no CDN console.

    2. No painel de navegação à esquerda, clique em Domain Names.

    3. Na página Domain Names, localize o nome de domínio desejado e clique em Manage na coluna Actions.

    4. No painel de navegação do domínio, clique em Video.

    5. Na seção Video Seeking, ative a chave Video Seeking.

    6. (Opcional) Ative a opção Time-based FLV Seeking e configure os Custom Parameters.

    Tratamento de parâmetros de busca

    Por exemplo, ao buscar 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 dos 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 correspondente a 10 segundos.

    start inválido e end válido

    end=10

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

    start válido e end válido

    start=0&end=10

    Busca o vídeo no intervalo 0-10.

    start e end são ambos 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 correspondente a 10 segundos.

    start é igual a end

    start=10&end=10

    Tratamento de busca: tempo de processamento para o segundo 10.

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

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

    Retorna o código 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 bytes.

    start inválido e end válido

    end=10

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

    start válido e end válido

    start=0&end=10

    Processa o intervalo 0-10 via busca.

    start e end são ambos 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 byte 10.

    start é igual a end

    start=10&end=10

    Executa operações de busca para o byte 10.

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

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

    Retorna o vídeo completo.