Vidéo dans Dynamic Media

Cette section décrit l’utilisation de vidéos dans Dynamic Media.

Démarrage rapide : vidéos

Le workflow décrit en détail ci-après vise à vous aider à maîtriser rapidement les opérations liées aux visionneuses de vidéos adaptatives dans Dynamic Media. Chaque étape comporte des renvois à des rubriques contenant de plus amples informations.

IMPORTANT

Avant d’utiliser la vidéo dans Dynamic Media, assurez-vous que votre équipe d’administration Adobe Experience Manager a déjà activé et configuré les services cloud Dynamic Media en mode Scene7 ou hybride.

Problème de lecture vidéo actuellement connu dans Dynamic Media sur Experience Manager 6.5.9.0 uniquement :

  • Si une vidéo publiée est mise à jour, elle doit être publiée à nouveau pour refléter les modifications apportées à la diffusion.
  1. Chargez les vidéos Dynamic Media en procédant comme suit :

  2. Gérez les vidéos Dynamic Media en effectuant les opérations suivantes :

  3. Pour publier les vidéos Dynamic Media, effectuez l’une des opérations suivantes :

Utilisation de vidéo dans Dynamic Media

La vidéo dans Dynamic Media est une solution complète qui facilite la publication de vidéos adaptatives haute qualité pour la diffusion sur plusieurs écrans, notamment les postes de travail et les appareils mobiles iOS, Android™, BlackBerry® et Windows. Une visionneuse de vidéos adaptative regroupe les versions d’une même vidéo codées dans des débits et des formats différents, par exemple 400 kbit/s, 800 kbit/s et 1 000 kbit/s. L’ordinateur de bureau ou l’appareil mobile détecte la bande passante disponible.

Par exemple, sur un appareil mobile iOS, il détecte une bande passante telle que 3G, 4G ou une connexion Wi-Fi, puis sélectionne automatiquement la vidéo codée selon le débit correspondant parmi ceux disponibles dans la visionneuse de vidéos adaptative. La vidéo est diffusée en continu sur les postes de travail, les appareils mobiles ou les tablettes.

En outre, la qualité de la vidéo est automatiquement adaptée en temps réel selon les conditions réseau sur le poste de travail ou l’appareil mobile. En outre, si un client passe en mode Plein écran sur un bureau, la visionneuse de vidéos adaptative répond en utilisant une meilleure résolution, améliorant ainsi l’expérience de visionnage du client. L’utilisation des visionneuses de vidéos adaptatives offre une lecture optimale aux clients qui lisent des vidéos Dynamic Media sur plusieurs écrans et appareils.

La logique appliquée par un lecteur vidéo pour déterminer quelles sont les vidéos encodées à lire ou à sélectionner au cours de la lecture repose sur l’algorithme suivant :

  1. Le lecteur vidéo charge le fragment vidéo initial basé sur le débit le plus proche de la valeur définie pour le « débit initial » dans le lecteur lui-même.

  2. Le lecteur vidéo est adapté en fonction des modifications de la vitesse de bande passante d’après les critères suivants :

    1. Le lecteur sélectionne le flux de bande passante le plus élevé qui est inférieur ou égal à la bande passante estimée.
    2. Le lecteur prend uniquement en compte 80 % de la bande passante disponible. Cependant, s’il change, il est préférable que ce taux soit seulement de 70 % pour éviter toute surestimation et que le lecteur ne repasse au taux précédent.

Pour obtenir des informations techniques détaillées sur l’algorithme, consultez la page https://android.googlesource.com/platform/frameworks/av/+/master/media/libstagefright/httplive/LiveSession.cpp

Pour la gestion des visionneuses de vidéos adaptative et unique, les fonctions suivantes sont prises en charge :

  • Chargement de vidéos dans de nombreux formats vidéo et audio pris en charge et codage vidéo au format MP4 H.264 pour lecture sur plusieurs écrans. Vous pouvez utiliser les paramètres prédéfinis de vidéo adaptative ou de codage unique ou personnaliser le codage pour contrôler la qualité et la taille de la vidéo.

    • Lorsqu’une visionneuse de vidéos adaptative est générée, elle comprend des vidéos MP4.
    • Remarque : Les vidéos originales/sources ne sont pas ajoutées à la visionneuse de vidéos adaptative.
  • Sous-titrage des vidéos dans toutes les visionneuses de vidéo HTML5.

  • Organiser, parcourir et effectuer des recherches dans la vidéo avec une prise en charge complète des métadonnées pour une gestion efficace des ressources vidéo.

  • Proposer des visionneuses de vidéos adaptatives en ligne ainsi que sur des postes de travail et des appareils mobiles (iPhone, iPad, Android™, BlackBerry® et Windows Phone notamment).

La diffusion de vidéo adaptative en continu est prise en charge sur différentes plateformes iOS. Voir Guide de référence des visionneuses de médias dynamiques.

Dynamic Media prend en charge la lecture vidéo pour mobiles au format vidéo MP4 H.264. Les appareils BlackBerry® qui prennent en charge ce format vidéo sont répertoriés dans la liste : Formats vidéo pris en charge sur BlackBerry®.

Les terminaux Windows qui prennent en charge ce format vidéo sont répertoriés dans la liste : Médias pris en charge sur Windows Phone 8

  • Lecture de la vidéo à l’aide des paramètres prédéfinis de la visionneuse Dynamic Media Video, tels que :

    • des visionneuses de vidéos uniques ;
    • des visionneuses de médias mixtes combinant du contenu vidéo et des images.
  • Configurer des lecteurs vidéo pour répondre à vos besoins de stratégie de marque.

  • Intégrer la vidéo à votre site web, site mobile ou application mobile grâce à une simple URL ou à du code intégré.

Consultez également la section Visionneuses pour Experience Manager Assets et Dynamic Media Classic et Visionneuses pour Experience Manager Assets uniquement.

Bonne pratique : utilisation de la visionneuse de vidéos HTML5

Les paramètres prédéfinis de la visionneuse de vidéos Dynamic Media HTML5 sont des lecteurs vidéo fiables. Vous pouvez les utiliser pour éviter de nombreux problèmes courants liés à la lecture vidéo HTML5. De plus, des problèmes liés aux appareils mobiles, tels que l’absence de diffusion en continu à débit adaptatif et une portée limitée du navigateur de bureau.

Du côté de la conception du lecteur, vous pouvez concevoir la fonctionnalité du lecteur vidéo à l’aide d’outils de développement web standard. Vous pouvez, par exemple, concevoir les boutons, les commandes et les affiches personnalisées en arrière-plan au moyen du code HTML5 et CSS afin de mieux cibler les utilisateurs avec un aspect personnalisé.

Du côté lecture de la visionneuse, elle détecte automatiquement les fonctionnalités vidéo du navigateur. Il diffuse ensuite la vidéo à l’aide de HLS (HTTP Live Streaming) ou DASH (Dynamic Adaptive Streaming over HTTP) , également appelé diffusion en continu à débit adaptatif. Si ces méthodes de distribution n’existent pas, la diffusion progressive HTML5 est utilisée à la place.

En combinant dans un seul lecteur, vous avez accès aux les éléments suivants :

  • La possibilité de concevoir des composants de lecture à l’aide de HTML5 et CSS
  • Disposer de lecteurs incorporés
  • Utiliser la diffusion en continu adaptative et progressive selon les fonctionnalités du navigateur

Vous pouvez étendre la portée de votre contenu multimédia aux utilisateurs d’ordinateurs de bureau et d’appareils mobiles et garantir ainsi une expérience vidéo fluide.

Consultez également la section A propos des visionneuses HTML5.

Lecture vidéo sur les ordinateurs de bureau et les appareils mobiles à l’aide de la visionneuse de vidéos HTML5

Pour la diffusion en flux continu de la vidéo adaptative sur un poste de travail et un appareil mobile, les vidéos utilisées pour le changement de débit reposent sur toutes les vidéos MP4 dans la visionneuse de vidéos adaptative.

La lecture vidéo se produit à l’aide de DASH ou HLS, ou du téléchargement vidéo progressif. Dans les versions antérieures d’Experience Manager, telles que 6.0, 6.1 et 6.2, les vidéos étaient diffusées via HTTP.

Dans Experience Manager 6.3 et versions ultérieures, les vidéos sont désormais diffusées en continu via HTTPS (c’est-à-dire, DASH ou HLS), car l’URL du service de passerelle DM utilise toujours HTTPS également. Il n’y a aucun impact pour le client dans ce comportement par défaut. En d’autres termes, la diffusion vidéo en continu s’effectue toujours par HTTPS, sauf si elle n’est pas prise en charge par le navigateur. (voir le tableau ci-dessous). Par conséquent,

  • Si vous avez un site web HTTPS avec une diffusion vidéo en continu via HTTPS, la diffusion en continu est de qualité.
  • Si vous avez un site web HTTP avec une diffusion vidéo en flux continu via HTTPS, la diffusion en continu est de qualité et il n’y a aucun problème de contenu mixte du navigateur web.

DASH est la norme internationale et HLS est une norme Apple. Les deux sont utilisés pour la diffusion en continu de vidéo adaptative. De plus, les deux technologies ajustent automatiquement la lecture en fonction de la capacité de bande passante du réseau. Elle permet aussi au client ou à la cliente de « rechercher » n’importe quel point de la vidéo sans avoir à attendre que le reste de la vidéo soit téléchargé.

La vidéo progressive est diffusée en téléchargeant et en stockant la vidéo localement sur le système de bureau ou l’appareil mobile d’un utilisateur.

Le tableau ci-dessous décrit l’appareil, le navigateur et la méthode de lecture des vidéos sur les ordinateurs de bureau et les appareils mobiles à l’aide de la visionneuse de vidéos Dynamic Media.

Appareil Navigateur Mode lecture vidéo
Poste de travail Internet Explorer 9 et 10 Téléchargement progressif.
Poste de travail Internet Explorer 11+ Sous Windows 8 et Windows 10 - Forcer l’utilisation de HTTPS chaque fois que DASH* ou HLS est demandé. Limites connues : HTTP sur DASH* ou HLS ne fonctionne pas dans cette combinaison navigateur/système d’exploitation

Sous Windows 7 - Téléchargement progressif. Utilise la logique standard pour sélectionner le protocole HTTP ou HTTPS.
Poste de travail Firefox 23 à 44 Téléchargement progressif.
Poste de travail Firefox 45 ou version ultérieure Diffusion en continu à débit adaptatif DASH* ou HLS.
Poste de travail Chrome Diffusion en continu à débit adaptatif DASH* ou HLS.
Poste de travail Safari (Mac) HLS diffusion en continu à débit adaptatif.
Mobile Chrome (Android™ 6 ou version antérieure) Téléchargement progressif.
Mobile Chrome (Android™ 7 ou version ultérieure) Diffusion en continu à débit adaptatif DASH* ou HLS.
Mobile Android™ (navigateur par défaut) Téléchargement progressif.
Mobile Safari (iOS) HLS diffusion en continu à débit adaptatif.
Mobile Chrome (iOS) HLS diffusion en continu à débit adaptatif.
Mobile BlackBerry® Diffusion en continu à débit adaptatif DASH* ou HLS./td>
IMPORTANT

*Pour utiliser le DASH pour vos vidéos, il doit d’abord être activé par le support technique d’Adobe sur votre compte. Voir Activation de DASH sur votre compte.)

Architecture de la solution vidéo Dynamic Media

Le graphique suivant montre le workflow global de création de vidéos qui sont chargées et codées par le biais de DMGateway (dans le mode Hybride Dynamic Media) et mises à disposition pour une consommation publique.

chlimage_1-427

Architecture de publication hybride des vidéos

chlimage_1-428

Bonnes pratiques en matière de codage de vidéos

Le processus Vidéo d’encodage Dynamic Media encode la vidéo si vous avez activé Dynamic Media et configuré les services cloud vidéo. Ce workflow capture l’historique de traitement des workflows et les informations d’échec. Voir Surveillance du codage vidéo et de la progression de la publication sur YouTube. Si vous avez activé Dynamic Media et configuré les services cloud vidéo, le workflow Vidéo d’encodage Dynamic Media prend automatiquement effet lorsque vous chargez une vidéo. (Si vous n’utilisez pas Dynamic Media, le workflow Ressource de mise à jour DAM prend effet.)

Fichiers vidéo source

Lorsque vous codez un fichier vidéo, utilisez un fichier vidéo source ayant la plus haute qualité possible. Évitez d’utiliser des fichiers vidéo précédemment codés, car ces fichiers sont déjà compressés, et un codage supplémentaire crée une vidéo de qualité inférieure.

  • Dynamic Media prend principalement en charge les vidéos de forme courte avec une durée maximale de 30 minutes et une résolution minimale supérieure à 25 x 25.
  • Vous pouvez charger des fichiers vidéo de source principale d’une taille de 15 Go chacun au maximum.

Le tableau ci-dessous décrit la taille recommandée, le format et le débit minimal requis pour vos fichiers vidéo sources au moment de leur codage :

Taille Format Débit minimal
1024 x 768 4:3 4 500 Kbit/s pour la plupart des vidéos.
1280 x 720 16:9 3 000 à 6 000 Kbit/s, selon la quantité de mouvement dans la vidéo.
1 920 x 1 080 16:9 6 000 à 8 000 kbit/s en fonction de la quantité de mouvement sur la vidéo.

