Vidéo intégrée : règles et exemples

Une vidéo intégrée est un enregistrement hébergé ou embarqué depuis une plateforme externe, placé dans le flux de lecture de l’article pour démontrer, expliquer ou documenter une idée délimitée. Elle comprend un intitulé visible, une image d’affiche réfléchie, des commandes de lecture, des sous-titres, une durée et une transcription complète. Sans ces mots qui l’entourent, un lecteur non identifié est invisible pour tout lecteur qui ne peut pas ou choisit de ne pas regarder — et quasi vide pour les systèmes qui extraient du texte plutôt que de décoder l’enregistrement.

Le commentaire sur l’image d’affiche en attente est une spécification de capture, pas une référence à une ressource. Le HTML environnant démontre l’ordre de lecture requis avant que la production média ne soit terminée.

Pourquoi cet élément est important

La vidéo réduit le coût d’explication lorsque le mouvement, le rythme, la voix ou le changement dans le temps porte du sens. Un lecteur peut voir comment un menu s’ouvre, comment un produit physique se déplace, ou comment un intervenant qualifie une conclusion. Regarder nécessite de l’attention, du son ou des sous-titres, du temps et souvent plus de données que la lecture, donc un intitulé clair et une durée permettent au lecteur d’évaluer ce coût.

Les images d’affiche influencent cette décision avant la lecture. Un plan représentatif agit comme une promesse visuelle de ce que contient l’enregistrement. Une image aléatoire avec des yeux fermés, une roue de chargement, ou un carton titre sans rapport donne l’impression que le contenu est négligé et force le lecteur à appuyer sur lecture pour découvrir son sujet. L’image d’affiche devrait révéler l’état, la personne, l’objet ou le résultat que la vidéo explique réellement.

L’extractibilité machine est la capacité d’un logiciel à retrouver le sens d’une unité de contenu sans en reproduire la présentation. Une simple iframe expose généralement peu plus qu’une URL de fournisseur. Un élément étiqueté expose un titre, un résumé, une durée, une date, une image d’affiche, des sous-titres, une transcription et un identifiant stable. Les systèmes de recherche, traduction, accessibilité et extraction peuvent alors comprendre l’explication délimitée.

La transcription fait donc partie intégrante de l’élément, et non un téléchargement facultatif. Elle préserve les affirmations parlées, les changements d’intervenant, les sons significatifs et les actions visuelles dans l’ordre du document. Les sous-titres soutiennent l’expérience de lecture ; la transcription soutient la page. Suivez les règles d’écriture des éléments communes pour la préséance sémantique, la syntaxe des directives et le mappage du corps. Cette page prévaut lorsqu’elle exige une transcription, une image d’affiche, une durée et des champs d’accessibilité spécifiques à la vidéo.

Quand l’utiliser

Utilisez une vidéo intégrée lorsque des preuves basées sur le temps rendent un point délimité plus clair que des images fixes et de la prose. Les cas appropriés incluent une opération d’interface, une technique physique, une transition visible, une explication d’expert, un comportement produit dépendant du mouvement, ou un résultat enregistré dont la diffusion constitue une preuve.

Appliquez un test de remplacement avant de commander l’enregistrement. Si une capture d’écran et deux phrases expliquent le point aussi bien, utilisez-les : elles se chargent plus vite, se parcourent plus vite et coûtent moins cher à mettre à jour. La vidéo gagne sa place lorsque la séquence, le rythme, le mouvement, la voix ou le comportement observé change la compréhension.

Les cas limites incluent :

• Un long webinaire dans un paragraphe sans rapport : créez un lien vers une page vidéo dédiée ou utilisez une section d’embed vidéo complète. Un élément intégré doit servir l’argument local, pas importer une heure de sujet connexe.
• Une décoration silencieuse en boucle : c’est du motion design, pas une vidéo éditoriale. Supprimez-la ou traitez-la comme un média décoratif avec un comportement à mouvement réduit.
• Un enregistrement d’écran utilisé à la place d’instructions : rédigez les étapes et l’état de réussite en texte. La vidéo peut les démontrer, mais elle ne peut pas être le seul moyen d’accomplir la tâche.
• Une citation client extraite sans contexte : un court extrait peut étayer une étude de cas uniquement si l’intervenant, la relation, la date d’enregistrement, l’approbation et l’affirmation contextuelle sont divulgués.
• Une vidéo dont la seule valeur est la personnalité : utilisez-la uniquement lorsque la voix, la présentation ou l’autorité de l’intervenant est pertinente. Ne forcez pas les lecteurs à regarder un présentateur réciter un texte déjà présent sur la page.
• Plusieurs extraits similaires : utilisez une galerie ou une section média dédiée lorsque la sélection parmi plusieurs enregistrements est la tâche. N’empilez pas les lecteurs intégrés.

