EPUBCheck · Bilder, Audio und Medienüberlagerungen

EPUBCheck MED_010: kein Medienoverlay-Attribut

Aktualisiert: 4. November 2026

EPUBCheck MED_010 ist eine Fehlermeldung: „EPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.“ Ein Inhaltsdokument wird von einem Medienoverlay verwendet, aber sein Manifest-Element hat kein media-overlay-Attribut. Das Attribut ist, wie die Lese-App die Erzählung für ein Kapitel findet, sodass ohne es der Ton niemals abgespielt wird.

Die offizielle Nachricht

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

Standard-Schweregrad: Fehler. Das EPUB bricht eine Regel der Spezifikation und ist ungültig. Geschäfte und Sende an Kindle könnten es ablehnen, und EPUBCheck beendet die Ausführung mit Status 1.
EPUBCheck Version: 5.4.0

EPUBCheck druckt diese ID mit einem Unterstrich anstelle eines Bindestrichs; diese Seite verwendet die ID genau so, wie EPUBCheck sie berichtet.

Typische Ursachen

Eine SMIL-Datei, die dem Buch hinzugefügt wurde, ohne das Manifest-Element des Kapitels zu aktualisieren, das sie erzählt.
Ein Manifest, das von einem Tool regeneriert wurde, das das Attribut entfernt hat.

Wie man es behebt

Im Paketdokument das Manifest-Element des Kapitels EPUBCheck-Namen finden.
Fügen Sie media-overlay="..." mit der ID des Manifest-Elements seiner SMIL-Datei hinzu, zum Beispiel <item id="ch1" href="ch1.xhtml" media-type="application/xhtml+xml" media-overlay="ch1_audio"/>.
Rebuild den EPUB und führe EPUBCheck erneut aus, um zu bestätigen, dass die Nachricht verschwunden ist.

Wann es nicht das ist

Wenn das Attribut vorhanden ist, aber ein anderes Overlay benennt, ist der Fehler MED_012.

Hier verwendete Begriffe

Andere MED Nachrichten

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.

Quellen

EPUB 3.3, §9.3.5.1 Including media overlays · lesen 4. November 2026

Nachrichtentext und Schweregrad von EPUBCheck 5.4.0 (W3C, BSD-3-Klausel). Erklärung durch EpubCC.

FAQ

Was bedeutet EPUBCheck MED_010?

Ist MED_010 ein Fehler?

MED_010 wird standardmäßig als Fehler gemeldet. Das EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Stores und Sende an Kindle könnten es ablehnen, und EPUBCheck beendet sich mit Status 1.