L'aperçu vidéo permet aux utilisateurs de visionner ou d'écouter du contenu (vidéos et fichiers audio) pendant une durée limitée. Cette fonctionnalité est courante pour les services payants, tels que les cours en ligne et les mini-séries. Cette rubrique explique comment activer l'aperçu vidéo pour ApsaraVideo VOD et obtenir une URL d'aperçu.
Fonctionnement
ApsaraVideo VOD (VOD) d'Alibaba Cloud propose la fonctionnalité d'aperçu. Vous pouvez obtenir une URL d'aperçu en définissant une durée d'aperçu lors de l'appel à l'opération API côté serveur GetPlayInfo, ou en construisant manuellement une URL signée contenant les informations d'aperçu.
Si la durée d'aperçu spécifiée dépasse la durée totale de la vidéo d'origine, les utilisateurs peuvent lire l'intégralité de la vidéo via l'URL d'aperçu renvoyée par ApsaraVideo VOD.
La fonctionnalité d'aperçu vidéo d'ApsaraVideo VOD s'appuie sur Alibaba Cloud CDN. Le principe de base est le suivant : le lecteur envoie une requête contenant une URL d'aperçu (un nom de domaine accéléré par CDN) avec la durée d'aperçu spécifiée. Le service cloud authentifie l'URL d'aperçu. Si l'authentification réussit, le contenu du fichier spécifié est renvoyé. Sinon, l'accès est refusé et une erreur 403 est renvoyée. La figure suivante illustre le flux de travail de l'aperçu vidéo.

-
Configurez un nom de domaine accéléré par CDN et activez la fonctionnalité d'aperçu vidéo.
ImportantAvant d'utiliser la fonctionnalité d'aperçu, vous devez configurer un nom de domaine et activer cette fonctionnalité. Pour plus d'informations, consultez Activer la fonctionnalité d'aperçu.
Votre lecteur envoie une requête d'aperçu à ApsaraVideo VOD.
-
ApsaraVideo VOD génère une URL d'aperçu en fonction de la configuration du nom de domaine et de la durée d'aperçu spécifiée dans la requête.
RemarqueVous pouvez appeler une opération API côté serveur pour générer une URL d'aperçu ou construire une URL d'aperçu manuellement. Pour plus d'informations, consultez Appeler une opération API pour obtenir une URL d'aperçu ou Construire manuellement une URL d'aperçu.
Votre lecteur envoie une requête à CDN pour lire la vidéo d'aperçu.
Limites
La fonctionnalité d'aperçu vidéo prend en charge les formats de fichier MP4 et HLS. Pour les vidéos MP4, les métadonnées doivent se trouver dans l'en-tête du fichier. Les vidéos MP4 dont les métadonnées se trouvent à la fin du fichier ne sont pas prises en charge. Lorsque vous utilisez ApsaraVideo VOD pour transcoder une vidéo au format conteneur MP4, les métadonnées sont placées dans l'en-tête du fichier.
-
La durée d'aperçu dépend des images clés. Par défaut, une image clé est générée toutes les 10 secondes pour les fichiers de sortie transcodés par ApsaraVideo VOD. Nous vous recommandons donc de ne pas utiliser la fonctionnalité d'aperçu pour les vidéos courtes. Pour les vidéos longues, définissez la durée d'aperçu sur au moins 30 secondes.
RemarqueVous pouvez modifier l'intervalle entre les images clés dans les modèles de transcodage. Pour plus d'informations, consultez Modèles de transcodage.
Pour les fichiers HLS, la précision de l'aperçu est basée sur la durée d'un segment TS. La durée d'aperçu est arrondie au multiple supérieur le plus proche de la durée du segment TS. Par exemple, si un segment TS dure 10 secondes et que vous définissez la durée d'aperçu sur 15 secondes, un aperçu de 20 secondes est renvoyé.
Activer la fonctionnalité d'aperçu vidéo
Avant d'appeler une opération API ou de construire manuellement une URL pour obtenir une URL d'aperçu, vous devez configurer un nom de domaine et activer la fonctionnalité d'aperçu vidéo. Suivez ces étapes :
-
Configurez un nom de domaine accéléré par CDN. Pour plus d'informations, consultez Ajouter un nom de domaine accéléré.
ImportantLa fonctionnalité d'aperçu vidéo est disponible uniquement pour les noms de domaine configurés comme noms de domaine accélérés par CDN.
-
Activez la signature d'URL pour un nom de domaine et activez la fonctionnalité d'aperçu. Pour plus d'informations, consultez Signature d'URL.
ImportantSi la fonctionnalité d'aperçu vidéo est désactivée pour un nom de domaine, vous ne pouvez pas inclure de paramètres d'aperçu dans les requêtes adressées à ApsaraVideo VOD. L'URL renvoyée sera inaccessible. Par conséquent, vous devez activer le commutateur Support Previewing lorsque vous activez la signature d'URL.
La figure suivante montre l'interface de la console pour activer la fonctionnalité d'aperçu vidéo.
RemarquePour construire manuellement une URL d'aperçu, vous devez utiliser le paramètre privateKey pour calculer la valeur d'authentification. Définissez ce paramètre sur la valeur de la Primary Key ou de la Secondary Key obtenue depuis la console. Conservez la valeur de la clé pour une utilisation future.

