OffscreenCanvas nicht verfügbar? Fehlerbehebung nach Plattform und Umgebung

Symptom

Any3D zeigt die Meldung "Aktueller Browser unterstützt OffscreenCanvas nicht". OffscreenCanvas ist einer der drei Kernteile für den Worker-Pfad; ohne ihn können Prozesse wie Texturkompression, die WebGL2-Kodierung in einem Worker erfordern, nicht vollständig ablaufen.

OffscreenCanvas ermöglicht das Erstellen einer Canvas und das Abrufen eines WebGL-Kontexts in einem Web Worker, um GPU-Operationen im Hintergrund auszuführen, ohne die Seite zu blockieren.

Häufige Ursachen

Ursache	Typisches Szenario
Veralteter Browser/WebView	Chrome < 69, Safari < 16.4, alter Android WebView
Hardware-Beschleunigung deaktiviert	Energie Sparmodus oder Richtlinien auf Windows/macOS deaktivieren GPU
Unternehmensrichtlinien	GPO deaktiviert GPU, MDM schränkt Grafikfähigkeiten ein
Eingebetteter WebView	WeChat, Unternehmens-App, alter Electron-Shell
Netzwerkebene	Selten; meist Skriptladefehler, nicht das API selbst

Fehlerbehebung nach Plattform

Windows

1. Chrome / Edge: Einstellungen → System → "Hardware-Beschleunigung verwenden" aktivieren → Browser vollständig beenden und neu starten.
2. Grafiktreiber: Bei Laptops mit Dual-GPU stellen Sie sicher, dass der Browser die dedizierte GPU verwendet (NVIDIA Systemsteuerung / AMD Software).
3. Gruppenrichtlinien (GPO): Richtlinien wie "Hardware-Beschleunigung deaktivieren" führen dazu, dass die Erstellung des OffscreenCanvas WebGL-Kontexts fehlschlägt.
4. Remotedesktop (RDP): Einige RDP-Sitzungen schränken GPU-Fähigkeiten ein; lokaler Login zum Vergleichstest.

macOS

1. Safari 16.4+ oder aktuelle Chrome-Version.
2. Systemeinstellungen → Batterie → Energie Sparmodus kann GPU-Planung herabsetzen; Netzstecker verwenden und erneut versuchen.
3. Bildschirmzeit deaktiviert OffscreenCanvas normalerweise nicht direkt, aber bei MDM-Einschränkungen für Grafik-APIs kontaktieren Sie den IT-Support.

Linux

1. Stellen Sie sicher, dass Mesa/eigene Treiber funktionieren; testen Sie mit aktuellstem Chrome unter Wayland und X11.
2. Headless-Server-Remotedesktop benötigt virtuelle GPU (selten im persönlichen Bereich).

iOS / iPadOS

1. Safari wird mit dem System aktualisiert (ab iOS 16.4 ist OffscreenCanvas-Vollständigkeit verbessert).
2. WebView in Apps kann hinter System-Safari zurückbleiben → Öffnen Sie den Link in Safari.
3. Schul-iPads im Überwachungsmodus behalten möglicherweise alte Systeme; Aktualisierung durch Administrator erforderlich.

Android

1. Aktualisieren Sie Chrome und Android System WebView.
2. Inlandsbrowser-Kompatibilitätskerne unterstützen es nicht → Wechseln zu Blitzmodus oder verwenden Sie Chrome.
3. Bei Low-End-Geräten veraltete GPU-Treiber: Versuchen Sie, "Energiesparmodus" zu deaktivieren.

Netzwerk, VPN und Unternehmensumgebung

OffscreenCanvas ist eine lokale API und wird normalerweise nicht direkt durch VPN beeinflusst. Wenn das VPN jedoch den Browser in "abgesicherten Modus" versetzt oder Unternehmens-Erweiterungs-Skripte lädt, kann es indirekt fehlschlagen:

• Trennen Sie das VPN zum Vergleich;
• Prüfen Sie, ob der Unternehmensbrowser "Software-Rendering" erzwingt;
• Bei iframe-Einbettung stellen Sie sicher, dass die äußere Ebene die Worker-WebGL nicht blockiert.

Elternkontrolle und verwaltete Geräte

• Family Link / Bildschirmzeit: Deaktivieren Sie OffscreenCanvas selten direkt; üblicherweise wird das Installieren von Browser-Updates verhindert, wodurch die API veraltet – erlauben Sie automatische Systemaktualisierungen.
• Prüfungs-/Bibliotheksmodus: Kann spezielle Browser verwenden; verwenden Sie ein persönliches Gerät.

Schrittweise Behebung (allgemein)

1. Aktualisieren Sie den Browser auf die in der obigen Tabelle angegebenen Mindestversion oder höher.
2. Aktivieren Sie Hardware-Beschleunigung und starten Sie den Browser neu.
3. Öffnen Sie mit dem Systembrowser, nicht mit dem WebView einer App.
4. Wenn gleichzeitig WebGL2-Fehler auftreten, behandeln Sie zuerst die WebGL2-Fehlerbehebungsanleitung.

Schneller Selbsttest

typeof OffscreenCanvas !== "undefined"

Gibt false zurück, bedeutet dies, dass die aktuelle Umgebung diese API nicht unterstützt.

Zusammenfassung

Fehlende OffscreenCanvas tritt am häufigsten bei veralteten Browsern/WebView, deaktivierter Hardware-Beschleunigung, Windows-Remotedesktop oder Unternehmens-GPU-Richtlinien auf. Aktivieren Sie die GPU-Beschleunigung je nach Plattform, aktualisieren Sie den WebView oder wechseln Sie zum Systembrowser, um die GPU-Kodierungsfähigkeit im Worker wiederherzustellen.