Obtention des métadonnées d’un fichier

Vous pouvez obtenir les métadonnées d’un fichier en les affichant à l’aide d’un outil de modification vidéo ou d’une application conçue pour obtenir les métadonnées. Vous trouverez ci-dessous des instructions sur l’utilisation de MediaInfo, une application tierce, pour obtenir les métadonnées d’un fichier vidéo :

  1. Accédez à Téléchargement MediaInfo.
  2. Sélectionnez et téléchargez le programme d’installation pour la version avec l’interface graphique utilisateur, puis suivez les instructions d’installation.
  3. Après l’installation, cliquez avec le bouton droit sur le fichier vidéo (Windows uniquement) et sélectionnez MediaInfo, ou bien ouvrez MediaInfo et faites glisser votre fichier vidéo dans l’application. Toutes les métadonnées de votre fichier vidéo, telles que sa largeur, sa hauteur et le nombre d’images par seconde, sont alors visibles à l’écran.

Format

Lorsque vous choisissez ou créez un paramètre prédéfini de codage vidéo pour votre fichier vidéo issu de sources originales, assurez-vous que le paramètre prédéfini indique le même format que le fichier vidéo issu de sources originales. Le format fait référence au rapport largeur/hauteur de la vidéo.

Pour déterminer les proportions d’un fichier vidéo, obtenez les métadonnées du fichier et notez la largeur et la hauteur du fichier (voir Obtention des métadonnées d’un fichier ci-dessus). Utilisez ensuite cette formule pour déterminer le format :

largeur/hauteur = format

Ce tableau décrit la façon dont les résultats de la formule se traduisent en choix de formats :

Résultat de la formule Format
1.33 4:3
0,75 3:4
1,78 16:9
0.56 9:16

Par exemple, une vidéo qui a une largeur de 1440 pour une hauteur de 1080 a un format de 1440/1080, soit 1,33. Dans ce cas, vous choisissez un paramètre prédéfini de codage vidéo avec un format de 4:3 pour le codage du fichier vidéo.

Débit binaire

Le débit correspond à la quantité de données encodées pour produire une seule seconde de lecture vidéo. Le débit de données est mesuré en kilobits par seconde (kbit/s).

REMARQUE

Du fait que tous les codecs utilisent la compression avec perte, le débit de données est le facteur le plus important de la qualité vidéo. Quand vous utilisez la compression avec perte, plus vous compressez la vidéo, plus la qualité de l’image se dégrade. Toutes les autres caractéristiques étant égales (résolution, taux de rafraîchissement et codec), plus le débit de données est faible, moins la qualité du fichier compressé est bonne.

Lorsque vous sélectionnez l’encodage du débit, vous avez le choix entre deux types :

  • Encodage à débit constant (CBR) : pendant l’encodage CBR, le débit ou le nombre de bits par seconde est conservé pendant tout le processus d’encodage. L’encodage CBR maintient le débit défini selon votre configuration sur l’intégralité de la vidéo. En outre, le codage CBR n’optimise pas la qualité des fichiers multimédias, mais économise de l’espace de stockage.
    Utilisez le codage CBR si votre vidéo présente globalement un niveau de mouvement similaire. Le codage CBR est le plus souvent utilisé pour diffuser le contenu vidéo en continu. Voir également Utilisation de paramètres de codage vidéo personnalisés.

  • Codage à débit variable (VBR) : l’encodage VBR ajuste le débit de données vers le bas et la limite supérieure que vous définissez, en fonction des données requises par le compresseur. Cette fonctionnalité implique que lors d’un processus de codage VBR, le débit du fichier multimédia augmente ou diminue de manière dynamique en fonction des besoins du débit de fichiers multimédias.
    Le VBR prend plus de temps au codage, mais garantit de meilleurs résultats, avec une qualité de fichier multimédia supérieure. Le codage VBR est couramment utilisé pour la diffusion http progressive de contenu vidéo.

Dans quels cas utilisez-vous le VBR ou le CBR ?
Lorsque vous devez choisir entre VBR et CBR, il est presque toujours recommandé d’utiliser le VBR pour vos fichiers multimédias. Le VBR vous garantit des fichiers de meilleure qualité à des débits compétitifs. Lorsque vous utilisez le VBR, assurez-vous d’utiliser le codage à deux passages, et définissez le débit maximal afin qu’il soit 1,5 fois supérieur au débit vidéo cible.

Lorsque vous choisissez un paramètre prédéfini de codage vidéo, pensez à la vitesse de connexion de l’utilisateur final cible. Choisissez un paramètre prédéfini avec un débit de données correspondant à 80 % de cette vitesse. Par exemple, si la vitesse de connexion de l’utilisateur final est de 1 000 Kbit/s, le meilleur paramètre prédéfini est celui avec un débit de données vidéo de 800 Kbit/s.

Ce tableau décrit le débit de données associé à des vitesses de connexion courantes.

Vitesse (kbit/s) Type de connexion
256 Connexion d’accès à distance.
800 Connexion mobile standard. Pour cette connexion, visez un débit de données de 400 à 800 kbit/s pour les expériences 3G.
2000 Connexion haut débit standard de bureau. Pour cette connexion, visez un débit de données de 800 à 2 000 kbit/s, bien qu’un débit de 1 200 à 1 500 kbit/s convienne à la plupart des cibles.
5000 Connexion haut débit standard. Il est déconseillé de coder dans cette plage supérieure, car la diffusion de la vidéo à cette vitesse n’est pas possible pour la plupart des consommateurs.

Résolution

Résolution décrit la hauteur et la largeur d’un fichier vidéo, en pixels. La plupart des vidéos sources sont stockées à une résolution élevée (par exemple, 1 920 x 1 080). Pour la diffusion en continu, la vidéo source est compressée à une résolution inférieure (640 x 480 ou moins).

La résolution et le débit de données sont deux facteurs étroitement liés qui déterminent la qualité de la vidéo. Pour maintenir la même qualité vidéo, plus le nombre de pixels (c’est-à-dire la résolution) est élevé dans un fichier vidéo, plus le débit de données doit l’être également. Par exemple, considérez le nombre de pixels par image dans un fichier vidéo d’une résolution de 320 x 240 pixels et dans un fichier vidéo d’une résolution de 640 x 480 pixels :

Résolution Pixels par image
320 x 240 76 800
640 x 480 307 200

Le fichier de 640 x 480 possède quatre fois plus de pixels par image. Pour atteindre le même débit de données avec ces deux résolutions, vous appliquez une compression de 4 au fichier d’une résolution de 640 x 480 pixels, ce qui peut réduire la qualité de la vidéo. Par conséquent, un débit de données vidéo de 250 kbit/s produit un affichage de haute qualité à une résolution de 320 x 240 pixels, mais pas à une résolution de 640 x 480 pixels.

En général, plus le débit de données que vous utilisez est élevé, plus la qualité de votre vidéo est bonne, et plus vous utilisez une résolution élevée, plus de débit de données dont vous avez besoin est élevé pour conserver la qualité de visionnage (en comparaison avec des résolutions plus basses).

Du fait que la résolution et le débit de données sont liés, vous avez le choix entre deux options lors du codage vidéo :

  • Choisir un débit de données puis, en fonction de ce paramètre, coder à la résolution la plus haute pour obtenir une vidéo de bonne qualité.
  • Choisir une résolution, puis coder au débit de données nécessaire pour que la qualité vidéo soit optimale à la résolution choisie.

Lorsque vous choisissez (ou créez) un paramètre prédéfini de codage vidéo pour votre fichier vidéo source original, utilisez ce tableau pour choisir la résolution cible appropriée :

Résolution Hauteur (pixels) Taille d’écran
240p 240 Écran de très petite taille
300p 300 Petit écran équipant généralement les appareils mobiles
360p 360 Petit écran
480p 480 Écran de taille moyenne
720p 720 Grand écran
1 080p 1080 Grand écran haute définition

Images par seconde

Aux États-Unis et au Japon, la plupart des vidéos sont tournées à 29,97 ips (images par seconde) ; en Europe, la plupart des vidéos le sont à 25 ips. Un film est tourné à 24 ips.

Choisissez un paramètre prédéfini de codage vidéo correspondant au nombre d’images par seconde de votre vidéo issue de sources originales. Par exemple, si le débit est de 25 ips pour la vidéo issue de sources originales, choisissez un paramètre prédéfini de 25 ips pour le codage. Par défaut, tous les codages personnalisés utilisent le nombre d’images par seconde du fichier vidéo source Principal. C’est pourquoi il est inutile d’indiquer le nombre d’images par seconde lorsque vous créez un paramètre prédéfini de codage vidéo.

Dimensions du codage vidéo

Pour obtenir des résultats optimaux, sélectionnez les dimensions de codage de façon à ce que la vidéo source corresponde à un multiple entier de toutes vos vidéos codées.

Pour ce faire, il suffit de diviser la largeur de la source par la largeur codée pour obtenir le rapport de largeur, puis de diviser la hauteur de la source par la hauteur codée pour obtenir le rapport de hauteur.

Si le résultat est un nombre entier, cela signifie que la mise à l’échelle de la vidéo est parfaite. Si le résultat n’est pas un nombre entier, la qualité vidéo s’en ressentira en raison de la présence d’artefacts vidéo (pixels résiduels). Cet effet est plus visible lorsque la vidéo contient du texte.

Supposons, par exemple, que la résolution de votre vidéo source soit équivalente à 1920 x 1080 pixels. Dans le tableau ci-après, les trois vidéos codées indiquent les paramètres de codage optimaux à appliquer.

Type de vidéo Largeur x hauteur Rapport de largeur Rapport de hauteur
Source 1 920 x 1 080 1 1
Codée 960 x 540 2 2
Codée 640 x 360 3 3
Codée 480 x 270 4 4

Format de fichier vidéo codé

Dynamic Media recommande d’utiliser les paramètres prédéfinis MP4 H.264 de codage vidéo. Comme les fichiers MP4 utilisent le codec vidéo H.264, la vidéo est de haute qualité mais dans un fichier au volume compressé.

Activation de DASH sur votre compte

DASH (Digital Adaptive Streaming over HTTP) est la norme internationale pour la diffusion en continu de vidéos, largement adoptée par les différentes visionneuses de vidéos. Lorsque l’option DASH est activée sur votre compte, vous avez la possibilité de choisir entre DASH ou HLS pour la diffusion en continu de vidéo adaptative. Vous pouvez également opter pour les deux cas de changement automatique entre les lecteurs lorsque auto est sélectionné comme type de lecture dans le paramètre prédéfini de la visionneuse.

Voici quelques avantages clés de l’activation du DASH sur votre compte :

  • Regroupez la vidéo de flux DASH pour la diffusion en continu à débit adaptatif. Cette méthode permet d'accroître l'efficacité de la diffusion. La diffusion en continu adaptative garantit la meilleure expérience d’affichage à vos clients.

  • La diffusion en continu optimisée par le navigateur avec les lecteurs Dynamic Media bascule entre la diffusion en continu HLS et DASH pour garantir la meilleure qualité de service. Le lecteur vidéo passe automatiquement à HLS lorsqu’un navigateur Safari est utilisé.

  • Vous pouvez configurer votre méthode de diffusion en continu préférée (HLS ou DASH) en modifiant le paramètre prédéfini de la visionneuse de vidéos.

  • Le codage vidéo optimisé garantit qu’aucun stockage supplémentaire n’est utilisé lors de l’activation de la fonctionnalité DASH. Un seul ensemble de codes vidéo est créé pour HLS et DASH afin d’optimiser les coûts de stockage vidéo.

  • Permet à vos clients de rendre la diffusion vidéo plus accessible.

  • Vous pouvez également obtenir l’URL de diffusion en continu au moyen des API.

    IMPORTANT

    L’activation de DASH sur votre compte est actuellement disponible uniquement en Amérique du Nord.

L’activation du DASH sur votre compte nécessite deux étapes :

  • Configuration de Dynamic Media pour utiliser DASH, ce que vous pouvez facilement faire vous-même.
  • Configuration de Experience Manager 6.5 pour l’utilisation du DASH via un cas du service clientèle d’Adobe que vous créez et envoyez.

Pour activer DASH sur votre compte :

  1. Configuration de Dynamic Media - Dans Dynamic Media sur Experience Manager 6.5, accédez à https://localhost:4502/system/console/configMgr.

  2. Rechercher Diffusion en continu avancée des vidéos AEM Assets Dynamic Media indicateur de fonctionnalité.

  3. Cochez la case pour activer DASH.

  4. Sélectionnez Enregistrer.

  5. Configuration de Experience Manager 6.5 - Utilisez le Admin Console pour commencer la création d’un nouveau cas d’assistance..

  6. Suivez les instructions pour créer un cas d’assistance tout en vous assurant de fournir les informations suivantes :

    • nom, adresse électronique et numéro de téléphone du contact principal.
    • Nom de votre compte Dynamic Media.
    • Indiquez que DASH doit être activé sur Experience Manager 6.5.
  7. Le service clientèle d’Adobe vous ajoute à la liste d’attente des clients de DASH en fonction de l’ordre dans lequel les demandes sont envoyées.

  8. Lorsque Adobe est prêt à traiter votre demande, le service clientèle vous contacte pour coordonner et définir une date cible pour l’activation DASH.

  9. Une fois la procédure achevée, vous en serez informé par l’équipe du service clientèle.

  10. Créez votre paramètre prédéfini de visionneuse vidéo comme d'habitude.

