EPUBCheck · Obrazy, dźwięk i nakładki multimedialne

EPUBCheck MED_010: brak atrybutu media-overlay

Zaktualizowane: 4 listopada 2026

EPUBCheck MED_010 to komunikat o błędzie: „EPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.” Dokument treści jest używany przez nakładkę multimedialną, ale jego element manifestu nie ma atrybutu media-overlay. Atrybut to sposób, w jaki aplikacja do czytania znajduje narrację dla rozdziału, więc bez niego audio nigdy nie jest odtwarzane.

Oficjalna wiadomość

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

Domyślna powaga: Błąd. EPUB łamie zasady specyfikacji i jest nieprawidłowy. Sklepy i Wysłanie do Kindle mogą go odrzucić, a EPUBCheck kończy działanie ze statusem 1.
Wersja EPUBCheck: 5.4.0

EPUBCheck drukuje ten identyfikator z podkreśleniem zamiast myślnika; ta strona używa identyfikatora dokładnie tak, jak EPUBCheck go raportuje.

Typowe przyczyny

Plik SMIL dodany do książki bez aktualizacji elementu manifestu rozdziału, który narruje.
Manifest regenerowany przez narzędzie, które usunęło atrybut.

Jak to naprawić

W dokumencie pakietowym znajdź element manifestu nazw rozdziałów EPUBCheck.
Dodaj media-overlay="..." z identyfikatorem elementu manifestu jego pliku SMIL, na przykład <item id="ch1" href="ch1.xhtml" media-type="application/xhtml+xml" media-overlay="ch1_audio"/>.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli atrybut jest obecny, ale odnosi się do innego nakładki, błąd to MED_012.

Terminy używane tutaj

Inne komunikaty 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.

Źródła

EPUB 3.3, §9.3.5.1 Including media overlays · czytaj 4 listopada 2026

Tekst wiadomości i poważność z EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Wyjaśnienie przez EpubCC.

FAQ

Co oznacza EPUBCheck MED_010?

Czy MED_010 to błąd?

MED_010 jest zgłaszane jako błąd domyślnie. EPUB łamie zasady specyfikacji i jest nieważny. Sklepy i Wyślij do Kindle mogą go odrzucić, a EPUBCheck kończy z kodem 1.