¿createImageBitmap no disponible? Diagnóstico por plataforma y entorno

Lo que estás viendo

Any3D muestra «El navegador no soporta createImageBitmap en este momento». Esta API es una de las tres piezas que forman la ruta Worker y se usa para decodificar los píxeles de una imagen en segundo plano de forma eficiente. Si falta, procesos como la compresión de texturas o la conversión de imagen a modelo no pueden completar toda la ruta Worker, y los archivos grandes suelen ir más lentos o acaban bloqueándose.

Causas habituales

Causa	Situación típica
Navegador / WebView demasiado antiguo	WebView antiguo en Android, páginas embebidas en una app
Contexto no seguro	Sitios por HTTP (excepto localhost), orígenes file://
Recursos cross-origin mal configurados	CDN / CORS de empresa que impiden decodificar imágenes (fallo sutil)
Límites de memoria / pestañas	Móviles con poca RAM, política de «pestaña única» en entornos de empresa
Interferencia de extensiones	Extensiones de privacidad que alteran el comportamiento de Image APIs

Diagnóstico por plataforma

Windows / macOS (escritorio)

1. Usa la última versión estable de Chrome, Edge, Firefox o Safari.
2. Abre Any3D siempre a través de HTTPS.
3. Tiempo en pantalla (macOS) y Seguridad familiar de Windows pueden restringir descargas o el acceso a contenido multimedia y afectar a la decodificación de imágenes grandes; prueba con una cuenta de administrador.
4. Escritorio remoto: con texturas de resolución muy alta y una GPU limitada, la decodificación puede fallar; para verificar, usa primero una imagen pequeña.

Linux

1. Actualiza Chrome o Firefox. En Wayland, si la decodificación por GPU falla, puedes probar con una sesión X11 para comparar (es poco frecuente).

iOS / iPadOS

1. Desde Safari 14 hay buen soporte; mantén el sistema actualizado.
2. El navegador integrado en apps de mensajería como WhatsApp o Telegram suele ir por detrás en actualizaciones → ábrelo en Safari.
3. La Retransmisión privada de iCloud o las restricciones de contenido para adultos no suelen bloquear createImageBitmap, pero sí pueden bloquear imágenes alojadas en otros dominios; asegúrate de que las texturas del modelo sean del mismo origen o estén accesibles.

Android

1. Actualiza Chrome y Android System WebView (Ajustes → Aplicaciones → Mostrar aplicaciones del sistema).
2. Los navegadores preinstalados de algunos fabricantes con modo compatibilidad → mejor usa Chrome.
3. Bienestar digital o Family Link no afectan directamente a esta API al restringir la actividad en segundo plano, pero pueden impedir la subida de archivos grandes.

Red, VPN y red interna corporativa

Escenario	Descripción
VPN corporativa	Si las texturas del modelo se sirven desde una CDN interna, los errores de CORS o de certificado pueden impedir la decodificación; revisa la consola en busca de errores de red
Proxy transparente	Si modifica o corrompe las respuestas de imagen, createImageBitmap puede rechazarlas
Solo HTTP interno	Contexto no seguro → la API puede no estar disponible o su comportamiento puede quedar limitado
Zero Trust / inspección SSL	Los certificados autofirmados deben ser de confianza; de lo contrario, la carga de recursos falla

Recomendación: desconecta la VPN, cambia a un punto de acceso móvil y prueba con un modelo de geometría pura (sin texturas externas). Si la geometría pura funciona pero los modelos con texturas fallan, investiga primero la red o el CORS.

Políticas empresariales y control parental

• Intune App Protection puede restringir «Guardar como» o la descarga, lo que afecta indirectamente al flujo de selección de imágenes, pero la API en sí debería seguir existiendo: usa la consola para distinguirlo.
• iPad gestionados por el centro escolar: desactivar la app «Archivos» no afecta a la API, pero cambia la forma de subir archivos; usa un canal de subida alternativo.
• DNS de control parental del router: si bloquea el dominio de Any3D, todo el sitio deja de estar disponible, no solo createImageBitmap.

Solución paso a paso (general)

1. HTTPS + navegador actualizado + reiniciar.
2. Ventana de incógnito para descartar extensiones.
3. Abre en el navegador del sistema, no en un WebView integrado en una app.
4. Comprueba también si Web Worker y OffscreenCanvas aparecen marcados.

Autocomprobación rápida

typeof createImageBitmap !== "undefined";

Avanzado (requiere HTTPS y una URL de imagen accesible):

fetch("https://example.com/favicon.ico")
  .then((r) => r.blob())
  .then((b) => createImageBitmap(b))
  .then(() => console.log("ok"))
  .catch(console.error);

Resumen

Los problemas con createImageBitmap se deben sobre todo a WebView antiguos, la falta de HTTPS o fallos al cargar recursos por VPN o red interna. Actualiza el WebView de tu plataforma, prueba con otra red y descarta las extensiones para recuperar la ruta de imagen del Worker.