Publication de vidéos sur YouTube

Vous pouvez publier des ressources vidéo Experience Manager on-premise directement sur une chaîne YouTube que vous avez précédemment créée.

Pour publier des ressources vidéo sur YouTube, configurez Experience Manager Assets avec des balises. Vous associez ces balises à une chaîne YouTube. Si la balise d’une ressource vidéo correspond à la balise d’une chaîne YouTube, la vidéo est publiée sur YouTube. La publication sur YouTube se produit avec une publication normale de la vidéo à condition qu’une balise associée soit utilisée.

YouTube procède à son propre codage. Ainsi, le fichier vidéo d’origine qui a été chargé dans Experience Manager est publié sur YouTube au lieu de tout rendu vidéo créé par le codage Dynamic Media. Même s’il n’est pas nécessaire de traiter les vidéos à l’aide de Dynamic Media, il est supposé qu’elles le sont si un paramètre prédéfini de visionneuse est nécessaire pour la lecture.

Lorsque vous ignorez le profil de traitement vidéo et que vous effectuez directement la publication sur YouTube, votre ressource vidéo ne dispose pas de miniature visible dans Experience Manager Assets. Cela signifie également que si vous utilisez le mode d’exécution dynamicmedia ou dynamicmedia_scene7, les vidéos non codées ne fonctionnent avec aucun des types de ressources Dynamic Media.

Pour garantir une authentification serveur à serveur sécurisée avec YouTube, la publication des vidéos sur les serveurs YouTube implique les tâches suivantes :

  1. Configuration des paramètres de Google Cloud
  2. Création d’une chaîne YouTube
  3. Ajout de balises pour la publication
  4. Activation de l’agent de réplication de publication YouTube
  5. Configuration de YouTube dans Experience Manager
  6. (Facultatif) Automatisation de la définition des propriétés YouTube par défaut pour vos vidéos chargées
  7. Publication de vidéos sur votre chaîne YouTube
  8. (Facultatif) Vérification de la vidéo publiée sur YouTube
  9. Liaison d’URL YouTube à votre application web

Vous pouvez également dépublier des vidéos pour les supprimer de YouTube.

Configuration des paramètres de Google Cloud

Pour effectuer une publication sur YouTube, vous avez besoin d’un compte Google. Si vous disposez d’un compte GMAIL, alors vous disposez déjà d’un compte Google ; si vous ne disposez pas d’un compte Google, vous pouvez facilement en créer un. Un compte est nécessaire, car vous avez besoin des informations d’identification pour publier des ressources vidéo sur YouTube. Si vous avez déjà créé un compte, ignorez cette tâche et passez directement à Création d’une chaîne YouTube.

Il n’est pas nécessaire que le compte utilisé avec Google Cloud et le compte Google utilisé pour YouTube soient les mêmes.

Google modifie régulièrement son interface utilisateur. De ce fait, les étapes de publication des vidéos sur YouTube peuvent varier légèrement des étapes présentées ci-dessous. Cet avertissement s’applique également à YouTube lorsque vous tentez de vérifier si des vidéos y sont téléchargées.

REMARQUE

Les étapes suivantes étaient exactes au moment de leur rédaction. Toutefois, Google met à jour régulièrement ses sites web sans préavis. Par conséquent, ces étapes peuvent être légèrement différentes.

Pour configurer les paramètres de Google Cloud, procédez comme suit :

  1. Créez un compte Google.
    https://accounts.google.com/SignUp?service=mail

    Si vous disposez déjà d’un compte Google, passez à l’étape suivante.

  2. Accédez à https://cloud.google.com/.

  3. Dans la page Google Cloud, près du coin supérieur droit, cliquez sur Console.

    Vous devrez peut-être vous connecter à l’aide des informations d’identification de votre compte Google pour voir l’option Console.

  4. Sur la page Tableau de bord, à droite de Google Cloud Platform, cliquez sur la liste déroulante Projet pour ouvrir la boîte de dialogue Sélectionner un projet.

  5. Dans la boîte de dialogue Sélectionner un projet, appuyez sur Nouveau projet.

    6_5_googleaccount-newproject

  6. Dans la boîte de dialogue Nouveau projet, saisissez le nom de votre nouveau projet dans le champ Nom du projet.

    Votre ID de projet est basé sur le nom du projet. Par conséquent, choisissez soigneusement le nom du projet ; il ne peut pas être modifié une fois créé. Vous devez également le saisir lors de la configuration ultérieure de YouTube dans Experience Manager ; vous pouvez le noter pour vous en rappeler.

  7. Cliquez sur Créer.

  8. Effectuez l’une des opérations suivantes :

    • Dans le tableau de bord de votre projet, dans la carte Prise en main , appuyez sur Exploration et activation des API.
    • Dans le tableau de bord de votre projet, dans la carte API, appuyez sur Accéder à l’aperçu des API.

    6_5_googleaccount-apis-enable2

  9. En haut de la page API & services, appuyez sur Activer les API et les services.

  10. Sur la page Bibliothèque d’API, dans la partie gauche, sous Catégorie, appuyez sur YouTube. Sur le côté droit de la page, appuyez sur YouTube Data API.

  11. Sur la page YouTube Data API v3, appuyez sur Activer.

    6_5_googleaccount-apis-enable3

  12. Pour utiliser l’API, vous avez besoin d’identifiants. Si besoin, cliquez sur Créer des identifiants.

    6_5_googleaccount-apis-createcredentials

  13. Sur la page Ajouter des identifiants au projet, à l’étape 1, procédez comme suit :

    • Dans la liste déroulante Quelle API utilisez-vous ?, sélectionnez YouTube Data API v3.

    • Depuis la liste déroulante Quelle plate-forme utilisez-vous pour appeler l’API ?, sélectionnez Serveur web (par exemple, node.js, Tomcat).

    • Dans la liste déroulante À quelles données accédez-vous ?, appuyez sur Données utilisateur.

    6_5_googleaccount-apis-createcredentials2

  14. Appuyez sur De quels identifiants ai-je besoin ?

  15. Sur la page Ajouter des identifiants au projet, à l’étape 2, sous l’en-tête Créer un ID client OAuth 2.0, dans le champ Nom, saisissez un nom unique si vous le souhaitez. Vous pouvez également utiliser le nom par défaut spécifié par Google.

  16. Dans le champ de texte sous l’en-tête Origines JavaScript autorisées, saisissez le chemin suivant, en substituant vos propres domaine et numéro de port dans le chemin, puis appuyez sur Entrée pour ajouter le chemin à la liste :

    https://<servername.domain>:<port_number>

    Par exemple, https://1a2b3c.mycompany.com:4321

    Remarque : l’exemple de chemin ci-dessus est fourni uniquement à titre illustratif.

    6_5_googleaccount-apis-createcredentials-oauth

  17. Dans le champ de texte sous l’en-tête URI de redirection autorisés, saisissez le chemin suivant, en substituant vos propres domaine et numéro de port dans le chemin, puis appuyez sur Entrée pour ajouter le chemin à la liste :

    https://<servername.domain>:<port_number>/etc/cloudservices/youtube.youtubecredentialcallback.json

    Par exemple, https://1a2b3c.mycompany.com:4321/etc/cloudservices/youtube.youtubecredentialcallback.json

    Remarque : l’exemple de chemin ci-dessus est fourni uniquement à titre illustratif.

  18. Cliquez sur Créer un ID client OAuth.

  19. Sur la page Ajouter des identifiants au projet, à l’étape 3, sous l’en-tête Configuration de l’écran d’autorisation OAuth 2.0, sélectionnez l’adresse e-mail Gmail que vous utilisez actuellement.

    6_5_googleaccount-apis-createcredentials-consentscreen

  20. Sous l’en-tête Nom du produit affiché à l’intention des utilisateurs, dans le champ de texte, entrez ce qui doit s’afficher sur l’écran d’autorisation.

    L’écran du consentement s’affiche pour l’administrateur Experience Manager lorsque celui-ci s’identifie sur YouTube ; Experience Manager contacte YouTube pour lui demander l’autorisation.

  21. Cliquez sur Continuer.

  22. Sur la page Ajouter des identifiants au projet, à l’étape 4, sous l’en-tête Télécharger les identifiants, appuyez sur Télécharger.

    6_5_googleaccount-apis-createcredentials-downloadcredentials

  23. Enregistrez le fichier client_id.json.

    Vous en avez besoin lors de la configuration ultérieure de YouTube dans Adobe Experience Manager.

  24. Cliquez sur Terminé.

    Déconnectez-vous de votre compte Google. Créez maintenant une chaîne YouTube.

Création d’une chaîne YouTube

Pour publier des vidéos sur YouTube, vous devez disposer d’une ou de plusieurs chaînes. Si vous avez déjà créé une chaîne YouTube, vous pouvez ignorer cette étape et passer à la tâche Ajout de balises pour la publication.

AVERTISSEMENT

Vous devez avoir configuré une ou plusieurs chaînes dans YouTube avant d’ajouter des chaînes sous Paramètres YouTube dans Experience Manager (voir la section Configuration de YouTube dans Experience Manager ci-dessous). Si vous ne parvenez pas à configurer un ou plusieurs canaux, vous n’êtes pas averti de l’absence de canaux. L’authentification Google a lieu lorsque vous ajoutez une chaîne, mais il n’existe pas d’option permettant de choisir la chaîne vers laquelle la vidéo est envoyée.

Pour créer une chaîne YouTube :

  1. Accédez à https://www.youtube.com, puis connectez-vous à l’aide des informations d’identification de votre compte Google.

  2. Dans l’angle supérieur droit de la page YouTube, cliquez sur l’image de votre profil (peut également s’afficher sous la forme d’une lettre dans un cercle coloré uni), puis cliquez sur Paramètres YouTube (icône sous forme d’engrenage rond).

  3. Sur la page Présentation, sous l’en-tête Fonctionnalités supplémentaires, cliquez sur Voir toutes mes chaînes ou créer une chaîne.

  4. Depuis la page Chaînes, cliquez sur Créer une chaîne.

  5. Sur la page Compte de marque, dans le champ nom du compte de marque, saisissez un nom d’entité professionnelle ou tout autre nom de chaîne de votre choix sous lequel vous souhaitez publier vos ressources vidéo, puis cliquez sur Créer.

    Mémorisez le nom que vous entrez ici ; vous devrez le saisir à nouveau lorsque vous devrez configurer YouTube dans Experience Manager.

  6. (Facultatif) Si nécessaire, ajoutez d’autres chaînes.

    Ajoutez à présent des balises pour la publication.

Ajout de balises pour la publication

Pour publier vos vidéos sur YouTube, Experience Manager associe des balises à une ou plusieurs chaînes YouTube. Pour ajouter des balises pour publication, consultez la section Administration des balises.

Ou, si vous prévoyez d’utiliser les balises par défaut dans Experience Manager, vous pouvez ignorer cette tâche et accéder à l’Activation de l’agent de réplication de publication YouTube.

Activation de l’agent de réplication de publication YouTube

Après avoir activé l’agent de réplication de publication YouTube, si vous souhaitez tester la connexion au compte Google Cloud, appuyez sur Tester la connexion. Un onglet de navigateur affiche les résultats de la connexion. Si vous avez ajouté des chaînes YouTube, une liste de ces chaînes s’affiche dans le cadre du test.

  1. Dans le coin supérieur gauche d’Experience Manager, cliquez sur le logo d’Experience Manager, puis dans le rail de gauche, cliquez sur Outils > Déploiement > Réplication > Agents sur l’auteur.

  2. Sur la page Agents sur l’auteur, cliquez sur Publication YouTube.

  3. Dans la barre d’outils, à droite de Paramètres, cliquez sur Modifier.

  4. Cochez la case Activé pour activer l’agent de réplication.

  5. Cliquez sur OK.

    Configurez maintenant YouTube dans Experience Manager.

Configuration de YouTube dans Experience Manager

À partir d’Experience Manager 6.4, une nouvelle méthode d’interface utilisateur tactile a été ajoutée pour configurer la publication YouTube dans Experience Manager. Selon l’instance d’Experience Manager que vous utilisez, effectuez l’une des opérations suivantes :

