Lecteur multimédia
But
Fournir un lecteur multimédia accessible permettant d'intégrer des contenus vidéo et audio sur les pages Web.
Exemples
Évaluation et rapport
- Accessibilité (CS WCAG 2.1/2.2 Niveau A & AA)- Anglais Audio Seulement Rapport
- Accessibilité (CS WCAG 2.1/2.2 Niveau A & AA)- Français Audio Seulement Rapport
- Accessibilité (CS WCAG 2.1/2.2 Niveau A & AA)- Anglais Video Rapport
- Accessibilité (CS WCAG 2.1/2.2 Niveau A & AA)- Français Video Rapport
Comment implémenter
Le lecteur multimédia requiert l'utilisation de quelques balises HTML5 et un lien vers la source média que vous désirez intégrer.
Formats des médias
Le lecteur multimédia supporte plusieurs formats, énumérés ci-dessous. Toutefois, nous recommandons que vous fournissiez au minimum tout média vidéo au format MPEG4 (en utilisant les codecs H264 et AAC) afin de pouvoir rejoindre le plus grand auditoire, puisque tous les lecteurs mobiles et la plupart des navigateurs sont en mesure de jouer ce format. Nous recommandons également que vous fournissiez les médias en format WebM (en utilisant le codec VP8) en plus du format MPEG4 afin de prendre avantage du support natif du navigateur, par exemple Firefox.
Formats compatibles
- Vidéo : MPEG4 (H264+AAC), WebM (VP8)
- Audio : MP3, Ogg Vorbis
- Sous-titrage : TTML, HTML5 Data
Éléments requis
- Chaque lecteur multimédia doit être placé dans sa propre balise
<figure>
en utilisant la classewb-mltmd
:<figure class="wb-mltmd">
- Chaque contenant devrait contenir une balise
<video>
ou<audio>
. -
Facultatif : Ajoutez un lien "Partagez cette vidéo" ou "Partagez ce fichier audio" en ajoutant ce qui suit à la balise
figure
:data-wb-mltmd='{"shareUrl": "url"}'
-
Ajoutez l'élément
figcaption
à l'élémentfigure
avec le titre du fichier vidéo ou audio. Si une transcription est requise, ajoutez soit le lien vers la transcription, soit un "details/summary" contenant le texte de la transcription.<figcaption> <p>Trouver un emploi</p> </figcaption>
<figcaption> <p>Trouver un emploi (<a href="cpts-lg-fr.html">Transcription</a>)</p> </figcaption>
<figcaption> <details id="inline-captions"> <summary>Trouver un emploi - Transcription/Sous-titrage HTML5 </summary> <p class="wet-boew-vd"><strong>(La vidéo débute par une image de l'animatrice s'avançant vers la caméra. Un trait rouge suit le texte « Trouver un emploi ».)</strong></p> <p class="wet-boew-vd"><strong>(Coupure et plan moyen de l'animatrice. DESSIN AU TRAIT : Le bonhomme-allumettes apparaît à l'écran.)</strong></p> <p><span class="wb-tmtxt" data-begin="2.50s" data-dur="3.84s">Bonjour, je m'appelle Amélie et je travaille à Service Canada.</span></p> ... </details> </figcaption>
Vidéo
- Ajoutez l'attribut
poster
à l'élémentvideo
avec la valeur étant l'URL de la vignette de l'image illustrant la vidéo. - Ajoutez l'attribut
title
à l'élémentvideo
avec la valeur étant le titre de la vidéo. -
Ajoutez un ou plusieurs éléments
source
à l'élémentvideo
avec l'attributsrc
ayant comme valeur l'URL du fichier média et l'attributtype
étant son type MIME.
Note : Si vous indiquez plusieurs sources média pour la vidéo, le lecteur jouera le premier média qui fonctionne (est disponible, compatible, etc.).<source type="video/webm" src="https://video2.servicecanada.gc.ca/video/boew-wet/te-lj-fra.webm" /> <source type="video/mp4" src="https://video2.servicecanada.gc.ca/video/boew-wet/te-lj-fra.mp4" />
- Ajoutez l'élément
track
aveckind="captions"
à l'élémentvideo
pour inclure le sous-titrage.-
Ajoutez les attributs
srclang
etlabel
à l'élémenttrack
pour identifier la langue du sous-titrage.<track srclang="fr" label="Français" />
- Ajoutez les attributs
src
etdata-type
à l'élémenttrack
pour identifier la source du sous-titrage.- Timed Text Markup Language :
data-type="application/ttml+xml"
etsrc
est l'URL du fichier de sous-titrage de format Timed Text Markup Language. - Fichier de sous-titrage HTML :
data-type="text/html"
etsrc
est l'URL du fichier de sous-titrage HTML. - Sous-titrage HTML en ligne :
data-type="text/html"
andsrc
est l'URL du sous-titrage HTML en ligne (e.g.,src="#inline-captions"
).
- Timed Text Markup Language :
<track src="cpts-lg-fr.html" kind="captions" data-type="text/html" srclang="fr" label="Français" />
-
Ajoutez les attributs
- Facultatif : Ajoutez des boutons pour accéder aux marqueurs temporels dans la vidéo.
- Ajoutez un élément
button
dans le contenantfigure
. - Spécifiez le marqueur en secondes (ex. 75s) ou en temps (01:15)
<button class="btn btn-info cuepoint" data-cuepoint="75s">Marqueur temporel - 75s</button>
<button class="btn btn-info cuepoint" data-cuepoint="01:15">Marqueur temporel - 01:15</button>
- Ajoutez un élément
Code
<figure class="wb-mltmd" data-wb-mltmd='{"shareUrl": "https://wet-boew.github.io/v4.0-ci/demos/multimedia/multimedia-fr.html"}'>
<video poster="demo/video1-fr.jpg" title="Trouver un emploi">
<source type="video/webm" src="https://video2.servicecanada.gc.ca/video/boew-wet/te-lj-fra.webm" />
<source type="video/mp4" src="https://video2.servicecanada.gc.ca/video/boew-wet/te-lj-fra.mp4" />
<track src="cpts-lg-fr.html" kind="captions" data-type="text/html" srclang="fr" label="Français" />
</video>
<button class="btn btn-info cuepoint" data-cuepoint="75s">Marqueur temporel - 75s</button>
<figcaption>
<p>Trouver un emploi (<a href="cpts-lg-fr.html">Transcription</a>)</p>
</figcaption>
</figure>
Vidéo (YouTube)
- Ajoutez l'attribut
title
à l'élémentvideo
avec la valeur étant le titre de la vidéo. Ajoutez un élément
source
à l'élémentvideo
avec l'attributtype="video/youtube"
et l'attributsrc
étant l'URL de la vidéo.<source type="video/youtube" src="https://www.youtube.com/watch?v=9znKJqnFuuY" />
Ou
<source type="video/youtube" src="https://youtu.be/9znKJqnFuuY" />
- Si le sous-titrage n'est pas déjà inclut pour la vidéo, l'ajouter avec les outils fournis par YouTube.
Code
<figure class="wb-mltmd">
<video title="Suspect">
<source type="video/youtube" src="https://www.youtube.com/watch?v=9znKJqnFuuY" />
</video>
<figcaption>
<p>Suspect</p>
</figcaption>
</figure>
Audio
- Ajoutez l'attribut
title
à l'élémentaudio
avec la valeur étant le titre de l'audio. -
Ajoutez un ou plusieurs éléments
source
à l'élémentaudio
avec l'attributsrc
avec la valeur étant l'URL du fichier média et l'attributtype
étant le type MIME du fichier.
Note : Si vous indiquez plusieurs sources média pour l'audio, le lecteur jouera le premier fichier média qui fonctionne (est disponible, compatible, etc.).<source src="https://www.archive.org/download/RideOfTheValkyries/ride_of_the_valkyries_2.mp3" type="audio/mp3" /> <source src="https://www.archive.org/download/RideOfTheValkyries/ride_of_the_valkyries_2.ogg" type="audio/ogg" />
Code
<figure class="wb-mltmd">
<audio title="Ride of the Valkyries">
<source src="https://www.archive.org/download/RideOfTheValkyries/ride_of_the_valkyries_2.mp3" type="audio/mp3" />
<source src="https://www.archive.org/download/RideOfTheValkyries/ride_of_the_valkyries_2.ogg" type="audio/ogg" />
</audio>
<figcaption>
<p>Ride of the Valkyries</p>
</figcaption>
</figure>
Options de configuration
Option | Description | Comment configurer | Valeurs |
---|---|---|---|
shareUrl |
Ajoute un lien "Partagez cette vidéo" ou "Partagez ce fichier audio" | Ajoutez à l'élément avec l'attribut class="wb-mltmd" . |
|
fullscreenBtn |
Ajoute un bouton pour afficher la vidéo en plein écran. Remarque : le bouton n'est pas ajouté par défaut car les contrôles ne sont pas visibles en plein écran. |
Ajoutez à l'élément avec l'attribut class="wb-mltmd" . |
|
Événements
Événement | Déclencheur | Ce qu'il fait |
---|---|---|
wb-init.wb-mltmd |
Déclenché manuellement (e.g., $( ".wb-mltmd" ).trigger( "wb-init.wb-mltmd" ); ). |
Utilisé pour initialiser manuellement le lecteur multimédia. Note : Le lecteur sera initialisé automatiquement à moins que le code du lecteur soit ajouté après que la page ait déjà été chargée. |
wb-ready.wb-mltmd (v4.0.5+) |
Déclenché automatiquement après que le lecteur soit initialisé. | Utilisé pour identifier quel lecteur est initialisé (cible de l'événement)
|
wb-ready.wb (v4.0.5+) |
Déclenché automatiquement quant BOEW a fini son chargement et son exécution. | Utilisé pour identifier quand tous les plugiciels BOEW et les polyfills ont terminé leur chargement et leur exécution.
|
Code source
- Date de modification :