Où la placer

Placez la vidéo immédiatement après le paragraphe qui nomme ce que le lecteur va apprendre ou observer. Mettez son titre, sa durée et son résumé avant le lecteur. Placez la transcription directement après, réduite uniquement lorsque le texte complet reste en HTML sans code de lecture.

Dans une procédure, placez le lecteur après la séquence d’actions écrite et avant le dépannage. Le lecteur doit pouvoir agir sans regarder, puis utiliser l’enregistrement pour confirmer le mouvement ou l’état de l’interface. Dans un argumentaire ou une étude de cas, énoncez l’affirmation avant l’enregistrement et interprétez ses limites après.

Ne placez pas la vidéo à côté d’un autre lecteur, d’une animation en lecture automatique, d’un grand appel à l’action, d’un formulaire ou d’un calculateur. Des contrôles concurrents créent un flou de focus. Ne la mettez pas dans une cellule de tableau, un élément de liste, un encadré, un onglet, un carrousel, un panneau d’accordéon ou une carte cliquable. La transcription peut utiliser un contrôle de divulgation ; la vidéo entière ne le doit pas.

Gardez le titre, le résumé, l’image d’affiche, le lecteur, la durée, le contrôle de transcription et le crédit à l’intérieur d’une seule limite de figure. Une note de source peut suivre immédiatement. Ne séparez jamais le lecteur de sa transcription par une publicité, une promotion ou une section sans rapport.

Anatomie

1. Titre visible : Nomme la tâche, la démonstration, l’événement ou l’affirmation en texte HTML spécifique.
2. Résumé : Explique en une phrase ce que le lecteur va voir et pourquoi c’est important.
3. Durée : Indique le coût de visionnage avant la lecture en minutes et secondes.
4. Image d’affiche : Montre une image représentative et approuvée sans prétendre être un bouton à elle seule.
5. Commandes du lecteur : Offrent la lecture, la pause, la recherche, le volume, le plein écran, la vitesse de lecture et l’accès aux sous-titres.
6. Sous-titres : Synchronisent les dialogues, les changements d’intervenant et les contenus audio non verbaux significatifs avec la lecture.
7. Transcription : Reproduit la séquence complète et significative sous forme de texte HTML sélectionnable et rechercheble.
8. Descriptions visuelles : Enregistrent les actions ou changements à l’écran significatifs que la narration n’énonce pas.
9. Crédit et source : Identifient l’intervenant, le créateur, la date d’enregistrement ou la provenance des preuves lorsque c’est pertinent.

Le titre n’est pas le nom du fichier, et le résumé n’est pas « Regardez la vidéo ci-dessous ». Chacun doit rester utile lorsqu’il est copié sans le lecteur.

Exemples de conception

Toutes les variantes partagent le même contrat de contenu. La diffusion change ; l’étiquetage, les sous-titres, la qualité de la transcription, le consentement à la lecture et l’ordre de lecture ne changent pas.

Démonstration hébergée

Utilisez un lecteur HTML5 propriétaire pour un court enregistrement de produit ou de processus lorsque l’organisation contrôle l’encodage, les sous-titres, le choix de l’image d’affiche et la disponibilité.

Embed externe respectueux de la vie privée

Utilisez une plateforme externe lorsque sa diffusion, ses analyses ou son canal établi sont requis. Chargez le fournisseur uniquement après consentement lorsque la politique l’exige, identifiez le fournisseur avant l’activation et conservez la transcription locale même si le fournisseur supprime l’enregistrement.

Court extrait d’interface

Utilisez un extrait concis pour un changement d’état difficile à communiquer avec des images fixes. Il nécessite néanmoins des commandes, un mécanisme de pause, une description textuelle significative et une transcription ; ne le transformez pas en GIF à boucle automatique.

Extrait d’interview ou de témoignage

Utilisez un extrait centré sur un intervenant lorsque la paternité, le choix des mots ou le témoignage observé importe. Affichez le nom et le rôle de la personne en HTML, divulguez les modifications et transcrivez à la fois la parole et les preuves visuelles matérielles.

Paramètres

Ces champs constituent le contrat de contenu portable. La largeur, la bordure, l’ombre, le style du bouton de lecture et le comportement aux points de rupture appartiennent au moteur de rendu.