Configuration de YouTube dans Experience Manager 6.4 et dans ses versions ultérieures

  1. Veillez à vous connecter à votre instance Dynamic Media en tant qu’administrateur.

  2. Dans le coin supérieur gauche, appuyez sur le logo Experience Manager, puis, dans le rail de gauche, appuyez sur Outils (icône de marteau) > Services cloud > Configuration de la publication sur YouTube.

  3. Appuyez sur global (sans sélectionner cette option).

  4. Dans le coin supérieur droit de la page Global, appuyez sur Créer.

  5. Sur la page Créer une configuration YouTube, sous Paramètres de plateforme Google Cloud, dans le champ Nom de l’application, saisissez l’ID de projet Google.

    Vous avez spécifié l’ID de projet lorsque vous avez précédemment configuré les paramètres de Google Cloud.
    Laissez ouverte la page Créer une configuration YouTube ; vous allez y revenir dans un instant.

    6_5_youtubepublish-createyoutubeconfiguration

  6. À l’aide d’un éditeur de texte brut, ouvrez le fichier JSON que vous avez téléchargé et enregistré au cours de la tâche Configuration des paramètres de Google Cloud.

  7. Sélectionnez l’intégralité du texte JSON et copiez-le.

  8. Revenez à la boîte de dialogue Paramètres du compte YouTube. Dans le champ Configuration JSON, collez le texte JSON.

  9. Dans le coin supérieur droit de la page, appuyez sur Enregistrer.

    Configurez maintenant les canaux YouTube dans Experience Manager.

  10. Appuyez sur Ajouter un canal.

  11. Dans la boîte de dialogue Paramètres de chaîne, saisissez le nom de la chaîne que vous avez créée lors de la tâche Ajout d’une ou plusieurs chaînes YouTube précédemment.

    Vous pouvez éventuellement ajouter une description.

  12. Appuyez sur Ajouter.

  13. L’authentification YouTube/Google s’affiche. Si vous n’êtes pas déjà connecté à un compte Google Cloud, ignorez cette étape.

    • Saisissez le nom d’utilisateur Google et le mot de passe associés à l’ID de projet Google et au texte JSON ci-dessus.
    • Selon le nombre de chaînes associées à votre compte, deux éléments au moins sont affichés. Sélectionnez une chaîne. Ne sélectionnez pas l’adresse e-mail, car il ne s’agit pas d’une chaîne.
    • Dans la page suivante, appuyez sur Accepter pour autoriser l’accès à cette chaîne.
  14. Appuyez sur Autoriser.

    Configurez maintenant des balises pour la publication.

  15. Configuration de balises pour la publication : dans la page Services cloud > YouTube, appuyez sur l’icône en forme de crayon pour modifier la liste des balises que vous souhaitez utiliser.

  16. Appuyez sur l’icône de liste déroulante (flèche pointant vers le bas) pour afficher la liste des balises disponibles dans Experience Manager.

  17. Appuyez sur une ou plusieurs balises pour les ajouter.

    Pour supprimer une balise que vous avez ajoutée, sélectionnez-la, puis appuyez sur X.

  18. Lorsque vous avez terminé d’ajouter les balises souhaitées, appuyez sur Enregistrer.

    Vous allez à présent publier des vidéos sur votre chaîne YouTube.

Configuration de YouTube dans une version d’Experience Manager antérieure à la version 6.4

  1. Veillez à vous connecter à votre instance Dynamic Media en tant qu’administrateur.

  2. Dans le coin supérieur gauche, appuyez sur le logo Experience Manager, puis, dans le rail de gauche, appuyez sur Outils (icône de marteau) > Déploiement > Services cloud.

  3. Sous le titre Services tiers, appuyez sur Configurer maintenant sous YouTube.

  4. Dans la boîte de dialogue Créer une configuration, saisissez un titre (obligatoire) et un nom (facultatif) dans les champs correspondants.

  5. Appuyez sur Créer.

  6. Dans la boîte de dialogue Paramètres du compte YouTube, dans le champ Nom de l’application, saisissez l’ID de projet Google.

    Vous avez spécifié l’ID de projet lorsque vous avez précédemment configuré les paramètres de Google Cloud.
    Laissez la boîte de dialogue Paramètres de compte YouTube ouverte. Vous y retournerez dans quelques instants.

  7. À l’aide d’un éditeur de texte brut, ouvrez le fichier JSON que vous avez téléchargé et enregistré au cours de la tâche Configuration des paramètres de Google Cloud.

  8. Sélectionnez l’intégralité du texte JSON et copiez-le.

  9. Revenez à la boîte de dialogue Paramètres du compte YouTube. Dans le champ Configuration JSON, collez le texte JSON.

  10. Appuyez sur OK.

    Configurez maintenant les canaux YouTube dans Experience Manager.

  11. À droite des Canaux disponibles, appuyez sur + (icône représentant un signe plus).

  12. Dans la boîte de dialogue Paramètres de chaîne YouTube, dans le champ Titre, saisissez le nom de la chaîne que vous avez créée lors de la tâche Ajout d’une ou plusieurs chaînes YouTube précédemment.

    Vous pouvez éventuellement ajouter une description.

  13. Appuyez sur OK.

  14. L’authentification YouTube/Google s’affiche. Si vous n’êtes pas déjà connecté à un compte Google Cloud, ignorez cette étape.

    • Saisissez le nom d’utilisateur Google et le mot de passe associés à l’ID de projet Google et au texte JSON ci-dessus.
    • Selon le nombre de chaînes associées à votre compte, deux éléments au moins sont affichés. Sélectionnez une chaîne. Ne sélectionnez pas l’adresse e-mail, car il ne s’agit pas d’une chaîne.
    • Dans la page suivante, appuyez sur Accepter pour autoriser l’accès à cette chaîne.
  15. Appuyez sur Autoriser.

    Configurez maintenant des balises pour la publication.

  16. Configuration de balises pour la publication : dans la page Services cloud > YouTube, appuyez sur l’icône en forme de crayon pour modifier la liste des balises que vous souhaitez utiliser.

  17. Appuyez sur l’icône de liste déroulante (flèche pointant vers le bas) pour afficher la liste des balises disponibles dans Experience Manager.

  18. Appuyez sur une ou plusieurs balises pour les ajouter.

    Pour supprimer une balise que vous avez ajoutée, sélectionnez-la, puis appuyez sur X.

  19. Lorsque vous avez terminé d’ajouter les balises souhaitées, appuyez sur OK.

    Vous allez à présent publier des vidéos sur votre chaîne YouTube.

(Facultatif) Automatisation de la définition des propriétés YouTube par défaut pour vos vidéos chargées

Vous pouvez éventuellement automatiser la définition des propriétés YouTube lors du chargement de vos vidéos en créant un profil de traitement des métadonnées dans Experience Manager.

Pour créer le profil de traitement des métadonnées, vous allez d’abord copier les valeurs des champs Étiquette de champ, Associer à la propriété et Choix, tous situés dans les schémas de métadonnées pour la vidéo. Ensuite, vous allez créer votre propre profil de traitement des métadonnées vidéo YouTube en y ajoutant ces valeurs.

Pour automatiser la définition des propriétés YouTube par défaut pour vos vidéos chargées, procédez comme suit :

  1. Dans le coin supérieur gauche d’Experience Manager, appuyez sur le logo d’Experience Manager, puis, dans le rail de gauche, cliquez sur Outils (icône Marteau) > Ressources > Schémas de métadonnées.

  2. Cliquez sur l’option Par défaut. (Ne cochez pas la case de sélection à gauche de l’option « Par défaut ».)

  3. Sur la page par défaut, cochez la case à gauche de vidéo, puis appuyez sur Modifier.

  4. Sur la page Éditeur de schéma de métadonnées, appuyez sur l’onglet Avancé.

  5. Sous l’en-tête Publication YouTube, cliquez sur Catégorie YouTube.

  6. Dans la partie droite de la page, sous l’onglet Paramètres, procédez comme suit :

    • Dans le champ de texte Associer à la propriété, sélectionnez la valeur et copiez-la.
      Collez la valeur copiée dans l’éditeur de texte ouvert. Par la suite, vous aurez besoin de cette valeur lorsque vous créez le profil de traitement des métadonnées. Laissez l’éditeur de texte ouvert.

    • Sous Choix, sélectionnez la valeur par défaut à utiliser (comme « Personnes et blogs » ou « Science et technologie ») et copiez-la.
      Collez la valeur copiée dans l’éditeur de texte ouvert. Par la suite, vous aurez besoin de cette valeur lorsque vous créez le profil de traitement des métadonnées. Laissez l’éditeur de texte ouvert.

  7. Sous l’en-tête de Publication YouTube, appuyez sur Confidentialité YouTube.

  8. Dans la partie droite de la page, sous l’onglet Paramètres, procédez comme suit :

    • Dans le champ de texte Associer à la propriété, sélectionnez la valeur et copiez-la.
      Collez la valeur copiée dans l’éditeur de texte ouvert. Par la suite, vous aurez besoin de cette valeur lorsque vous créez le profil de traitement des métadonnées. Laissez l’éditeur de texte ouvert.

    • Sous Choix, sélectionnez la valeur par défaut à utiliser et copiez-la. Notez que les choix sont regroupés par paires. Le champ inférieur de la paire correspond à la valeur par défaut que vous souhaitez copier, comme valeur publique, non répertoriée ou privée.
      Collez la valeur copiée dans l’éditeur de texte ouvert. Par la suite, vous aurez besoin de cette valeur lorsque vous créez le profil de traitement des métadonnées. Laissez l’éditeur de texte ouvert.

  9. Près du coin supérieur droit de la page Éditeur de schéma de métadonnées, cliquez sur Annuler.

  10. Dans le coin supérieur gauche d’Experience Manager, appuyez sur le logo Experience Manager, puis, dans le rail de gauche, cliquez sur Outils (icône Marteau) > Ressources > Profils de métadonnées.

  11. Sur la page Profils de métadonnées, près du coin supérieur droit de la page, cliquez sur Créer.

  12. Dans la boîte de dialogue Ajouter un profil de métadonnées, dans le champ de texte Titre du profil, saisissez le nom YouTube Video, puis cliquez sur Créer.

  13. Sur la page Éditeur de profil de métadonnées, cliquez sur l’onglet Avancé.

  14. Ajoutez les valeurs de publication YouTube copiées au profil en procédant comme suit :

    • Dans la partie droite de la page, cliquez sur l’onglet Créer le formulaire.

    • (Facultatif) Faites glisser le composant appelé En-tête de section vers la gauche et déposez-le dans la zone de formulaire.

    • (Facultatif) Cliquez sur Libellé du champ pour sélectionner le composant.

    • (Facultatif) Dans la partie droite de la page, sous l’onglet Paramètres, dans le champ de texte Libellé du champ, saisissez YouTube Publishing.

    • Cliquez sur l’onglet Créer le formulaire, puis faites glisser le composant appelé Texte à plusieurs valeurs et déposez-le sous l’en-tête Publication YouTube que vous avez créé.

    • Cliquez sur Libellé du champ afin de sélectionner le composant.

    • Dans la partie droite de la page, sous l’onglet Paramètres, collez les valeurs de publication YouTube (valeur Libellé du champ et Associer à la propriété) copiées précédemment, dans les champs respectifs du formulaire. Collez la valeur Choix dans le champ Valeur par défaut.

  15. Ajoutez les valeurs de confidentialité YouTube copiées au profil en procédant comme suit :

    • Dans la partie droite de la page, cliquez sur l’onglet Créer le formulaire.

    • (Facultatif) Faites glisser le composant appelé En-tête de section vers la gauche et déposez-le dans la zone de formulaire.

    • (Facultatif) Cliquez sur Libellé du champ pour sélectionner le composant.

    • (Facultatif) Dans la partie droite de la page, sous l’onglet Paramètres, dans le champ de texte Libellé du champ, saisissez YouTube Privacy.

    • Cliquez sur l’onglet Créer le formulaire, puis faites glisser le composant appelé Texte à plusieurs valeurs et déposez-le sous l’en-tête Confidentialité YouTube que vous avez créé.

    • Cliquez sur Libellé du champ afin de sélectionner le composant.

    • Dans la partie droite de la page, sous l’onglet Paramètres, collez les valeurs de publication YouTube (valeur Libellé du champ et Associer à la propriété) copiées précédemment, dans les champs respectifs du formulaire. Collez la valeur Choix dans le champ Valeur par défaut.

  16. Près du coin supérieur droit de la page, cliquez sur Enregistrer.

  17. Appliquez le profil des métadonnées de publication YouTube aux dossiers dans lesquels vous allez transférer des vidéos. Vous devez avoir configuré le profil des métadonnées et le profil vidéo.

    Voir Profils de métadonnées et Profils vidéo.

Publication de vidéos sur votre chaîne YouTube

Vous devez maintenant associer les balises que vous avez précédemment ajoutées aux ressources vidéo. Ce processus permet à Experience Manager de déterminer les ressources à publier sur votre chaîne YouTube.

REMARQUE

Lors de l’exécution de Dynamic Media en mode Scene7, notez que le mode de publication Immédiatement ne publie pas automatiquement sur YouTube. Lorsque le mode Scene7 de Dynamic Media est configuré, il existe deux options de publication parmi lesquelles choisir : Immédiatement ou Lors de l’activation.

Dans le mode de publication Immédiatement, la ressource téléchargée (une fois synchronisée avec IPS) est automatiquement publiée sur le système de diffusion. Cela vaut pour Dynamic Media, mais pas pour YouTube. Pour publier sur YouTube, vous devez publier par le biais d’Experience Manager Author.

REMARQUE

Pour publier du contenu depuis YouTube, Experience Manager utilise le workflow Publier sur YouTube, qui vous permet de surveiller la progression et de consulter toutes les informations d’échec.

Voir Surveillance du codage vidéo et de la progression de la publication sur YouTube.

Pour obtenir des informations de progression plus détaillées, vous pouvez surveiller le journal YouTube sous la réplication. Sachez toutefois que ce type de surveillance nécessite un accès administrateur.

