EPUBCheck · Images, audio et superpositions multimédias

EPUBCheck MED_010 : pas d'attribut de superposition multimédia

Mis à jour : 4 novembre 2026

EPUBCheck MED_010 est un message d'erreur : “EPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.” Un document de contenu est utilisé par un media overlay, mais son élément de manifeste n'a pas d'attribut media-overlay. L'attribut est ce que l'application de lecture utilise pour trouver la narration d'un chapitre, donc sans lui, le son n'est jamais joué.

Le message officiel

EPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.

Gravité par défaut: Erreur. Le EPUB enfreint une règle de la spécification et est invalide. Les magasins et l'envoi à Kindle peuvent le rejeter, et EPUBCheck sort avec le statut 1.
version EPUBCheck: 5.4.0

EPUBCheck imprime cet ID avec un soulignement au lieu d'un tiret ; cette page utilise l'ID tel que EPUBCheck le rapporte.

Causes typiques

Un fichier SMIL ajouté au livre sans mettre à jour l'élément manifeste du chapitre qu'il narre.
Un manifeste régénéré par un outil qui a supprimé l'attribut.

Comment le corriger

Dans le document de package, trouvez l'élément manifeste des chapitres nommés EPUBCheck.
Ajoutez media-overlay="..." avec l'id de l'élément de manifeste de son fichier SMIL, par exemple <item id="ch1" href="ch1.xhtml" media-type="application/xhtml+xml" media-overlay="ch1_audio"/>.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si l'attribut est présent mais désigne une superposition différente, l'erreur est MED_012.

Termes utilisés ici

Autres messages MED

MED-009 The time specified in the clipBegin attribute must not be the same as clipEnd.
MED_011 EPUB Content Document referenced from multiple Media Overlay Documents.
MED-008 The time specified in the clipBegin attribute must not be after clipEnd.
MED_012 The "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.
MED_007 Picture "source" elements must define a "type" attribute when they reference foreign resources; found resource "…" of type "…".
MED_013 Media Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.

Sources

EPUB 3.3, §9.3.5.1 Including media overlays · lire 4 novembre 2026

Texte et gravité du message de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explication par EpubCC.

FAQ

Que signifie EPUBCheck MED_010 ?

Est-ce que MED_010 une erreur ?

MED_010 est signalé comme erreur par défaut. Le EPUB enfreint une règle de la spécification et est invalide. Les magasins et l'envoi à Kindle peuvent le rejeter, et EPUBCheck sort avec le statut 1.