EPUBCheck · Imágenes, audio y superposiciones de medios

EPUBCheck MED_012: desajuste de id de media-overlay

Actualizado: 4 de noviembre de 2026

EPUBCheck MED_012 es un mensaje de error: “The "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.” El atributo media-overlay de un capítulo nombra una superposición diferente de la que lo refiere. El archivo SMIL que narra un capítulo y el elemento de manifiesto del capítulo deben apuntar entre sí.

El mensaje oficial

The "media-overlay" attribute does not match the ID of the Media Overlay that refers to this document.

Severidad por defecto: Error. El EPUB rompe una regla de la especificación y es inválido. Las tiendas y el envío a Kindle pueden rechazarlo, y EPUBCheck sale con estado 1.
versión de EPUBCheck: 5.4.0

EPUBCheck imprime este ID con un guion bajo en lugar de un guion; esta página utiliza el ID exactamente como lo informa EPUBCheck.

Causas típicas

IDs de superposición renombrados o intercambiados en el manifiesto.
Un capítulo copiado con su elemento de manifiesto, manteniendo el valor de media-overlay del original.

Cómo arreglarlo

Encuentra el archivo SMIL cuyos elementos de texto apuntan a los nombres de capítulo EPUBCheck.
Establece el atributo media-overlay del capítulo al id del manifiesto de ese archivo SMIL.
Verifica los otros capítulos de la misma manera: estos errores suelen venir en grupos.
Reconstruye el EPUB y ejecuta EPUBCheck nuevamente para confirmar que el mensaje ha desaparecido.

Cuándo no es esto

Si el atributo falta por completo, el error es MED_010.

Términos usados aquí

Otros mensajes de MED

MED_011 EPUB Content Document referenced from multiple Media Overlay Documents.
MED_013 Media Overlay Document referenced from the "media-overlay" attribute does not contain a reference to this Content Document.
MED_010 EPUB Content Documents referenced from a Media Overlay must specify the "media-overlay" attribute.
MED_014 Media overlay audio file URLs must not have a fragment, but found '#…'.
MED-009 The time specified in the clipBegin attribute must not be the same as clipEnd.
MED_015 Media overlay text references must be in reading order. Text target "…" is before the previous link target in … order.

Fuentes

EPUB 3.3, §9.3.5.1 Including media overlays · leer 4 de noviembre de 2026

Texto y severidad del mensaje de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicación por EpubCC.

FAQ

¿Qué significa EPUBCheck MED_012?

¿Es MED_012 un error?

MED_012 se informa como error por defecto. El EPUB rompe una regla de la especificación y es inválido. Las tiendas y Enviar a Kindle pueden rechazarlo, y EPUBCheck sale con estado 1.