Pour publier des vidéos sur votre chaîne YouTube, procédez comme suit :

  1. Dans Experience Manager, accédez à la ressource vidéo que vous souhaitez publier sur votre chaîne YouTube.

  2. Sélectionnez la ressource vidéo (visionneuse de vidéos adaptative).

  3. Dans la barre d’outils, cliquez sur Propriétés.

  4. Dans l’onglet De base, sous l’en-tête Métadonnées, cliquez sur Boîte de dialogue Ouvrir la sélection à droite du champ Balises.

  5. Sur la page Sélectionner des balises, accédez aux balises que vous souhaitez utiliser, puis sélectionnez-en une ou plusieurs.

    N’oubliez pas que les balises doivent être associées à la chaîne YouTube.

  6. Dans le coin supérieur droit de la page, cliquez sur Sélectionner.

  7. Dans le coin supérieur droit de la page des propriétés de la vidéo, cliquez sur Enregistrer et fermer.

  8. Dans la barre d’outils, cliquez sur Publication rapide.

    Consultez également Utilisation de la gestion de la publication avec Experience Manager Sites.

    Vous avez la possibilité de vérifier la vidéo publiée sur votre chaîne YouTube.

(Facultatif) Vérification de la vidéo publiée sur YouTube

Vous pouvez si vous le souhaitez surveiller la progression de votre publication YouTube (ou sa dépublication).

Voir Surveillance du codage vidéo et de la progression de la publication sur YouTube.

Le délai de publication peut varier considérablement en fonction de nombreux facteurs, comme le format de la vidéo source originale, la taille du fichier et le trafic de chargement. La publication peut prendre de quelques minutes à plusieurs heures. En outre, les formats de haute résolution sont rendus beaucoup plus lentement. Par exemple, les vidéos en 720p et en 1 080p prennent plus de temps à s’afficher que les vidéos en 480p.

Au bout de huit heures, si un message de statut indiquant Téléchargé (en cours de traitement, veuillez patienter) s’affiche toujours, essayez de supprimer la vidéo de votre site Adobe et chargez-la à nouveau.

Liaison d’URL YouTube à votre application web

Une fois que vous avez publié la vidéo, une chaîne URL YouTube est générée par Dynamic Media. Lorsque vous copiez l’URL YouTube, elle est envoyée au Presse-Papiers dont vous pouvez coller le contenu, le cas échéant, sur les pages de votre site web ou de votre application.

REMARQUE

L’URL YouTube ne peut pas être copiée tant que vous n’avez pas publié la ressource vidéo sur YouTube.

Pour lier des URL YouTube à votre application web, procédez comme suit :

  1. Accédez au YouTube publié ressource vidéo dont vous souhaitez copier l’URL, puis sélectionnez-la.

    N’oubliez pas que les URL YouTube peuvent être copiées uniquement après la publication des ressources vidéo sur YouTube.

  2. Dans la barre d’outils, cliquez sur Propriétés.

  3. Cliquez sur l’onglet Avancé.

  4. Sous l’en-tête Publication YouTube, dans la liste des URL YouTube, sélectionnez le texte de l’URL et copiez-le dans votre navigateur web pour prévisualiser la ressource ou l’ajouter à votre page de contenu web.

Dépublication de vidéos afin de les supprimer de YouTube

Lorsque vous dépubliez une ressource vidéo dans Experience Manager, la vidéo est supprimée de YouTube.

ATTENTION

Si vous supprimez une vidéo directement sur YouTube, Experience Manager l’ignore et continue de se comporter comme si la vidéo était toujours publiée sur YouTube. Veillez toujours à dépublier une ressource vidéo sur YouTube via Experience Manager.

REMARQUE

Pour supprimer du contenu depuis YouTube, Experience Manager utilise le processus Dépublier sur YouTube, qui vous permet de surveiller la progression et de consulter toutes les informations d’échec.

Voir Surveillance du codage vidéo et de la progression de la publication sur YouTube.

Pour dépublier des vidéos afin de les supprimer de YouTube, procédez comme suit :

  1. Accédez à la ressource vidéo que vous souhaitez publier sur votre chaîne YouTube.
  2. Dans un mode de sélection de ressource, sélectionnez une ou plusieurs ressources vidéo publiées.
  3. Dans la barre d’outils, cliquez sur Gérer la publication. Appuyez sur l’icône de points de suspension (. . .) dans la barre d’outils pour ouvrir Gérer la publication.
  4. Sur la page Gérer la publication, appuyez sur Annuler la publication.
  5. Dans le coin supérieur droit de la page, appuyez sur Suivant.
  6. Dans le coin supérieur droit de la page, appuyez sur Annuler la publication.

Surveillance du codage vidéo et de la progression de la publication sur YouTube

Lorsque vous téléchargez une nouvelle vidéo vers un dossier auquel un codage vidéo a été appliqué ou que vous publiez votre vidéo sur YouTube, vous pouvez contrôler la manière dont votre codage vidéo/publication YouTube progresse. La progression réelle de la publication YouTube n’est disponible que dans les journaux. Cependant, son échec ou son succès sont répertoriés de différentes manières décrites dans la procédure suivante. En outre, vous recevez des notifications par e-mail lorsqu’un workflow de publication YouTube ou un codage vidéo est terminé ou interrompu.

Surveillance de la progression

  1. Consultez la progression du codage vidéo dans votre dossier de ressources :

    • En mode Carte, la progression du codage vidéo s’affiche sur la ressource en pourcentage. Si une erreur se produit, ces informations s’affichent également sur cette ressource.

    chlimage_1-429

    • En mode Liste, la progression du codage vidéo s’affiche dans la colonne État du traitement. Si une erreur se produit, le message suivant s’affiche dans la même colonne.

    chlimage_1-430

    Cette colonne ne s’affiche pas par défaut. Pour activer la colonne, sélectionnez l’option Paramètres d’affichage dans le menu contextuel des affichages et ajoutez la colonne État du traitement et appuyez ou cliquez sur Mettre à jour.

    chlimage_1-431

  2. Consultez la progression dans les détails de la ressource. Lorsque vous appuyez ou cliquez sur une ressource, ouvrez le menu contextuel et sélectionnez Chronologie. Pour le réduire à des activités de processus comme le codage ou la publication YouTube, sélectionnez Processus.

    chlimage_1-432

    Toutes les informations sur le workflow, telles que le codage, s’affichent dans le journal. Pour la publication YouTube, la chronologie du workflow comprend également le nom de la chaîne YouTube et l’URL de la vidéo YouTube. En outre, une fois la publication terminée, les notifications d’échec s’affichent dans la chronologie du workflow.

    REMARQUE

    L’enregistrement des messages d’erreur ou d’échec peut prendre un certain temps en raison des différentes configurations de workflows pour les nouvelles tentatives, l’intervalle entre deux tentatives et le délai d’attente de https://localhost:4502/system/console/configMgr, par exemple :

    * Configuration de la file d’attente des tâches Apache Sling
    * Gestionnaire des tâches du processus externe de processus Adobe Granite
    * File d’attente des délais d’attente des processus Granite
    

    Vous pouvez ajuster les propriétés reprises, délai de reprise et délai d’expiration dans ces configurations.

  3. Pour les workflows en cours, consultez les instances de workflow disponibles sous Outils > Processus > Instances.

    REMARQUE

    Vous aurez peut-être besoin de droits administratifs pour accéder au menu Outils.

    chlimage_1-433

    Sélectionnez l’instance et appuyez sur Ouvrir l’historique.

    chlimage_1-434

    Depuis la section instances de workflow, vous pouvez également suspendre, arrêter ou renommer les workflows. Voir Administration des workflows pour plus d’informations.

  4. Pour les tâches qui ont échoué, consultez la section Échecs des processus disponible sous Outils > Processus > Échecs. L’échec du processus répertorie toutes les activités du processus ayant échoué.

    REMARQUE

    Vous aurez peut-être besoin de droits administratifs pour accéder au menu Outils.

    chlimage_1-435

    REMARQUE

    L’enregistrement du message d’erreur peut prendre un certain temps en raison des différentes configurations de workflows pour les nouvelles tentatives, l’intervalle entre deux tentatives et le délai d’attente de https://localhost:4502/system/console/configMgr, par exemple :

    * Configuration de la file d’attente des tâches Apache Sling
    * Gestionnaire des tâches du processus externe de processus Adobe Granite
    * File d’attente des délais d’attente des processus Granite
    

    Vous pouvez ajuster les propriétés reprises, délai de reprise et délai d’expiration dans ces configurations.

  5. Pour les workflows terminés, consultez l’archive de workflow sous Outils > Processus > Archive. La liste Archive de workflow répertorie toutes les activités de workflow qui ont réussi.

    REMARQUE

    Vous aurez peut-être besoin de droits administratifs pour accéder au menu Outils.

    chlimage_1-436

  6. Vous recevez des notifications par courrier électronique sur les tâches de processus annulées ou qui ont échoué. Ces notifications peuvent être configurées par un administrateur. Voir Configuration des notifications par e-mail.

Configuration des notifications par e-mail

REMARQUE

Vous aurez peut-être besoin de droits d’administration pour accéder au menu Outils.

La façon dont vous configurez les notifications varie si vous souhaitez recevoir des notifications pour les tâches de codage ou pour les tâches de publication YouTube :

  • Pour les tâches de codage, vous pouvez accéder à la page Configuration pour toutes les notifications par e-mail des processus Experience Manager sous Outils > Opérations > Console web, puis en recherchant Service de notification par e-mail des workflows Day CQ. Consultez la section Configuration des notifications par e-mail dans Experience Manager. Vous pouvez cocher ou décocher les cases de l’option Envoyer une notification pour les tâches arrêtées ou Envoyer une notification pour les tâches terminées.

  • Pour les tâches de publication YouTube, procédez comme suit :

  1. Dans Experience Manager, appuyez sur Outils > Workflow > Modèles.

  2. Sur la page Modèles de processus, sélectionnez Publier sur YouTube, puis appuyez sur Modifier dans la barre d’outils.

  3. Dans le coin supérieur droit du processus Publier vers YouTube, appuyez sur Modifier.

  4. Pointez sur le composant Chargement YouTube, puis appuyez une fois pour afficher la barre d’outils intégrée.

    6_5_publishtoyoutubeworkflow

  5. Sur la barre d’outils intégrée, appuyez sur l’icône Configuration (en forme de clé). Cliquez sur l’onglet Arguments.

    6_5_publishtoyoutubeworkflow-configurationicon

  6. Dans la boîte de dialogue Processus de chargement sur YouTube – Propriétés des étapes, appuyez sur l’onglet Arguments.

    6_5_publishtoyoutubeworkflow-arguments-tab

  7. Vous pouvez cocher ou décocher les cases suivantes :

    • Début de la publication
    • Échec de la publication
    • Publication terminée – comprend des informations sur les chaînes et les URL

    Décocher une case signifie que vous ne recevrez pas de notifications par e-mail spécifiques au workflow de publication YouTube.

    REMARQUE

    Ces e-mails sont spécifiques à YouTube et sont un complément aux notifications électroniques génériques des workflows. Par conséquent, vous pouvez recevoir deux ensembles de notifications électroniques : une notification générique disponible dans le Service de notification par e-mail des workflows Day CQ et une notification spécifique à YouTube, en fonction de vos paramètres de configuration.

  8. Une fois que vous avez terminé, en haut à droite de la boîte de dialogue, appuyez sur l’icône Terminé (coche).

  9. Sur la page du workflow Publier sur YouTube, en haut à droite, appuyez sur Synchroniser.

Affichage des rapports vidéo

REMARQUE

Les rapports vidéo sont disponibles uniquement lorsque vous exécutez Dynamic Media en mode Hybride.

Les rapports vidéo affichent plusieurs mesures agrégées sur une heure spécifiée pour vous permettre de vérifier que les vidéos individuelles et agrégées publiées ont les performances attendues. Les données des mesures principales suivantes sont agrégées pour toutes les vidéos publiées sur l’ensemble de votre site web :

  • Lancements de vidéo
  • Taux d’achèvement
  • Temps moyen sur la vidéo
  • Durée totale sur la vidéo
  • Vidéos par visite

Un tableau de toutes les vidéos publiées est également fourni pour vous permettre de suivre les vidéos les plus visionnées sur votre site web en fonction du total des lancements de vidéo.

Lorsque vous appuyez sur le nom d’une vidéo dans la liste, le rapport sur la rétention de l’audience (taux de déperdition) de la vidéo s’affiche sous la forme d’un graphique en courbes. Le graphique présente le nombre de vues pour un moment donné pendant la lecture vidéo. Lorsque vous lisez la vidéo, la barre verticale effectue un suivi en synchronisation avec l’indicateur temporel du lecteur. Les pertes de données du graphique en courbes indiquent où votre audience perd de son intérêt.

Si la vidéo a été codée en dehors d’Adobe Experience Manager Dynamic Media, le graphique sur la rétention de l’audience (taux de déperdition) et les données de pourcentage de lecture du tableau ne sont pas disponibles.

Consultez également la section Configuration des Services cloud Dynamic Media.

REMARQUE

Le suivi et les données de création de rapports reposent exclusivement sur l’utilisation du lecteur vidéo de Dynamic Media et du paramètre prédéfini du lecteur vidéo associé. Par conséquent, vous ne pouvez pas effectuer le suivi et créer de rapports sur les vidéos lues par d’autres lecteurs vidéo.

Par défaut, la première fois que vous utilisez l’option Rapports vidéo, le rapport affiche des données vidéo du premier jour du mois en cours jusqu’à la date du mois en cours. Vous pouvez toutefois remplacer la période par défaut par la vôtre. La prochaine fois que vous utiliserez l’option Rapports vidéo, la période que vous avez spécifiée sera utilisée.