Le premier titre du corps correspond à title ; le premier paragraphe correspond à summary ; le reste du corps correspond à transcript. Les plages horaires de transcription sont facultatives pour une explication continue d’un seul intervenant et recommandées pour les procédures, les changements d’intervenant et les enregistrements de plus de deux minutes. Les champs autoplay, loop et les champs audio d’arrière-plan sont délibérément absents.

Syntaxe et exemples de code

Chaque notation préserve le même titre, résumé, métadonnées média, sous-titres et transcription. Les domaines d’exemple décrivent le contrat et ne sont pas des références à des ressources de production.

Directive Markdown portable

:::inline-video{src="https://media.example.com/freshness-filter.mp4" provider=hosted poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language=en uploadDate="2026-08-27"}

## Filtrer les pages qui nécessitent une vérification

Découvrez comment appliquer le filtre À vérifier et vérifier la file d'attente de travail résultante.

**00:00–00:18 — Ouvrir le rapport.** Depuis Audit, ouvrez Fraîcheur.

**00:19–00:54 — Appliquer le filtre.** Ouvrez Statut et choisissez À vérifier.

**00:55–01:30 — Vérifier la file d'attente.** Confirmez que chaque ligne visible a le statut attendu.
:::

Shortcode Hugo

{{< inline-video src="https://media.example.com/freshness-filter.mp4" provider="hosted" poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language="en" uploadDate="2026-08-27" >}}
## Filtrer les pages qui nécessitent une vérification

Découvrez comment appliquer le filtre À vérifier et vérifier la file d'attente de travail résultante.

**00:00–00:18 — Ouvrir le rapport.** Depuis Audit, ouvrez Fraîcheur.

**00:19–00:54 — Appliquer le filtre.** Ouvrez Statut et choisissez À vérifier.

**00:55–01:30 — Vérifier la file d'attente.** Confirmez que chaque ligne visible a le statut attendu.
{{< /inline-video >}}

Il s’agit du contrat d’adaptateur prévu, et non d’une affirmation qu’un shortcode local existe. Il utilise uniquement des paramètres nommés. Tant qu’un moteur de rendu n’est pas enregistré, utilisez le HTML sémantique figure, video, track et transcription qui préserve les mêmes champs.

Bloc WordPress

<!-- wp:amicited/inline-video {"src":"https://media.example.com/freshness-filter.mp4","provider":"hosted","poster":"https://media.example.com/freshness-filter-poster.webp","duration":"PT1M30S","captions":"https://media.example.com/freshness-filter.en.vtt","language":"en","uploadDate":"2026-08-27"} -->
<h2>Filter pages that need review</h2>
<p>See how to apply the Needs review filter and verify the resulting work queue.</p>
<video controls preload="metadata" poster="https://media.example.com/freshness-filter-poster.webp">
  <source src="https://media.example.com/freshness-filter.mp4" type="video/mp4">
  <track kind="captions" srclang="en" src="https://media.example.com/freshness-filter.en.vtt" label="English" default>
</video>
<details><summary>Read the transcript</summary><p><strong>00:00–00:18 — Open the report.</strong> From Audit, open Freshness.</p><p><strong>00:19–00:54 — Apply the filter.</strong> Open Status and choose Needs review.</p><p><strong>00:55–01:30 — Verify the queue.</strong> Confirm that every visible row has the expected status.</p></details>
<!-- /wp:amicited/inline-video -->

Si le bloc WordPress enregistré est indisponible, utilisez les blocs natifs Vidéo, Titre, Paragraphe et Détails. Ne collez pas une iframe sans inclure la transcription locale.

Exemples

Bon : une démonstration délimitée avec une alternative textuelle

Filtrer les pages qui nécessitent une vérification · 1:30

La vidéo montre une tâche : ouvrir un rapport de fraîcheur, appliquer un filtre de statut et vérifier le nombre de résultats. Son image d’affiche montre le filtre ouvert, les sous-titres identifient exactement les intitulés d’interface, et la transcription en trois parties enregistre chaque action et vérification de succès. La lecture ne commence qu’après activation.

Cela fonctionne car un lecteur peut anticiper la valeur et le temps nécessaire, regarder avec le son, regarder avec les sous-titres, ou accomplir la même tâche à partir de la transcription. L’enregistrement ajoute des preuves de mouvement et de changement d’état sans devenir la seule instruction.

Mauvais : un lecteur non identifié

Regardez ceci Une iframe tierce se charge automatiquement sous le titre. Son image d’affiche est un cadre noir, aucune durée n’apparaît, les sous-titres sont générés par le fournisseur et non vérifiés, et la page ne contient ni transcription ni résumé.

