Kris

createImageBitmap nicht verfügbar? Fehlerbehebung nach Plattform und Umgebung

FehlerbehebungBrowser-KompatibilitätcreateImageBitmap

Das Symptom, das Sie sehen

Any3D zeigt die Meldung „Der aktuelle Browser unterstützt createImageBitmap nicht". Dies ist einer der drei Bestandteile des Worker-Pfads, der für die effiziente Dekodierung von Bildpixeln im Hintergrund verwendet wird. Fehlt diese Funktion, können Prozesse wie Texturkomprimierung oder Bild-zu-Modell nicht vollständig über den Worker-Pfad ablaufen, und große Dateien neigen eher zu Verzögerungen.

Häufige Ursachen

UrsacheTypisches Szenario
Veralteter Browser/WebViewAlte Android WebView, eingebettete Seiten in Apps
Unsicherer KontextHTTP-Seiten (außer localhost), file://
Cross-Origin-Ressourcen falschUnternehmens-CDN/CORS führt zu Bilddecodierungsfehlern (Funktionsstörungen)
Speicher-/Tab-EinschränkungenGeräte mit wenig Arbeitsspeicher, „Single-Tab"-Richtlinien
ErweiterungsstörungenDatenschutz-Plugins verändern das Image-API-Verhalten

Fehlerbehebung nach Plattform

Windows / macOS (Desktop)

  1. Verwenden Sie die aktuelle stabile Version von Chrome / Edge / Firefox / Safari.
  2. Öffnen Sie Any3D zwingend über HTTPS.
  3. Bildschirmzeit auf macOS oder Microsoft Family Safety auf Windows können bei Einschränkungen von Downloads oder Medienzugriff die Dekodierung großer Bilder beeinträchtigen – testen Sie mit einem Administratorkonto.
  4. Remote Desktop: Bei sehr hochauflösenden Texturen kann die Dekodierung auf schwacher GPU fehlschlagen – testen Sie zunächst mit kleinen Bildern.

Linux

  1. Aktualisieren Sie Chrome/Firefox; unter Wayland kann bei GPU-Dekodierungsproblemen ein Wechsel zur X11-Sitzung helfen (selten).

iOS / iPadOS

  1. Safari 14+ bietet gute Unterstützung; halten Sie iOS auf dem neuesten Stand.
  2. Der eingebaute Browser von WeChat (WebView) hinkt oft hinterher → Safari verwenden.
  3. iCloud Private Relay / Einschränkung für Erwachseneninhalte blockieren createImageBitmap in der Regel nicht, können aber Cross-Origin-Bildhosting stören – stellen Sie sicher, dass Modell-Texturen vom gleichen Ursprung stammen oder zugänglich sind.

Android

  1. Aktualisieren Sie Chrome und Android System WebView (Einstellungen → Apps → System-Apps anzeigen).
  2. Bei Kompatibilitätsmodus in manchen chinesischen Browsern → zu Chrome wechseln.
  3. Digitale Gesundheit / Family Link schränken Hintergrundaktivitäten nicht direkt ein, können aber das Hochladen großer Dateien behindern.

Netzwerk, VPN und Unternehmensnetzwerk

SzenarioBeschreibung
Firmen-VPNWenn Modell-Texturen über das interne CDN geladen werden, führen CORS- oder Zertifikatsfehler zu Dekodierungsfehlern – in der Konsole erscheinen Netzwerkfehler
Transparent ProxyWenn die Bildantwort verändert oder beschädigt wird, kann createImageBitmap mit „reject" antworten
Nur HTTP im IntranetKein secure context, API möglicherweise nicht verfügbar oder eingeschränkt
Zero Trust / SSL InspectionSelbstsignierte Zertifikate müssen vertrauenswürdig sein, sonst laden Ressourcen nicht

Empfehlung: VPN trennen, auf Hotspot wechseln, ein reines Geometrie-Modell ohne externe Texturen hochladen – funktioniert das Geometrie-Modell, während das mit Texturen fehlschlägt, liegt das Problem am Netzwerk/CORS.

Unternehmensrichtlinien und Kindersicherung

  • Intune App Protection kann „Speichern unter/Download" einschränken und damit indirekt den Dateiauswahlprozess beeinflussen, die API selbst sollte aber vorhanden sein – testen Sie mit der Konsole, um zu unterscheiden.
  • iPad-Verwaltung in Schulen: Wenn die „Dateien"-App gesperrt ist, ist die API nicht betroffen, aber die Upload-Methode – nutzen Sie alternative Upload-Kanäle.
  • DNS-Kindersicherung auf dem Router: Wenn die Any3D-Domain blockiert wird, ist die gesamte Seite nicht erreichbar, nicht nur createImageBitmap.

Schrittweise Reparatur (allgemein)

  1. HTTPS + aktueller Browser + Neustart.
  2. Inkognito-Fenster (Erweiterungen ausschließen).
  3. Systembrowser verwenden, nicht App-WebView.
  4. Gleichzeitig prüfen, ob auch Web Worker und OffscreenCanvas Warnungen anzeigen.

Schnelltest

typeof createImageBitmap !== "undefined";

Fortgeschritten (benötigt HTTPS und eine erreichbare Bild-URL):

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

Zusammenfassung

Probleme mit createImageBitmap sind meist auf alte WebViews, fehlendes HTTPS, VPN/Intranet-Netzwerkprobleme zurückzuführen. Aktualisieren Sie die WebView, wechseln Sie das Netzwerk und schließen Sie Erweiterungen aus – dann ist der Worker-Bildverarbeitungspfad in der Regel wiederhergestellt.

Unterstützen Sie uns