Accesibilidad

En un PNG o un JPG el texto son píxeles: TalkBack, VoiceOver o Narrador no pueden leerlo. En un .oim cada capa de texto viaja como texto real, en todos sus idiomas, dentro del archivo firmado. <oim-player> lo aprovecha para que un lector de pantalla pueda leer la obra, sin trabajo extra en la mayoría de las capas.

Qué oye un lector de pantalla

1. La obra, anunciada como figura. Su nombre es la description del documento en el idioma activo; si no hay, el primer texto; si no hay ningún texto, «Imagen».
2. Los textos, en orden de lectura visual: de arriba abajo y luego de izquierda a derecha (capas a menos de 8 px en vertical cuentan como una misma fila). Cada uno en el idioma activo y con su lang, para que la voz cambie con él.
3. Las imágenes descritas (capas image y svg con alt), en su sitio dentro de ese orden.
4. Las capas interactivas con acciones activas, como botones con el nombre de su texto o su alt, accesibles con el teclado (Intro o Espacio hacen lo mismo que un clic).

Se saltan: las capas marcadas decorative, las imágenes sin descripción, la imagen base aplanada y las pistas duplicadas de una escena en bucle.

La capa de lectura se construye una vez al cargar la obra y otra al cambiar de idioma. No cuesta nada por fotograma.

Describir una obra

Campo	Dónde	Tipo	Significado
alt	style de la capa	{ [idioma]: string }, hasta 300 caracteres cada uno	Qué muestra la imagen
decorative	style de la capa	boolean	El lector la salta; gana sobre alt
description	raíz del documento	{ [idioma]: string }, hasta 1000 caracteres cada uno	Resumen de la obra

• Si falta el idioma en alt, se usa el idioma principal del documento; si también falta, la imagen se salta.
• Una descripción en blanco cuenta como ninguna.
• Los tres van dentro de la firma: cambiarlos la rompe, como cualquier otro campo.
• Son texto plano. El player los escribe con textContent/setAttribute, nunca como HTML.

Los textos no necesitan nada: se leen tal cual.

En OIM Studio y en el MCP

• Studio: selecciona una imagen o un SVG → Accesibilidad: una descripción por idioma y la casilla Decorativa. Hay un aviso mientras una imagen no tenga ninguna de las dos. La descripción de la obra se escribe en el diálogo de exportación.
• MCP: alt y decorative se aceptan al crear o editar capas; las herramientas devuelven accessibility: [{ id, mensaje }] para las imágenes que se queden sin ninguna.

Añadido en el contrato 1.16.0. Los archivos anteriores se leen igual, salvo las descripciones que no tienen.