createImageBitmap nicht verfügbar? Fehlerbehebung je Plattform
Wenn Any3D createImageBitmap nicht unterstützt, prüfen Sie Plattform, HTTPS, Unternehmensrichtlinien und WebView-Grenzen. So kehrt der Worker-Bildpfad zurück.
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
| Ursache | Typisches Szenario |
|---|---|
| Veralteter Browser/WebView | Alte Android WebView, eingebettete Seiten in Apps |
| Unsicherer Kontext | HTTP-Seiten (außer localhost), file:// |
| Cross-Origin-Ressourcen falsch | Unternehmens-CDN/CORS führt zu Bilddecodierungsfehlern (Funktionsstörungen) |
| Speicher-/Tab-Einschränkungen | Geräte mit wenig Arbeitsspeicher, „Single-Tab"-Richtlinien |
| Erweiterungsstörungen | Datenschutz-Plugins verändern das Image-API-Verhalten |
Fehlerbehebung nach Plattform
Windows / macOS (Desktop)
- Verwenden Sie die aktuelle stabile Version von Chrome / Edge / Firefox / Safari.
- Öffnen Sie Any3D zwingend über HTTPS.
- 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.
- Remote Desktop: Bei sehr hochauflösenden Texturen kann die Dekodierung auf schwacher GPU fehlschlagen – testen Sie zunächst mit kleinen Bildern.
Linux
- Aktualisieren Sie Chrome/Firefox; unter Wayland kann bei GPU-Dekodierungsproblemen ein Wechsel zur X11-Sitzung helfen (selten).
iOS / iPadOS
- Safari 14+ bietet gute Unterstützung; halten Sie iOS auf dem neuesten Stand.
- Der eingebaute Browser von WeChat (WebView) hinkt oft hinterher → Safari verwenden.
- 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
- Aktualisieren Sie Chrome und Android System WebView (Einstellungen → Apps → System-Apps anzeigen).
- Bei Kompatibilitätsmodus in manchen chinesischen Browsern → zu Chrome wechseln.
- Digitale Gesundheit / Family Link schränken Hintergrundaktivitäten nicht direkt ein, können aber das Hochladen großer Dateien behindern.
Netzwerk, VPN und Unternehmensnetzwerk
| Szenario | Beschreibung |
|---|---|
| Firmen-VPN | Wenn Modell-Texturen über das interne CDN geladen werden, führen CORS- oder Zertifikatsfehler zu Dekodierungsfehlern – in der Konsole erscheinen Netzwerkfehler |
| Transparent Proxy | Wenn die Bildantwort verändert oder beschädigt wird, kann createImageBitmap mit „reject" antworten |
| Nur HTTP im Intranet | Kein secure context, API möglicherweise nicht verfügbar oder eingeschränkt |
| Zero Trust / SSL Inspection | Selbstsignierte 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)
- HTTPS + aktueller Browser + Neustart.
- Inkognito-Fenster (Erweiterungen ausschließen).
- Systembrowser verwenden, nicht App-WebView.
- 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.