Any3DAny3D
·Any3D Team

¿createImageBitmap no disponible? Solución por plataforma y entorno

troubleshootingbrowser-compatibilitycreateimagebitmap

Síntoma observado

Any3D muestra «El navegador actual no soporta createImageBitmap». Esta es una de las tres piezas clave de la ruta Worker, utilizada para decodificar píxeles de imagen en segundo plano de forma eficiente. Sin ella, flujos como la compresión de texturas o la conversión de imágenes a modelos no pueden completar la ruta Worker completa, lo que puede causar bloqueos con archivos grandes.

Causas comunes

CausaEscenario típico
Navegador/WebView obsoletoWebView antiguo de Android, páginas integradas en apps
Contexto no seguroSitios HTTP (no localhost), file://
Recursos cross-origin mal configuradosCDN/CORS empresariales que fallan al decodificar imágenes (se manifiesta como comportamiento anómalo)
Limitaciones de memoria/pestañasDispositivos móviles con poca memoria, políticas empresariales de «una sola pestaña»
Interferencia de extensionesPlugins de privacidad que modifican el comportamiento de la API Image

Diagnóstico por plataforma

Windows / macOS (escritorio)

  1. Usa la última versión estable de Chrome / Edge / Firefox / Safari.
  2. Debes acceder a Any3D a través de HTTPS.
  3. Si Tiempo de pantalla de macOS o Seguridad familiar de Windows restringen descargas o acceso a medios, puede afectar la decodificación de imágenes grandes: prueba con una cuenta de administrador.
  4. Escritorio remoto: Texturas de resolución muy alta pueden fallar al decodificar en entornos con GPU débil; valida primero con una imagen pequeña.

Linux

  1. Actualiza Chrome/Firefox; si la decodificación por GPU falla bajo Wayland, prueba con una sesión de X11 para comparar (poco frecuente).

iOS / iPadOS

  1. Safari 14+ ofrece buen soporte; mantén iOS actualizado.
  2. El navegador integrado de WeChat suele tener un motor desactualizado → abre en Safari.
  3. Proxy dedicado de iCloud / Restricción de contenido para adultos generalmente no bloquea createImageBitmap, pero sí puede bloquear servidores de imágenes cross-origin: asegúrate de que las texturas del modelo sean del mismo origen o accesibles.

Android

  1. Actualiza Chrome y Android System WebView (Ajustes → Aplicaciones → Mostrar aplicaciones del sistema).
  2. Si el navegador nacional usa modo de compatibilidad → cambia a Chrome.
  3. Bienestar digital / Family Link al restringir actividades en segundo plano no afecta directamente la API, pero puede impedir la subida de archivos grandes.

Red, VPN e intranet empresarial

EscenarioDescripción
VPN de empresaSi las texturas del modelo usan una CDN interna, errores de CORS o certificados causan fallos en la decodificación: aparecerán errores de red en la Consola
Proxy transparenteSi reemplaza o daña las respuestas de imágenes, createImageBitmap puede rechazar la operación
Intranet solo HTTPNo es un contexto seguro; la API puede no estar disponible o tener comportamiento restringido
Zero Trust / Inspección SSLLos certificados autofirmados deben importarse en el almacén de confianza, de lo contrario los recursos no se cargarán

Recomendación: Desconéctate de la VPN, cambia a un hotspot y sube un modelo geométrico puro sin texturas externas para probar: si el modelo puro funciona pero el que usa texturas falla, investiga primero la red/CORS.

Políticas empresariales y controles parentales

  • Intune App Protection puede restringir «Guardar como/Descargar», afectando indirectamente el flujo de selección de imágenes del usuario, pero la API en sí debería existir: usa la Consola para diferenciar.
  • Supervisión escolar de iPad: Al prohibir la «App Archivos» no afecta la API, pero sí el método de subida; usa un canal de subida compatible.
  • Control parental DNS en router: Si bloquea el dominio de Any3D, todo el sitio queda inaccesible, no solo createImageBitmap.

Corrección paso a paso (general)

  1. HTTPS + navegador actualizado + reinicio.
  2. Ventana incógnita para descartar extensiones.
  3. Abre con el navegador del sistema, no con WebView de la app.
  4. Verifica simultáneamente si Web Worker y OffscreenCanvas también muestran advertencias.

Prueba rápida

typeof createImageBitmap !== "undefined"

Avanzada (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 suelen deberse a WebView obsoleto, falta de HTTPS, o VPN/intranet que impiden la carga de recursos. Actualiza el WebView según la plataforma, verifica la red y descarta extensiones; la ruta de imágenes en Worker debería restaurarse.

Apóyanos