Todos los productos
Search
Centro de documentos

CDN:Configurar la búsqueda en video

Última actualización: Sep 06, 2026

La búsqueda en video es una función para video bajo demanda. Cuando usted avanza a un punto específico del video, el cliente envía una solicitud de URL al servidor. En este tema se describe cómo habilitar la función de búsqueda en video.

Nota

Habilitar la búsqueda en video agrega aproximadamente 30 ms al tiempo hasta el primer byte (TTFB). Por lo general, este retraso no se percibe.

Cómo funciona

Cuando la búsqueda en video está habilitada, se envía una solicitud al servidor cada vez que un usuario ajusta la posición de reproducción. CDN identifica el fotograma clave anterior más cercano para cargar el segmento de video solicitado. Esto proporciona una experiencia de reproducción fluida.

Requisitos previos

  • Su servidor de origen admite solicitudes HTTP Range.

  • La función Ignore Parameters está deshabilitada.

Formatos de archivo y parámetros

Por ejemplo, si un cliente envía una solicitud de URL para un archivo FLV como www.aliyun.com/test.flv?start=10, el servidor devuelve datos que comienzan desde el fotograma clave anterior al décimo byte. A continuación se describen los formatos de archivo y de URL compatibles con la búsqueda en video.

Formato de archivo

Metadatos

Parámetro start

Ejemplo

MP4

Los metadatos del video en el servidor de origen deben ubicarse en el encabezado del archivo. No se admiten videos con metadatos al final del archivo.

El parámetro start especifica el tiempo en segundos y admite hasta tres decimales. Por ejemplo, start=1.01 indica que la reproducción comienza en 1.01 segundos.

  • Si el tiempo de inicio no coincide con un fotograma clave, CDN busca automáticamente el fotograma clave anterior.

  • Si el tiempo de inicio coincide con un fotograma clave, CDN busca automáticamente ese fotograma clave.

Una solicitud de URL para domain/video.mp4?start=10 significa que la reproducción comienza desde el segundo 10.

FLV

El video en el servidor de origen debe contener metadatos.

El parámetro start especifica el desplazamiento en bytes. No se admiten decimales. Si usted especifica un valor decimal, el módulo de búsqueda lo redondea hacia abajo al entero más cercano. Si habilita Time-based FLV Seeking, los parámetros start y end representan el tiempo en segundos.

Nota

La búsqueda basada en bytes es adecuada para el procesamiento preciso de datos o flujos de trabajo de video sin procesar. Por su parte, la búsqueda basada en tiempo ofrece una experiencia más sencilla, ya que permite saltar a un segundo específico.

  • Si el desplazamiento inicial no coincide con un fotograma clave, CDN busca automáticamente el fotograma clave anterior.

  • Si el desplazamiento inicial coincide con un fotograma clave, CDN busca automáticamente ese fotograma clave.

Una solicitud de URL para domain/video.flv?start=10 inicia la reproducción desde el fotograma clave anterior al décimo byte.

Procedimiento

  1. Inicie sesión en la consola de CDN.

  2. En el panel de navegación izquierdo, haga clic en Domain Names.

  3. En la página Domain Names, busque el nombre de dominio deseado y haga clic en Manage en la columna Actions.

  4. En el panel de navegación del dominio, haga clic en Video.

  5. En la sección Video Seeking, active el interruptor Video Seeking.

  6. (Opcional) Active Time-based FLV Seeking y configure Custom Parameters.

Procesamiento de parámetros de arrastrar y soltar

Por ejemplo, cuando se realiza una búsqueda por tiempo, los parámetros predeterminados de búsqueda en video son start y end. Las siguientes tablas describen la lógica de procesamiento de los valores de los parámetros en distintos escenarios:

Solicitudes de archivos MP4

Valor de start/end

Ejemplo

Procesamiento de arrastrar y soltar

start no válido y end no válido

start=foo&end=bar

Ignora los parámetros de búsqueda en video y responde con el video completo.

start válido y end no válido

start=10

Tiempo de procesamiento de arrastrar y soltar para archivos 10.

start no válido y end válido

end=10

Procesa la búsqueda en video de 0-10.

start válido y end válido

start=0&end=10

Procesa la búsqueda en video de 0-10.

start y end son ambos 0

start=0&end=0

Ignora los parámetros de búsqueda en video y responde con el video completo.

start es mayor que end

start=10&end=0

Tiempo de procesamiento de arrastrar y soltar para archivos 10.

start es igual a end

start=10&end=10

Procesamiento de arrastrar y soltar: tiempo de procesamiento de archivos 10.

start es mayor que la duración del video

start es mayor que la duración del video

Devuelve 400.

Solicitudes de archivos FLV

Valor de start/end

Ejemplo

Lógica de procesamiento de arrastrar y soltar

start no válido y end no válido

start=foo&end=bar

Ignora los parámetros de búsqueda en video y responde con el video completo.

start válido y end no válido

start=10

Procesamiento de arrastrar y soltar: duración para archivos 10.

start no válido y end válido

end=10

Procesa la búsqueda en video de 0-10.

start válido y end válido

start=0&end=10

Puede procesar el rango 0-10 mediante arrastrar y soltar.

start y end son ambos 0

start=0&end=0

Ignora los parámetros de búsqueda en video y responde con el video completo.

start es mayor que end

start=10&end=0

Puede arrastrar y soltar un archivo con una longitud de 10 para procesarlo.

start es igual a end

start=10&end=10

Gestiona las operaciones de arrastrar y soltar para archivos 10.

start es mayor que la duración del video

start es mayor que la duración del video

Devuelve el video completo.