Pour que les rapports vidéo fonctionnent correctement, un identifiant de suite de rapports est automatiquement créé lors de la configuration des Cloud Services Dynamic Media. Dans le même temps, l’identifiant de suite de rapports est transmis au serveur de publication pour qu’il soit disponible pour la fonctionnalité de copie d’URL lors de la prévisualisation de ressources. Cette fonctionnalité nécessite toutefois que le serveur de publication soit déjà configuré. Si le serveur de publication n’est pas configuré, vous pouvez tout de même lancer la publication pour afficher le rapport vidéo. Cependant, vous devez revenir à la configuration du cloud Dynamic Media et appuyer sur OK.

Pour afficher un rapport vidéo, procédez comme suit :

  1. Dans le coin supérieur gauche d’Experience Manager, appuyez sur le logo Experience Manager, puis, dans le rail de gauche, appuyez sur Outils (icône Marteau) > Ressources > Rapports vidéo.

  2. Dans la page Rapport vidéo, effectuez l’une des opérations suivantes :

    • Dans le coin supérieur droit, appuyez sur l’icône Actualiser le rapport vidéo.
      N’utilisez la commande d’actualisation que si la date de fin du rapport correspond à la date du jour. Cette exigence vous garantit de voir le suivi vidéo qui a eu lieu depuis la dernière exécution du rapport.

    • Dans le coin supérieur droit, appuyez sur l’icône Sélecteur de date.
      Indiquez la période de début et de fin pour laquelle vous souhaitez obtenir les données vidéo, puis appuyez sur Exécuter le rapport.

    Le groupe Mesures principales identifie diverses mesures agrégées pour toutes les vidéos publiées sur votre site.

  3. Dans le tableau qui répertorie les vidéos les plus publiées, appuyez sur le nom d’une vidéo pour la lire et afficher également le rapport sur la rétention de l’audience (taux de déperdition) de la vidéo.

Affichage de rapports vidéo reposant sur une visionneuse de vidéos créée à l’aide du SDK de visionneuse HTML5 Dynamic Media

Si vous utilisez une visionneuse de vidéos prête à l’emploi fournie par Dynamic Media ou si vous avez créé un paramètre prédéfini de visionneuse personnalisée reposant sur une visionneuse de vidéos prête à l’emploi, aucune autre étape n’est nécessaire pour afficher les rapports vidéo. En revanche, si vous avez créé votre propre visionneuse de vidéos en vous reposant sur l’API de SDK de visionneuse HTML5, suivez les étapes ci-après pour vous assurer que votre visionneuse de vidéos envoie des événements de suivi aux rapports vidéo Dynamic Media.

Utilisez le guide de référence des visionneuses Dynamic Media et l’API de SDK de visionneuse HTML5 pour créer vos propres visionneuses de vidéos.

Pour afficher des rapports vidéo reposant sur une visionneuse de vidéos créée à l’aide du SDK de visionneuse HTML5 Dynamic Media, procédez comme suit :

  1. Accédez à une ressource vidéo publiée.

  2. Près du coin supérieur gauche de la page du fichier, sélectionnez Visionneuses dans la liste déroulante.

  3. Sélectionnez un paramètre prédéfini de visionneuse de vidéos et copiez le code intégré.

  4. Dans le code intégré, recherchez la ligne suivante :

    videoViewer.setParam("config2", "<value>");

    Le paramètre config2 active le suivi dans les visionneuses HTML5. Il s’agit également d’un paramètre prédéfini spécifique à l’entreprise qui contient des informations de configuration pour les rapports vidéo et pour les configurations Adobe Analytics propres au client.

    La valeur correcte du paramètre config2 figure dans le code intégré et la fonction Copier l’URL. Dans l’URL provenant de la commande Copier l’URL, le paramètre à rechercher est &config2=<value>. La valeur est pratiquement toujours companypreset, mais dans certains cas elle peut également être companypreset-1, companypreset-2, etc.

  5. Dans le code de la visionneuse de vidéos personnalisée, ajoutez le fichier AppMeasurementBridge.jsp à la page de la visionneuse en procédant comme suit :

    • Tout d’abord, déterminez si vous avez besoin du paramètre &preset.

      Si le paramètre config2 est companypreset, vous n’avez pas besoin de &preset=parameter.

      Si le paramètre config2 a une autre valeur, attribuez au paramètre preset la même valeur que le paramètre config2. Par exemple, si config2=companypreset-2, ajoutez &param2=companypreset-2 à l’URL d’AppMeasurmentBridge.jsp.

    • Ajoutez ensuite le script AppMeasurementBridge.jsp :

      <script language="javascript" type="text/javascript" src="https://s7d1.scene7.com/s7viewers/AppMeasurementBridge.jsp?company=robindallas&preset=companypreset-2"></script>

  6. Créez le composant TrackingManager en effectuant les opérations suivantes :

    • Après avoir appelé s7sdk.Util.init();, créez une instance TrackingManager pour suivre les événements en ajoutant le code suivant :

      var trackingManager = new s7sdk.TrackingManager();

    • Connectez les composants à TrackingManager en procédant comme suit :

      Dans le gestionnaire d’événements s7sdk.Event.SDK_READY, attachez le composant à suivre à TrackingManager.

      Par exemple, si le composant est videoPlayer, ajoutez

      trackingManager.attach(videoPlayer);

      pour joindre le composant à TrackingManager. Pour suivre plusieurs visionneuses sur une page, utilisez plusieurs composants de gestionnaire de suivi.

    • Créez l’objet AppMeasurementBridge en ajoutant ce qui suit :

      var appMeasurementBridge = new AppMeasurementBridge(); appMeasurementBridge.setVideoPlayer(videoPlayer);
      
    • Ajoutez la fonction de suivi en ajoutant le code suivant :

      trackingManager.setCallback(appMeasurementBridge.track,
       appMeasurementBridge);
      

    L’objet appMeasurementBridge dispose d’une fonction de suivi intégrée. Vous pouvez toutefois fournir votre propre fonction pour prendre en charge plusieurs systèmes de suivi ou d’autres fonctionnalités.

Ajout de légendes ou de sous-titres à la vidéo

Vous pouvez étendre la portée de vos vidéos aux marchés mondiaux en ajoutant des légendes aux vidéos ou aux visionneuses de vidéos adaptatives. L’ajout de sous-titres codés vous évite d’avoir à dupliquer l’audio ou d’utiliser des locuteurs natifs pour enregistrer le son dans chaque langue. La vidéo est lue dans la langue dans laquelle elle a été enregistrée. Les sous-titres en langue étrangère s’affichent pour que les personnes parlant d’autres langues puissent néanmoins comprendre la partie audio.

Les légendes permettent également une plus grande accessibilité pour les personnes sourdes ou malentendantes.

REMARQUE

Le lecteur vidéo utilisé doit prendre en charge l’affichage des sous-titres.

Consultez également la section Accessibilité dans Dynamic Media.

Dynamic Media convertit les fichiers de légende au format JSON (JavaScript Object Notation). Cette conversion signifie que vous pouvez intégrer le texte JSON dans une page web sous forme de transcription masquée complète de la vidéo. Les moteurs de recherche peuvent ensuite analyser et indexer le contenu pour permettre de trouver plus facilement les vidéos et fournir aux utilisateurs des informations supplémentaires sur le contenu des vidéos.

Pour plus d’informations sur l’utilisation de la fonction JSON dans une URL, reportez-vous à la section Service de contenu statique (hors images) dans l’Aide de l’API de service et de rendu d’images de Dynamic Media.

Pour ajouter des sous-titres à une vidéo :

  1. Utilisez une application tierce ou un service de création de fichiers de sous-titres de vidéo.

    Assurez-vous que le fichier que vous créez est conforme à la norme WebVTT (Web Video Text Tracks). L’extension de fichier des fichiers de sous-titres est .vtt. D’autres informations sur la norme de sous-titrage WebVTT sont disponibles.

    Reportez-vous à la section WebVTT : The web video text tracks format.

    Il existe des outils et des services gratuits et payants que vous pouvez utiliser pour créer les fichiers de sous-titres en dehors de Dynamic Media. Par exemple, pour créer un fichier de sous-titres vidéo simple sans style, vous pouvez utiliser l’outil de création et de modification de sous-titres en ligne gratuit suivant :

    WebVTT Caption Maker

    Pour de meilleurs résultats, utilisez cet outil dans Internet Explorer 9 ou version ultérieure, dans Google Chrome ou Safari.

    Dans l’outil, dans le champ Saisir l’URL du fichier vidéo, collez l’URL copiée de votre fichier vidéo, puis cliquez sur Charger. Voir Obtention d’une URL pour une ressource pour obtenir l’URL du fichier vidéo proprement dit, que vous pouvez coller ensuite dans le champ Saisir l’URL du fichier vidéo. Internet Explorer, Chrome ou Safari peuvent alors lire la vidéo en mode natif.

    À présent, suivez les instructions à l’écran du site pour créer et enregistrer votre fichier WebVTT. Lorsque vous avez terminé, copiez le contenu du fichier de sous-titres et collez-le dans un éditeur de texte brut, puis enregistrez-le avec une extension de fichier .vtt.

    REMARQUE

    Pour la bonne prise en charge internationale des sous-titres vidéo dans différentes langues, la norme WebVTT implique de créer des fichiers .vtt distincts et des appels pour chaque langue à prendre en charge.

    En règle générale, vous devez attribuer au fichier de sous-titres VTT le même nom qu’au fichier vidéo et vous lui ajoutez l’indicateur de paramètres régionaux, comme -EN, -FR ou -DE. Ainsi, vous pouvez automatiser aisément la génération des URL de vidéo avec le système de gestion de contenu web existant.

  2. Dans Experience Manager, chargez votre fichier de sous-titres WebVTT dans le DAM.

  3. Accédez à la ressource vidéo publiée à associer au fichier de sous-titres que vous avez chargé.

    N’oubliez pas que les URL ne peuvent être copiées qu’après la publication des ressources.

    Voir Publication de ressources.

  4. Utilisez l’une des méthodes suivantes :

    • Pour une expérience de visionneuse de vidéos pop-up, appuyez sur URL. Dans la boîte de dialogue URL, sélectionnez l’URL et copiez-la dans le Presse-papiers, puis collez-la dans un éditeur de texte simple. Ajoutez l’URL copiée de la vidéo avec la syntaxe suivante :

      &caption=<server_path>/is/content/<path_to_caption.vtt_file,1>

      Notez le « ,1 » à la fin du chemin du fichier de sous-titres. Juste après l’extension de fichier .vtt dans le chemin d’accès, vous avez la possibilité d’activer ou de désactiver le bouton de sous-titres dans la barre de lecteur vidéo en définissant la valeur respectivement sur « ,1 » ou « ,0 ».

    • Pour une expérience de visionneuse de vidéos intégrée, appuyez sur Code intégré. Dans la boîte de dialogue Code intégré, sélectionnez le code intégré et copiez-le dans le Presse-papiers, puis collez-le dans un simple éditeur de texte. Ajoutez le code intégré copié avec la syntaxe suivante :

      videoViewer.setParam("caption","<path_to_caption.vtt_file,1>");

      Notez le « ,1 » à la fin du chemin du fichier de sous-titres. Juste après l’extension de fichier .vtt dans le chemin d’accès, vous avez la possibilité d’activer ou de désactiver le bouton de sous-titres dans la barre de lecteur vidéo en définissant la valeur respectivement sur « ,1 » ou « ,0 ».

Ajout de marqueurs de chapitre à la vidéo

Vous pouvez faciliter la lecture et le parcours de vos vidéos les plus longues en ajoutant des marqueurs de chapitre aux vidéos uniques ou aux visionneuses de vidéos adaptatives. Lorsqu’un utilisateur lit la vidéo, il peut cliquer sur les marqueurs de chapitre dans la chronologie de la vidéo (également appelée défilement vidéo) pour accéder facilement à son point ciblé. Il peut également accéder immédiatement à de nouveaux contenus, à des démonstrations et à des tutoriels.

REMARQUE

Le lecteur vidéo utilisé doit prendre en charge l’utilisation des marqueurs de chapitre. Les lecteurs vidéo Dynamic Media prennent en charge les marqueurs de chapitre, mais l’utilisation de lecteurs vidéo tiers ne le permet pas.

Si vous le souhaitez, vous pouvez créer votre propre visionneuse personnalisée et lui donner le nom de votre marque, en utilisant des chapitres au lieu d’utiliser le paramètre prédéfini de la visionneuse de vidéos. Pour obtenir des instructions sur la création de votre propre visionneuse HTML5 avec une navigation par chapitre, dans l’API de SDK de la visionneuse HTML5 d’Adobe, reportez-vous à la section « Personnalisation du comportement à l’aide de modificateurs » sous les classes s7sdk.video.VideoPlayer et s7sdk.video.VideoScrubber. Consultez la documentation API du SDK de la visionneuse HTML5.

Vous créez une liste de chapitres pour votre vidéo un peu de la même façon que vous créez des sous-titres. Autrement dit, vous créez un fichier WebVTT. Notez toutefois que ce fichier doit être distinct de tout autre fichier de sous-titrage WebVTT que vous utilisez ; vous ne pouvez pas combiner les sous-titres et les chapitres dans un fichier WebVTT.

