createImageBitmap Tidak Tersedia? Panduan Pemecahan Masalah Berdasarkan Platform & Lingkungan

Pesan yang Muncul

Any3D menampilkan pesan: "Browser Anda tidak mendukung createImageBitmap." Ini adalah salah satu dari tiga komponen utama jalur Web Worker yang digunakan untuk mendekode piksel gambar secara efisien di latar belakang. Tanpa API ini, alur kerja seperti kompresi tekstur dan konversi gambar ke model 3D tidak dapat menggunakan jalur Worker secara penuh, dan pemrosesan file besar berisiko mengalami lag.

Penyebab Umum

Penyebab	Skenario Tipikal
Browser / WebView lawas	Android WebView versi lama, halaman embedded di dalam aplikasi
Konteks tidak aman	Situs HTTP non-enkripsi (selain localhost), protokol file://
Masalah resource lintas domain	Kebijakan CDN/CORS perusahaan yang memblokir dekode gambar
Batasan memori / tab	Ponsel dengan RAM terbatas, kebijakan enterprise pembatas tab
Interferensi ekstensi	Plugin privasi yang memodifikasi perilaku Image API

Panduan Perbaikan Berdasarkan Platform

Windows / macOS (Desktop)

1. Gunakan versi stabil terbaru dari Chrome, Edge, Firefox, atau Safari.
2. Selalu akses Any3D melalui protokol aman HTTPS.
3. Jika Anda mengaktifkan Screen Time (macOS) atau Microsoft Family Safety (Windows), fitur tersebut mungkin membatasi unduhan atau akses media. Coba uji dengan akun administrator lain.
4. Remote Desktop: Dekode tekstur beresolusi sangat tinggi dapat gagal pada lingkungan GPU virtual yang lemah. Uji terlebih dahulu dengan model atau gambar kecil.

Linux

1. Perbarui Chrome atau Firefox ke versi terbaru. Pada lingkungan Wayland, jika dekode GPU bermasalah, coba gunakan sesi X11.

iOS / iPadOS

1. Safari 14+ mendukung API ini secara penuh; pastikan iOS selalu diperbarui.
2. Browser di dalam aplikasi (misalnya Facebook Messenger atau Gmail) sering kali tertinggal: pilih opsi Buka di Safari.
3. Fitur iCloud Private Relay umumnya tidak memblokir createImageBitmap, tetapi dapat memblokir host tekstur eksternal. Pastikan tekstur model dapat diakses.

Android

1. Perbarui Chrome dan Android System WebView melalui Google Play Store (Pengaturan → Aplikasi → Tampilkan aplikasi sistem).
2. Jika menggunakan browser lokal dalam mode kompatibilitas lama, beralihlah ke Google Chrome standar.
3. Pembatasan latar belakang pada Digital Wellbeing / Family Link tidak mematikan API secara langsung, tetapi dapat menghambat pengunggahan file besar.

Jaringan, VPN, dan Intranet Perusahaan

Skenario	Penjelasan
VPN Perusahaan	Jika tekstur model dimuat dari CDN internal, kesalahan CORS atau sertifikat dapat menggagalkan dekode; periksa Console untuk log error
Transparent Proxy	Jika proxy memodifikasi respons gambar, createImageBitmap dapat menolak pemrosesan
HTTP Internal	Konteks tidak aman dapat menonaktifkan API atau membatasi fiturnya
Inspeksi SSL / Zero Trust	Sertifikat self-signed wajib di-trust oleh sistem agar pemuatan resource berhasil

Rekomendasi: Putuskan sambungan VPN, beralihlah ke hotspot ponsel, dan uji dengan model geometri murni tanpa tekstur luar. Jika model tanpa tekstur berhasil namun model bertekstur gagal, periksa masalah jaringan dan CORS terlebih dahulu.

Kebijakan Perusahaan dan Parental Control

• Kebijakan Intune App Protection dapat membatasi operasi simpan dan unduh yang memengaruhi pemilihan gambar, namun API itu sendiri tetap ada (gunakan Console untuk membedakannya).
• iPad Sekolah Terkelola: Penonaktifan aplikasi Files tidak memengaruhi API, melainkan hanya metode pengunggahan.
• DNS Parental Control Router: Jika router memblokir domain Any3D, seluruh situs tidak akan bisa dibuka.

Langkah Perbaikan Bertahap (Umum)

1. Pastikan koneksi HTTPS, gunakan browser versi terbaru, dan lakukan restart.
2. Buka tab Incognito untuk menonaktifkan gangguan ekstensi browser.
3. Buka halaman di browser sistem utama, bukan melalui WebView dalam aplikasi media sosial.
4. Periksa juga apakah status Web Worker dan OffscreenCanvas mengalami kendala serupa.

Uji Diagnostik Mandiri

Buka Console di Developer Tools browser dan jalankan:

typeof createImageBitmap !== "undefined";

Jika bernilai true, API didukung. Untuk pengujian lanjutan dengan gambar nyata melalui HTTPS:

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

Ringkasan

Kendala createImageBitmap paling sering dipicu oleh WebView usang, ketiadaan HTTPS, atau pemblokiran resource oleh jaringan VPN/intranet. Perbarui WebView di perangkat Anda, coba jaringan alternatif, dan nonaktifkan ekstensi yang berbenturan untuk memulihkan performa penuh Worker.