La version mauvaise force tout lecteur qui ne regarde pas à deviner. Elle ne donne aucun sujet aux extracteurs, demande aux lecteurs soucieux de leur vie privée de contacter un fournisseur avant de choisir la lecture, n’offre aucun texte durable lorsque l’enregistrement disparaît, et peut présenter des sous-titres incorrects comme des faits. Corrigez-la avec un titre et un résumé spécifiques, une image d’affiche réfléchie, une durée, un chargement respectueux du consentement, des sous-titres vérifiés, une transcription locale complète, et une tâche ou une affirmation écrite en dehors du lecteur.

Balisage schema et accessibilité

La vidéo intégrée ne crée pas automatiquement un droit au schéma. Utilisez VideoObject uniquement lorsque la page fournit visiblement des valeurs précises de name, description, thumbnailUrl, uploadDate, duration et contentUrl ou embedUrl pour l’enregistrement accessible. N’inventez jamais de champs pour satisfaire un validateur ou marquer un extrait décoratif comme vidéo principale.

Une vidéo pertinente peut étayer un Article, HowTo ou Product éligible lorsque la page se qualifie indépendamment. Sa transcription ne peut pas justifier des affirmations ou des étapes absentes de la page visible.

L’accessibilité commence avant la lecture. Étiquetez la figure, affichez le titre et la durée en texte, et donnez aux commandes un fonctionnement au clavier et un focus visible. Ne lancez jamais la lecture automatique. Offrez la pause, la recherche, le volume, la vitesse, les sous-titres et le plein écran. Ne piégez pas le focus dans un lecteur tiers ; après la fermeture du plein écran, ramenez-le à la commande d’initiation.

Les sous-titres doivent être synchronisés, ponctués et vérifiés par rapport à l’enregistrement. Identifiez les intervenants lorsque la voix n’est pas évidente et incluez les sons significatifs tels que « [sonnerie de notification] » lorsqu’ils affectent la compréhension. La description audio est requise lorsque des informations visuelles significatives ne sont pas énoncées dans l’audio principal ; une transcription descriptive seule ne rend pas l’expérience de lecture minutée équivalente.

La transcription doit être du vrai HTML dans un ordre logique — pas un canvas, un contenu accessible uniquement en lecture, du texte caché ou un téléchargement PDF uniquement. Les contrôles de divulgation nécessitent un nom accessible et un état déplié. Le lecteur et la transcription doivent fonctionner à 200 % de zoom et aux largeurs étroites sans défilement horizontal au niveau de la page.

Règles d’écriture

Les mots autour du lecteur déterminent si la vidéo est un élément de contenu ou un objet inexpliqué :

• Rédigez un titre spécifique de 4 à 12 mots. Nommez la tâche, la démonstration, l’intervenant, l’événement ou la conclusion ; n’utilisez jamais « Vidéo », « Regardez ceci » ou « En savoir plus » seuls.
• Rédigez une phrase de résumé de 15 à 35 mots qui indique au lecteur ce qui se passe et pourquoi c’est important. Ne répétez pas le titre.
• Gardez les enregistrements intégrés ciblés et normalement sous cinq minutes. Le maximum absolu est de 20 minutes ; les enregistrements plus longs appartiennent à une page dédiée ou nécessitent une segmentation éditoriale.
• Affichez la durée avant la lecture. Utilisez M:SS pour le texte visible et ISO 8601, comme PT1M30S, dans les champs structurés.
• Choisissez une image d’affiche qui représente le sujet à la taille d’affichage normale. Évitez les cadres vides, les roues de chargement, les expressions accidentelles, les boutons de lecture trompeurs, les textes d’interface minuscules et les informations personnelles ou clients non approuvées.
• Vérifiez les sous-titres par rapport au montage final. Corrigez les noms, les intitulés de produits, les chiffres, la terminologie du domaine, la ponctuation, les changements d’intervenant et les sons significatifs.
• Transcrivez toute parole et tout visuel significatifs. Les résumés, les titres de chapitres et les fichiers de sous-titres générés automatiquement ne remplacent pas la transcription.
• Utilisez des courts paragraphes de transcription, des étiquettes d’intervenant si nécessaire, et des plages horaires autour des étapes procédurales ou des changements de sujet. Ne fabriquez pas de citations à partir de propos paraphrasés.
• Divulguez les modifications qui pourraient changer l’interprétation. Ne coupez pas un témoignage, une expérience ou une démonstration de sorte que la séquence implique un résultat non étayé.
• Gardez les instructions essentielles, les prix, les avertissements, les conditions d’éligibilité, les preuves et les appels à l’action en dehors de l’enregistrement. Un lecteur ne doit pas avoir à parcourir une chronologie pour trouver un fait important.
• Ne placez jamais de lecture automatique, de contenu clignotant, d’audio d’arrière-plan, de superpositions de conversion, de champs de transcription verrouillés ou d’un deuxième lecteur à l’intérieur de l’élément.
• Enregistrez le propriétaire du média et le déclencheur de révision. Revérifiez la vidéo lorsque l’interface, la politique, le comportement du produit, l’attribution de l’intervenant ou l’affirmation contextuelle change.