Vous pouvez utiliser l’exemple suivant comme un exemple du format que vous pouvez utiliser pour créer un fichier WebVTT avec une navigation par chapitre :

Fichier WebVTT avec navigation par chapitre vidéo

WEBVTT
Chapter 1
00:00.000 --> 01:04.364
The bicycle store behind it all.
Chapter 2
01:04.364 --> 02:00.944
Creative Cloud.
Chapter 3
02:00.944 --> 03:02.937
Ease of management for a working solution.
Chapter 4
03:02.937 --> 03:35.000
Cost-efficient access to rapidly evolving technology.

Dans l’exemple ci-dessus, le Chapter 1 est l’identifiant de repère et il est facultatif. La période de repère 00:00:000 --> 01:04:364 indique l’heure de début et l’heure de fin du chapitre au format 00:00:000. Les trois derniers chiffres sont les millisecondes et peuvent être laissés sur 000, selon vos préférences. Le titre du chapitre de The bicycle store behind it all est la description réelle du contenu du chapitre. L’identifiant de repère, l’heure de repère de départ et le titre du chapitre apparaissent tous dans une fenêtre contextuelle du lecteur vidéo lorsqu’un utilisateur place le pointeur de la souris sur un point de repère visuel dans la chronologie de la vidéo.

Étant donné que vous utilisez une visionneuse de vidéos HTML5, assurez-vous que le fichier de chapitres que vous créez est conforme à la norme WebVTT (Web Video Text Tracks). L’extension de nom de fichier de chapitres est .vtt. D’autres informations sur la norme de sous-titrage WebVTT sont disponibles.

Reportez-vous à la section WebVTT : The web video text tracks format

Pour ajouter une navigation par chapitre vidéo, procédez comme suit :

  1. Enregistrez le fichier .vtt en codage UTF8 pour éviter tout problème de rendu des caractères dans le texte des titres de chapitres.

    En règle générale, vous attribuez au fichier de chapitres VTT le même nom que celui du fichier vidéo et lui ajoutez le mot « chapitres ». Ainsi, vous pouvez automatiser aisément la génération des URL de vidéo avec le système de gestion de contenu web existant.

  2. Dans Experience Manager, chargez votre fichier de chapitres WebVTT.

    Voir la section Chargement des ressources.

  3. Utilisez l’une des méthodes suivantes :

    Pour une expérience de visionneuse de vidéos pop-up
    1. Accédez à la ressource vidéo publiée à associer au fichier de chapitres que vous avez chargé. N’oubliez pas que les URL ne peuvent être copiées qu’après la publication des ressources. Voir Publication de ressources.
    2. Dans le menu déroulant, cliquez ou appuyez ensuite sur Visionneuses.
    3. Dans le rail de gauche, appuyez ou cliquez sur le nom du paramètre prédéfini de la visionneuse de vidéos. Un aperçu de la vidéo s’ouvre dans une page distincte.
    4. Dans le rail de gauche, dans la partie inférieure, cliquez sur URL.
    5. Dans la boîte de dialogue URL, sélectionnez l’URL et copiez-la dans le Presse-papiers, puis collez-la dans un simple éditeur de texte.
    6. Ajoutez l’URL copiée de la vidéo avec la syntaxe suivante pour l’associer à l’URL copiée dans votre fichier de chapitres :

      &navigation=<full_copied_URL_path_to_chapter_file.vtt>
    Pour une expérience de visionneuse de vidéos incorporée
    1. Accédez à la ressource vidéo publiée à associer au fichier de chapitres que vous avez chargé. N’oubliez pas que les URL ne peuvent être copiées qu’après la publication des ressources. Voir Publication de ressources.
    2. Dans le menu déroulant, cliquez ou appuyez ensuite sur Visionneuses.
    3. Dans le rail de gauche, appuyez ou cliquez sur le nom du paramètre prédéfini de la visionneuse de vidéos. Un aperçu de la vidéo s’ouvre dans une page distincte.
    4. En bas du rail gauche, cliquez sur Intégrer.
    5. Dans la boîte de dialogue Code intégré, sélectionnez et copiez le code entier dans le Presse-papiers, puis collez-le dans un simple éditeur de texte.
    6. Ajoutez le code intégré de la vidéo avec la syntaxe suivante pour l’associer à l’URL copiée dans votre fichier de chapitres :

      videoViewer.setParam("navigation","<full_copied_URL_path_to_chapter_file.vtt>"

À propos des miniatures vidéo dans Dynamic Media en mode Scene7

Une miniature vidéo est une version en taille réduite d’une image vidéo ou d’une ressource d’image présentant la vidéo au client. La miniature doit inciter un client à cliquer sur la vidéo.

Toutes les vidéos dans Experience Manager doivent être associées à une miniature. Vous ne pouvez pas supprimer une miniature sans la remplacer. Par défaut, lorsque vous chargez une vidéo sur Experience Manager, la première image est utilisée comme miniature. Cependant, vous pouvez personnaliser la miniature à des fins de valorisation de marque ou de recherche visuelle, par exemple. Lorsque vous personnalisez une miniature vidéo, vous pouvez lire la vidéo et la mettre en pause sur l’image que vous souhaitez utiliser. Vous pouvez également sélectionner une ressource d’image que vous avez déjà chargée et publiée dans votre gestionnaire de ressources numériques.

Une image de miniature vidéo personnalisée que vous sélectionnez dans une vidéo n’est pas extraite et enregistrée dans la gestion des ressources numériques sous la forme d’une ressource séparée et distincte. Toutefois, une miniature vidéo personnalisée que vous sélectionnez dans une ressource d’image existante est enregistrée dans le JCR. Le chemin d’accès de la ressource sélectionnée est stocké sous le nœud de la ressource vidéo, comme dans l’exemple suivant :

/content/dam/*<folder_name*>/<*video_name*>/jcr:content/manualThumbnail

Vous ne pouvez personnaliser une miniature vidéo qu’après avoir appliqué un profil vidéo au dossier dans lequel se trouve la vidéo.

Voir aussi À propos des miniatures vidéo dans le mode Hybride de Dynamic Media.

Ajout d’une miniature vidéo personnalisée

Ces étapes s’appliquent uniquement à Dynamic Media s’exécutant en mode « Dynamicmedia_Scene7 ».

Pour ajouter une miniature vidéo personnalisée, procédez comme suit :

  1. vérifiez que vous avez déjà :

  2. Accédez à une ressource vidéo téléchargée dont vous souhaitez changer l’image miniature.

  3. Dans l’un des modes de sélection des ressources (mode Liste ou Carte), appuyez sur la ressource vidéo.

  4. Dans la barre d’outils, appuyez sur l’icône Propriétés (icône en forme de cercle avec un « i » à l’intérieur).

  5. Sur la page Propriétés de la vidéo, appuyez sur Modifier la miniature.

  6. Sur la page Modifier la miniature, effectuez l’une des opérations suivantes :

    • Pour utiliser une image de la vidéo comme nouvelle miniature :

      • Sur la barre d’outils, appuyez sur Sélectionner une image dans la vidéo.
      • Appuyez sur le bouton Lecture, puis sur le bouton Pause sur l’image à capturer comme nouvelle miniature de la vidéo.
    • Pour utiliser une ressource d’image comme nouvelle miniature :

      • Sur la barre d’outils, appuyez sur Sélectionner la miniature dans les ressources.
      • Appuyez sur Sélectionner la miniature.
      • Accédez à une ressource d’image précédemment chargée et publiée que vous souhaitez utiliser. La ressource est automatiquement redimensionnée afin de servir d’image miniature pour la vidéo.
      • Sélectionnez la ressource d’image, puis appuyez sur Sélectionner.
  7. Sur la page Modifier la miniature, appuyez sur Enregistrer la modification.

  8. Sur la page Propriétés de la vidéo, en haut à droite, appuyez sur Enregistrer et Fermer.

À propos des miniatures vidéo dans le mode Hybride de Dynamic Media

Vous pouvez choisir l’une des dix images miniatures générées automatiquement par Dynamic Media pour l’ajouter à votre vidéo. Le lecteur vidéo affiche votre miniature sélectionnée lorsqu’une ressource vidéo est utilisée avec le composant Dynamic Media dans l’environnement de création d’Experience Manager Sites, Experience Manager Mobile ou Experience Manager Screens. La miniature sert d’image statique pour représenter au mieux le contenu de votre vidéo complète et encourage davantage les utilisateurs à cliquer sur le bouton Lecture.

En fonction de la durée totale de la vidéo, Dynamic Media capture dix images miniatures (par défaut). Les images sont capturées à 1 %, 11 %, 21 %, 31 %, 41 %, 51 %, 61 %, 71 %, 81 % et 91 % dans la vidéo. Les dix miniatures restent, ce qui signifie que si vous décidez de sélectionner une miniature différente ultérieurement, vous n’avez pas besoin de générer de nouveau une série de miniatures. Vous prévisualisez les dix images miniatures, puis choisissez celle que vous souhaitez utiliser pour votre vidéo. Si vous souhaitez modifier cette option par défaut, vous pouvez utiliser CRXDE Lite pour configurer l’intervalle pour lequel les miniatures sont générées. Par exemple, si vous souhaitez uniquement générer une série de quatre miniatures également espacées dans votre vidéo, vous pouvez configurer l’intervalle à 24 %, 49 %, 74 % et 99 %.

Dans l’idéal, vous pouvez ajouter une miniature de vidéo à tout moment après avoir chargé votre vidéo, mais avant de la publier sur votre site web.

Si vous préférez, vous pouvez charger une miniature personnalisée pour représenter votre vidéo au lieu d’en utiliser une générée par Dynamic Media. Par exemple, vous pouvez créer une miniature personnalisée qui porte le titre de votre vidéo, une image d’ouverture attrayante ou une image bien spécifique capturée dans votre vidéo. L’image de vidéo personnalisée que vous chargez doit avoir une résolution maximale de 1280 x 720 pixels (largeur minimale de 640 pixels) et ne pas dépasser 2 Mo.

Consultez également la section À propos des miniatures vidéo dans le mode Scene7 de Dynamic Media.

Ajout d’une miniature vidéo

Ces étapes s’appliquent uniquement à Dynamic Media s’exécutant en mode hybride.

Pour ajouter une miniature vidéo, procédez comme suit :

  1. Accédez à une ressource vidéo téléchargée à laquelle vous souhaitez ajouter une miniature.

  2. Dans un des modes de sélection des ressources (mode Liste ou Carte), appuyez sur la ressource vidéo.

  3. Dans la barre d’outils, appuyez sur l’icône Afficher les propriétés (icône en forme de cercle avec un « i » à l’intérieur).

  4. Sur la page Propriétés de la vidéo, appuyez sur Modifier la miniature.

  5. Sur la page Modifier la miniature, dans la barre d’outils, appuyez sur Sélectionner l’image.

    Dynamic Media génère une série de miniatures de votre vidéo, en fonction de l’intervalle par défaut ou personnalisé.

  6. Prévisualisez les miniatures générées, puis sélectionnez celle que vous souhaitez ajouter à votre vidéo.

  7. Appuyez sur Enregistrer la modification.

    La miniature de la vidéo est mise à jour afin d’utiliser la miniature que vous avez sélectionnée. Si vous décidez par la suite de modifier la miniature, vous pouvez revenir sur la page Modifier la miniature et en sélectionner une autre.

    Si vous avez configuré des intervalles par défaut ou si vous avez chargé une nouvelle vidéo pour remplacer la vidéo existante, vous devrez générer de nouveau des miniatures via Dynamic Media.

    Consultez la section Configuration de l’intervalle par défaut pour la création des miniatures de vidéo.

Configuration de l’intervalle par défaut pour la génération des miniatures de vidéo

Lorsque vous configurez et enregistrez le nouvel intervalle par défaut, votre modification s’applique automatiquement et uniquement aux vidéos que vous chargerez par la suite. Il n’applique pas automatiquement le nouveau paramètre par défaut aux vidéos que vous avez précédemment chargées. Pour les vidéos existantes, vous devez de nouveau générer les miniatures.

Consultez la section Ajout d’une miniature de vidéo.

Pour configurer l’intervalle par défaut auquel les miniatures vidéo sont créées, procédez comme suit :

  1. Dans Experience Manager, appuyez sur Outils > Général > CRXDE Lite.

  2. Dans la page CRXDE Lite, dans le panneau de répertoire à gauche, accédez à o etc/dam/imageserver/configuration/jcr:content/settings..

    Si le panneau des répertoires n’est pas visible, appuyez sur l’icône >> à gauche de l’onglet Accueil.

  3. Sur le panneau en bas à droite, dans l’onglet Propriétés, appuyez deux fois sur thumbnailtime.

  4. Dans la boîte de dialogue Modifier thumbnailtime, utilisez les champs de texte pour saisir des valeurs d’intervalle sous la forme de pourcentages.

    • Appuyez sur l’icône plus (+) pour ajouter un ou plusieurs champs de valeur d’intervalle. Si nécessaire, faites défiler la page jusqu’en bas de la boîte de dialogue pour afficher l’icône.
    • Appuyez sur l’icône du signe moins (-) à droite du champ de valeur d’intervalle si vous souhaitez le supprimer de la liste.
    • Appuyez sur la flèche vers le haut ou vers le bas si vous souhaitez réorganiser les valeurs d’intervalle.
  5. Appuyez sur OK pour retourner à l’onglet Propriétés.

  6. Près du coin supérieur gauche de la page CRXDE Lite, appuyez sur Enregistrer tout, puis appuyez sur l’icône Retour à l’accueil dans le coin supérieur gauche pour revenir à Experience Manager.

    Consultez la section Ajout d’une miniature de vidéo.

Ajout d’une miniature vidéo personnalisée

Ces étapes s’appliquent uniquement à Dynamic Media s’exécutant en mode hybride.

Pour ajouter une miniature vidéo personnalisée, procédez comme suit :

  1. Accédez à une ressource vidéo chargée à laquelle vous souhaitez ajouter une miniature vidéo personnalisée.

  2. Dans un des modes de sélection des ressources (mode Liste ou Carte), appuyez sur la ressource vidéo.

  3. Dans la barre d’outils, appuyez sur l’icône Afficher les propriétés (icône en forme de cercle avec un « i » à l’intérieur).

  4. Sur la page Propriétés de la vidéo, appuyez sur Modifier la miniature.

  5. Sur la page Modifier la miniature, dans la barre d’outils, appuyez sur Charger une nouvelle miniature.

  6. Accédez à une miniature que vous souhaitez utiliser, sélectionnez-la, puis appuyez sur Ouvrir pour commencer à charger l’image dans Experience Manager. Après le téléchargement, veillez à publier l’image.

  7. Après avoir téléchargé et publié l’image, sur la page Modifier la miniature, appuyez sur Enregistrer les modifications.

    La miniature personnalisée est ajoutée à votre vidéo.

Modification de l’URL Dynamic Media pour les ressources Dynamic Media

Les vidéos traitées dans Dynamic Media peuvent être utilisées par le biais de visionneuses prêtes à l’emploi, mais aussi en accédant directement aux URL de manifeste et en les lisant via vos propres visionneuses personnalisées. Voici l’API pour récupérer les URL de manifeste d’une vidéo.

À propos de l’API getVideoManifestURI

Le getVideoManifestURIL’API est exposée via cq-scene7-api:com.day.cq.dam.scene7.api et peut être utilisé pour générer les URL de manifeste suivantes :

/**
* Returns the manifest url for videos
* @param resource video resource
* @param manifestType type of video streaming manifest being requested
* @param onlyIfPublished return a manifest only if the video is published
* @return the manifest url for videos
*
* @throws Exception
*/
@Nullable
String getVideoManifestURI(Resource resource, ManifestType manifestType, boolean onlyIfPublished) throws Exception;

Paramètres de l’API getVideoManifestURI

Cette API utilise les trois paramètres suivants :

Paramètre Description
resource Ressource correspondant à la vidéo ingérée par Dynamic Media.
manifestType Peut être ManifestType.DASH ou ManifestType.HLS
onlyIfPublished Définissez cette variable sur true au cas où l’uri de manifeste n’est générée que si elle est publiée et disponible au niveau de la diffusion.

Pour récupérer les URL de manifeste des vidéos à l’aide de la méthode ci-dessus, ajoutez une profil de codage vidéo dans un dossier "télécharger des vidéos". Dynamic Media traite ces vidéos en fonction des encodages trouvés dans le fichier de codage vidéo qui a été affecté au dossier. Vous pouvez maintenant appeler l’API ci-dessus pour récupérer les URL de manifeste pour les vidéos chargées.

Scénarios d’erreur

L’API renvoie null en cas d’erreur. Les exceptions sont consignées dans les journaux des erreurs du Experience Manager. Toutes ces erreurs journalisées commencent par Could not generate Video Manifest URI. Les scénarios suivants peuvent provoquer de telles erreurs :

  • Un IllegalArgumentException est consigné pour l’un des éléments suivants :

    • Le resource paramètre transmis est nul.
    • Le resource n’est pas une vidéo.
    • Le manifestType paramètre transmis est nul.
    • Le onlyIfPublished est transmis comme true, mais la vidéo n’est pas publiée.
    • La vidéo n’a pas été ingérée à l’aide d’un ensemble de vidéos adaptatives provenant de Dynamic Media.
  • IOException est consigné lorsqu’un problème de connexion à Dynamic Media se produit.

  • UnsupportedOperationException est consigné lorsqu’un événement manifestType paramètre transmis ManifestType.DASH, alors que la vidéo n’a pas été traitée au format DASH.

Voici un exemple de l’API ci-dessus utilisant des servlets écrits dans HTTPWhiteBoard spécification. Sélectionnez chaque onglet pour la syntaxe du code.

 Ajouter une dépendance dans pom.xml
dependency>
     <groupId>com.day.cq.dam</groupId>
     <artifactId>cq-scene7-api</artifactId>
     <version>5.12.64</version>
     <scope>provided</scope>
</dependency>
 Exemple de servlet
@Component
        service = Servlet.class
)
@HttpWhiteboardServletPattern(value = ManifestServlet.SERVLET_PATTERN)
@HttpWhiteboardContextSelect(value = Constants.SERVLET_CONTEXT_SELECTOR)
public class ManifestServlet extends HttpServlet {