Activez la récupération d'origine par plage (Range origin fetch) et la recherche vidéo pour le nom de domaine. Pour plus d'informations, consultez Configurer la récupération d'origine par plage et Recherche vidéo.
Appeler une opération API pour obtenir une URL d'aperçu
ApsaraVideo VOD fournit une opération API pour obtenir des URL de lecture vidéo. Pour plus d'informations sur l'opération API, consultez Obtenir des URL de lecture audio et vidéo. Vous pouvez intégrer un SDK côté serveur et l'utiliser pour appeler cette opération afin d'obtenir une URL d'aperçu. Pour obtenir l'URL d'aperçu, suivez ces étapes :
Avant d'appeler cette opération, assurez-vous que la fonctionnalité d'aperçu est activée. Pour plus d'informations, consultez Activer la fonctionnalité d'aperçu.
Intégrez le SDK côté serveur approprié. Pour plus d'informations, consultez Démarrage rapide des SDK ApsaraVideo VOD.
Appelez l'opération API Obtenir l'URL de lecture audio et vidéo à l'aide du SDK. Lors de l'appel à l'opération API, définissez le paramètre PreviewTime au sein du paramètre PlayConfig pour spécifier la durée d'aperçu. Le serveur renvoie une URL d'aperçu en fonction de la durée spécifiée. Pour plus d'informations sur le paramètre PlayConfig, consultez PlayConfig.
Construire manuellement une URL d'aperçu
Vous pouvez construire manuellement une URL signée contenant les informations d'aperçu. Suivez ces étapes :
Avant de construire une URL d'aperçu, assurez-vous que la fonctionnalité d'aperçu est activée. Pour plus d'informations, consultez Activer la fonctionnalité d'aperçu.
-
Construisez une URL signée contenant les paramètres d'aperçu. Contrairement à la construction d'une URL signée pour la lecture complète, vous devez inclure le paramètre de durée d'aperçu
previewTimedans le calcul du hachage MD5 pour la signature d'URL.Calcul du hachage MD5 pour une URL de vidéo complète
Calcul du hachage MD5 pour une URL d'aperçu
MD5(uri-timestamp-rand-uid-PrivateKey)MD5(uri-timestamp-rand-uid-PrivateKey-previewTime)RemarquePour plus d'informations sur les paramètres pour le calcul du hachage MD5 et sur la construction manuelle d'une URL signée, consultez Configurer la signature d'URL. Si vous souhaitez autoriser la lecture complète de la vidéo, n'incluez pas le paramètre previewTime.
Ajoutez
&end=à la fin de l'URL signée construite. Ensuite, ajoutez le paramètre d'aperçupreviewTimeaprès&end=pour générer l'URL d'aperçu complète.