Types d’articles qui l’utilisent

Le tableau postTypes dans le front matter génère cette matrice. L’inclusion permet la vidéo intégrée lorsque des preuves basées sur le temps ajoutent du sens ; elle n’exige pas un lecteur sur chaque page.

Liste de contrôle QA

• La vidéo ajoute un sens basé sur le temps qu’une image fixe et une prose concise ne peuvent pas communiquer aussi bien.
• Le titre visible nomme l’enregistrement spécifiquement, et le résumé explique sa valeur avant la lecture.
• La durée apparaît avant que le lecteur n’active le lecteur.
• L’image d’affiche est représentative, lisible, approuvée et exempte de contenu privé ou trompeur.
• La lecture ne démarre jamais automatiquement, ne boucle pas de manière inattendue et ne produit pas de son sans action du lecteur.
• Les commandes lecture, pause, recherche, volume, vitesse, sous-titres et plein écran fonctionnent au clavier et au toucher.
• Les sous-titres correspondent au montage final et préservent correctement les noms, chiffres, changements d’intervenant et sons significatifs.
• Les visuels significatifs non transmis par la parole reçoivent une description audio ou une version alternative équivalente.
• La transcription complète est du HTML sélectionnable, suit l’ordre de l’enregistrement et décrit les actions visuelles nécessaires.
• Les instructions écrites, avertissements, conditions, preuves et appels à l’action restent disponibles en dehors de la vidéo.
• Le chargement du fournisseur externe suit les règles de consentement applicables, et le fournisseur est identifié avant l’activation.
• Le lecteur, l’intitulé et la transcription restent une seule figure sémantique et ne sont pas interrompus par du contenu sans rapport.
• L’élément n’est pas imbriqué dans un tableau, une liste, un encadré, un onglet, un carrousel, un panneau d’accordéon ou un conteneur cliquable.
• L’enregistrement et la transcription fonctionnent à 200 % de zoom, aux largeurs étroites, en mouvement réduit et sans signification uniquement JavaScript.
• Les champs VideoObject correspondent à des métadonnées médias visibles, vérifiables et à l’enregistrement accessible.
• Le type d’article sélectionné apparaît dans postTypes, et le placement correspond au tableau ci-dessus.
• Le propriétaire du média, les droits, la date d’enregistrement et les conditions de révision ou de remplacement sont enregistrés.

FAQ

Chaque vidéo intégrée doit-elle avoir une transcription ?

Oui. Les sous-titres servent la lecture synchronisée ; la transcription sert la lecture, le balayage, la recherche, la traduction, la citation, l’accessibilité et l’extraction. Elle doit contenir le contenu significatif complet, y compris les actions visuelles que la parole n’explique pas.

L’image d’affiche peut-elle contenir le titre de la vidéo ?

Oui, mais les mêmes informations d’identification doivent également apparaître en texte HTML. Le texte de l’image d’affiche peut être illisible sur un petit écran, indisponible lorsque les images échouent et inaccessible aux logiciels qui n’interprètent pas les pixels.

Une vidéo intégrée doit-elle être lue automatiquement ?

Non. La lecture automatique consomme des données, interrompt la lecture, introduit du mouvement ou du son non sollicité et supprime le choix du lecteur quant au moment de s’engager. Démarrez uniquement après une activation explicite.

Les sous-titres et une transcription sont-ils la même chose ?

Non. Les sous-titres sont synchronisés avec la lecture et incluent les indices sonores pertinents. Une transcription est une alternative de lecture durable organisée selon la séquence de l’enregistrement et enrichie de descriptions nécessaires des visuels significatifs.

Une vidéo intégrée nécessite-t-elle un schéma VideoObject ?

Non. N’ajoutez VideoObject que lorsque des métadonnées visibles précises et un enregistrement stable le justifient. Un lecteur sans nom, description, image d’affiche, date de téléchargement, durée et URL média fiables ne doit pas générer de balisage incomplet ou inventé.