   private static final Logger LOGGER = LoggerFactory.getLogger(ManifestServlet.class);

   private final ObjectMapper objectMapper;

    @Reference
    private Scene7Service scene7Service;

   public static final String SERVLET_PATTERN = Constants.VIDEO_API_PREFIX + "/manifestUrl";

   public ManifestServlet() {
         this.objectMapper = new ObjectMapper();
         objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
   }

   @Override

   protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException {
        final ResourceResolver resolver = getResourceResolver(request);
        String assetPath = request.getParameter("assetPath");
        String manifest = request.getParameter("manifestType");
        String onlyIfPublished = request.getParameter("onlyIfPublished");
        Resource resource = resolver.getResource(assetPath);
        response.setCharacterEncoding(StandardCharsets.UTF_8.toString());
        response.setContentType("application/json");
        if(resource == null) {
            LOGGER.info("could not retrieve the resource from JCR");
            error("could not retrieve the resource from JCR", response);
            return;
        }

        String manifestUri = null;

        try{
            ManifestType manifestType =  ManifestType.DASH;
            if(manifest != null) {
                manifestType = ManifestType.valueOf(manifest);
            }
            manifestUri = scene7Service.getVideoManifestURI(resource, manifestType, onlyIfPublished != null);
            objectMapper.writeValue(response.getWriter(), new ManifestUrl(manifestUri));
            response.setContentType("application/json");
        } catch (Exception e) {
            LOGGER.error(e.getMessage(), e);
            error(String.format("Unable to get the manifest url for %s. %s", assetPath, e.getMessage()), response);
        }
    }

    private ResourceResolver getResourceResolver(HttpServletRequest request) {
        Object rr = request.getAttribute(AuthenticationSupport.REQUEST_ATTRIBUTE_RESOLVER);
        if (!(rr instanceof ResourceResolver)) {
            throw new IllegalStateException(
                    "The request does not seem to have been created via Apache Sling's authentication mechanism.");
        } else {
            return (ResourceResolver) rr;
        }
    }

    private void error(String errorMessage, HttpServletResponse response) throws IOException {
        ManifestUrl errorManifest = new ManifestUrl(null);
        errorManifest.setErrorMessage(errorMessage);
        response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
        objectMapper.writeValue(response.getWriter(), errorManifest);
    }
}
 Classe de réponse pour le servlet
public class ManifestUrl extends VideoResponse {
     String manifestUrl;
     public ManifestUrl(String manifestUrl) {
         this.manifestUrl = manifestUrl;
     }
     public String getManifestUrl() {
         return manifestUrl;
     }
}

public abstract class VideoResponse {
     String errorString;

     public String getErrorString() {
         return errorString;
     }

     public void setErrorMessage(String errorString) {
         this.errorString = errorString;
     }
}
 Fichier de constantes référencé dans le servlet
public final class Constants {

     private Constants() {
     }

     public static final String VIDEO_API_PREFIX = "/dynamicmedia/video";
     public static final String SERVLET_CONTEXT_SELECTOR = "(" + HttpWhiteboardConstants.HTTP_WHITEBOARD_CONTEXT_NAME + "=" +
             DMSampleApiHttpContext.CONTEXT_NAME + ")";

 }
 ServletContext

Montez le servlet ci-dessus à l’aide d’une servletContext. Voici un exemple de servletContext.

public class DMSampleApiHttpContext extends ServletContextHelper {

 public static final String CONTEXT_NAME = "com.adobe.dmSample";
 public static final String CONTEXT_PATH = "/dmSample";

 private final MimeTypeService mimeTypeService;

 private final AuthenticationSupport authenticationSupport;

 /**
  * Constructs a new context that will use the given dependencies.
  *
  * @param mimeTypeService Used when providing mime type of requests.
  * @param authenticationSupport Used to authenticate requests with sling.
  */
 @Activate
 public DMSampleApiHttpContext(@Reference final MimeTypeService mimeTypeService,
                               @Reference final AuthenticationSupport authenticationSupport) {
     this.mimeTypeService = mimeTypeService;
     this.authenticationSupport = authenticationSupport;
 }

 // ---------- HttpContext interface ----------------------------------------
 /**
  * Returns the MIME type as resolved by the <code>MimeTypeService</code> or
  * <code>null</code> if the service is not available.
  */
 @Override
 public String getMimeType(String name) {
     MimeTypeService mtservice = mimeTypeService;
     if (mtservice != null) {
         return mtservice.getMimeType(name);
     }
     return null;
 }

 /**
  * Returns the real context path that is used to mount this context.
  * @param req servlet request
  * @return the context path
  */
 public static String getRealContextPath(HttpServletRequest req) {
     final String path = req.getContextPath();
     if (path.equals(CONTEXT_PATH)) {
         return "";
     }
     return path.substring(CONTEXT_PATH.length());
 }

 /**
  * Returns a request wrapper that transforms the context path back to the original one
  * @param req request
  * @return the request wrapper
  */
 public static HttpServletRequest createContextPathAdapterRequest(HttpServletRequest req) {
     return new HttpServletRequestWrapper(req) {

         @Override
         public String getContextPath() {
             return getRealContextPath((HttpServletRequest) getRequest());
         }

     };

 }

 /**
  * Always returns <code>null</code> because resources are all provided
  * through individual endpoint implementations.
  */
 @Override
 public URL getResource(String name) {
     return null;
 }

 /**
  * Tries to authenticate the request using the
  * <code>SlingAuthenticator</code>. If the authenticator or the Repository
  * is missing this method returns <code>false</code> and sends a 503/SERVICE
  * UNAVAILABLE status back to the client.
  */
 @Override
 public boolean handleSecurity(HttpServletRequest request,
                               HttpServletResponse response) throws IOException {

     final AuthenticationSupport authenticator = this.authenticationSupport;
     if (authenticator != null) {
         return authenticator.handleSecurity(createContextPathAdapterRequest(request), response);
     }

     // send 503/SERVICE UNAVAILABLE, flush to ensure delivery
     response.sendError(HttpServletResponse.SC_SERVICE_UNAVAILABLE,
             "AuthenticationSupport service missing. Cannot authenticate request.");
     response.flushBuffer();

     // terminate this request now
     return false;
 }
}

Utilisation de l’exemple de servlet

Vous appelez le servlet en effectuant une GET operation /dmSample/dynamicmedia/video/manifestUrl. Les paramètres de requête suivants sont transmis :

Paramètre de requête Description
assetPath Obligatoire. Chemin d’accès à la vidéo pour laquelle manifestUrl est généré.
manifestType Facultatif. Le paramètre peut être DASH ou HLS. S’il n’est pas transmis, la valeur par défaut est DASH.
onlyIfPublished Facultatif. Si elle est transmise, la variable manifestUrl est renvoyée uniquement si la vidéo est publiée.

Dans cet exemple, supposons la configuration suivante :

  • La société est samplecompany.
  • L’instance de création est http://sample-aem-author.com.
  • Le dossier /content/dam/video-example est associé à un profil de codage vidéo.
  • La vidéo scenery.mp4 est chargé dans le dossier /content/dam/video-example.

Vous pouvez appeler le servlet de la manière suivante :

Type Description
HLS http://sample-aem-author.com/dmSample/dynamicmedia/video/manifestUrl?manifestType=HLS&assetPath=/content/dam/video-example/scenery.mp4

Si la diffusion DASH est activée :
{"manifestUrl":"https://s7d1.scene7.com/is/content/samplecompany/scenery-AVS.m3u8?packagedStreaming=true"}

Si la diffusion DASH est désactivée :
{"manifestUrl":"https://s7d1.scene7.com/is/content/samplecompany/scenery-AVS.m3u8"}
DASH http://sample-aem-author.com/dmSample/dynamicmedia/video/manifestUrl?manifestType=DASH&assetPath=/content/dam/video-example/scenery.mp4

Si la diffusion DASH est activée :
{"manifestUrl":"https://s7d1.scene7.com/is/content/samplecompany/scenery-AVS.mpd"}

Si la diffusion DASH est désactivée :
{}
Erreur : chemin d’accès à la ressource incorrect http://sample-aem-author.com/dmSample/dynamicmedia/video/manifestUrl?manifestType=DASH&assetPath=/content/dam/video-example/scennnnnnery.mp4

{"errorString":"could not retrieve the resource from JCR"}

Sur cette page