Tous les produits
Search

Ce produit

    CDN:Configurer la recherche vidéo

    Centre de documentation

    CDN:Configurer la recherche vidéo

    Dernière mise à jour :Sep 06, 2026

    La recherche vidéo est une fonctionnalité de vidéo à la demande. Lorsque vous naviguez vers un point précis d'une vidéo, le client envoie une requête URL au serveur. Cette rubrique explique comment activer la fonctionnalité de recherche vidéo.

    Remarque

    L'activation de la recherche vidéo ajoute environ 30 ms au temps jusqu'au premier octet (TTFB). Ce délai est généralement imperceptible.

    Fonctionnement

    Lorsque la recherche vidéo est activée, le système envoie une requête au serveur chaque fois qu'un utilisateur ajuste la position de lecture. CDN identifie l'image clé précédente la plus proche pour charger le segment vidéo demandé, ce qui offre une expérience de lecture fluide.

    Prérequis

    • Votre serveur d'origine prend en charge les requêtes HTTP Range.

    • La fonctionnalité Ignorer les paramètres est désactivée.

    Formats de fichier et paramètres

    Par exemple, si un client envoie une requête URL pour un fichier FLV tel que www.aliyun.com/test.flv?start=10, le serveur renvoie les données à partir de l'image clé précédant le 10e octet. Le tableau suivant décrit les formats de fichier pris en charge et les formats d'URL pour la recherche vidéo.

    Format de fichier

    Métadonnées

    Paramètre start

    Exemple

    MP4

    Les métadonnées de la vidéo sur le serveur d'origine doivent se trouver dans l'en-tête du fichier. Les vidéos dont les métadonnées sont situées à la fin du fichier ne sont pas prises en charge.

    Le paramètre start spécifie le temps en secondes et prend en charge jusqu'à trois décimales. Par exemple, start=1,01 indique que la lecture commence à 1,01 seconde.

    • Si l'heure de début ne correspond pas à une image clé, CDN effectue automatiquement une recherche jusqu'à l'image clé précédente.

    • Si l'heure de début correspond à une image clé, CDN effectue automatiquement une recherche jusqu'à cette image clé.

    Une requête URL pour domain/video.mp4?start=10 signifie que la lecture commence à partir de la 10e seconde.

    FLV

    La vidéo sur le serveur d'origine doit contenir des métadonnées.

    Le paramètre start spécifie le décalage en octets. Les décimales ne sont pas prises en charge. Si vous spécifiez une valeur décimale, le module de recherche l'arrondit à l'entier inférieur le plus proche. Si vous activez Time-based FLV Seeking, les paramètres start et end représentent le temps en secondes.

    Remarque

    La recherche basée sur les octets convient au traitement précis des données ou aux workflows vidéo bruts, tandis que la recherche basée sur le temps offre une expérience conviviale en permettant des sauts vers une seconde spécifique.

    • Si le décalage de début ne correspond pas à une image clé, CDN effectue automatiquement une recherche jusqu'à l'image clé précédente.

    • Si le décalage de début correspond à une image clé, CDN effectue automatiquement une recherche jusqu'à cette image clé.

    Une requête URL pour domain/video.flv?start=10 démarre la lecture à partir de l'image clé précédant le 10e octet.

    Procédure

    1. Connectez-vous à la console CDN.

    2. Dans le volet de navigation de gauche, cliquez sur Domain Names.

    3. Sur la page Domain Names, localisez le nom de domaine cible et cliquez sur Manage dans la colonne Actions.

    4. Dans le volet de navigation du domaine, cliquez sur Video.

    5. Dans la section Video Seeking, activez l'interrupteur Video Seeking.

    6. (Facultatif) Activez Time-based FLV Seeking et configurez les Custom Parameters.

    Gestion des paramètres de glisser-déposer

    Par exemple, lors d'une recherche par temps, les paramètres de recherche vidéo par défaut sont start et end. Les tableaux suivants décrivent la logique de traitement des valeurs de paramètres dans différents scénarios :

    Requêtes de fichiers MP4

    Valeur start/end

    Exemple

    Traitement du glisser-déposer

    start invalide et end invalide

    start=foo&end=bar

    Ignore les paramètres de recherche vidéo et répond avec la vidéo complète.

    start valide et end invalide

    start=10

    Traitement du glisser-déposer pour les fichiers 10.

    start invalide et end valide

    end=10

    Traite la recherche vidéo de 0-10.

    start valide et end valide

    start=0&end=10

    Traite la recherche vidéo de 0-10.

    start et end sont tous deux égaux à 0

    start=0&end=0

    Ignore les paramètres de recherche vidéo et répond avec la vidéo complète.

    start est supérieur à end

    start=10&end=0

    Traitement du glisser-déposer pour les fichiers 10.

    start est égal à end

    start=10&end=10

    Traitement du glisser-déposer : durée de traitement des fichiers 10.

    start est supérieur à la durée de la vidéo

    start est supérieur à la durée de la vidéo

    Renvoie 400.

    Requêtes de fichiers FLV

    Valeur start/end

    Exemple

    Logique de traitement du glisser-déposer

    start invalide et end invalide

    start=foo&end=bar

    Ignore les paramètres de recherche vidéo et répond avec la vidéo complète.

    start valide et end invalide

    start=10

    Traitement du glisser-déposer : durée pour les fichiers 10.

    start invalide et end valide

    end=10

    Traite la recherche vidéo de 0-10.

    start valide et end valide

    start=0&end=10

    Vous pouvez traiter la plage 0-10 par glisser-déposer.

    start et end sont tous deux égaux à 0

    start=0&end=0

    Ignore les paramètres de recherche vidéo et répond avec la vidéo complète.

    start est supérieur à end

    start=10&end=0

    Vous pouvez faire glisser et déposer un fichier d'une longueur de 10 pour le traiter.

    start est égal à end

    start=10&end=10

    Gère les opérations de glisser-déposer pour les fichiers 10.

    start est supérieur à la durée de la vidéo

    start est supérieur à la durée de la vidéo

    Renvoie la vidéo complète.