Tous les produits
Search
Centre de documentation

CDN:Audio and video preview

Dernière mise à jour :Aug 18, 2026

L'aperçu audio et vidéo permet aux nœuds de périphérie du CDN de renvoyer une portion limitée dans le temps d'un fichier audio ou vidéo au lieu du fichier complet. Cette fonctionnalité est utilisée dans les services de vidéo à la demande (VOD) pour offrir un essai gratuit aux utilisateurs non abonnés avant qu'ils ne souscrivent.

Formats pris en charge

Format Prise en charge Notes
TS Pris en charge Configurez à l'aide de cette fonctionnalité
MP3 Pris en charge Configurez à l'aide de cette fonctionnalité
FLV Non pris en charge Utilisez la fonctionnalité video seeking avec le paramètre end à la place
MP4 Non pris en charge Utilisez la fonctionnalité video seeking avec le paramètre end à la place
HLS Non pris en charge nativement Soumettez un ticket pour demander la configuration

Fonctionnement

Lorsqu'un client envoie une requête contenant un paramètre de durée d'aperçu, le nœud de périphérie du CDN ne renvoie que la portion spécifiée du fichier. Par exemple :

http://example.com/sample.ts?free_time=15

Cette opération renvoie les 15 premières secondes du fichier sample.ts. Le nom et la valeur du paramètre que vous configurez dans la console doivent correspondre exactement à ceux envoyés par votre client dans l'URL de la requête.

Comportement des paramètres :

Scénario Comportement
Nom du paramètre défini, aucune valeur par défaut configurée Le nœud de périphérie renvoie la durée spécifiée dans chaque requête entrante
Le client demande une durée supérieure à la longueur totale de l'aperçu La longueur totale de l'aperçu s'applique. Pour éviter un aperçu plus court que prévu, demandez une durée légèrement supérieure à la cible — par exemple, demandez 15 secondes pour obtenir un aperçu de 13 secondes de contenu

Activer l'aperçu audio et vidéo

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 Audio/video Preview, activez l'option Audio/video Preview et configurez le paramètre Custom Preview Parameter. Définissez Custom Preview Parameter sur le nom du paramètre de requête utilisé par votre client. La valeur correspond à la durée de l'aperçu en secondes. Par exemple, si vous définissez Custom Preview Parameter sur free_time et qu'un client envoie free_time=15, le nœud de périphérie renvoie 15 secondes du fichier demandé.

    Enable audio and video preview

  6. Cliquez sur OK.

Étapes suivantes

Pour configurer l'aperçu des fichiers FLV ou MP4, consultez la rubrique Configure video seeking.

Référence API

BatchSetCdnDomainConfig