SEBELUM ANDA MENGIRIM

Kompresi GLB dan kompatibilitas penampil

Ekstensi file GLB tidak menjamin bahwa setiap aplikasi dapat memuat kontennya. Periksa ekstensi yang digunakan oleh keluaran dan uji tujuan Anda.

Cocokkan pengaturan dengan loader Anda

PengaturanPersyaratan pemuatan
KonservatifDukungan kuantisasi geometri; transformasi tekstur juga dapat digunakan.
Standar/tinggi MeshoptEXT_meshopt_compression dukungan dekoder.
Tekstur KTX2KHR_texture_basisu dan transcoder Basis.
Tekstur WebPEXT_texture_webp dan penguraian kode WebP.

Persyaratan ini dapat digabungkan. Panel hasil melaporkan informasi kompatibilitas untuk keluaran Anda. Pratinjau kami mencakup dekoder, jadi pratinjau yang berhasil tidak membuktikan bahwa aplikasi Anda telah mengonfigurasinya.

Preset menggunakan kuantisasi geometri secara default. Menonaktifkannya dapat menghilangkan persyaratan kuantisasi geometri, tetapi Meshopt atau tekstur yang dikonversi masih memerlukan pemuat yang sesuai. Periksa ekstensi yang dilaporkan untuk hasil sebenarnya.

Menggunakan Three.js

Konfigurasikan dekoder Meshopt melalui GLTFLoader.setMeshoptDecoder() untuk geometri terkompresi. Untuk KTX2, konfigurasikan a KTX2Loader, deteksi dukungan penyaji dan lampirkan melalui setKTX2Loader(). Sajikan aset transcoder yang cocok dengan aplikasi Anda. Konsultasikan dengan Dokumentasi GLTFLoader dan Dokumentasi KTX2Loader untuk versi Anda.

Contoh: file asli dimuat, tetapi ekspor file yang lebih kecil tidak

Pertahankan tekstur asli dan ekspor sumber yang sama dua kali: sekali dengan Konservatif dan sekali dengan file Lebih Kecil. Jika hanya file kedua yang gagal di aplikasi Anda, periksa ekstensi yang dilaporkan dan kesalahan pemuat sebelum mengubah pengaturan geometri. Perbandingan ini mempersempit masalah pada persyaratan pemuatan yang berubah; ini tidak membuktikan bahwa setiap kegagalan adalah dekoder yang hilang.

Untuk hasil EXT_meshopt_compression di Three.js, daftarkan MeshoptDecoder sebelum memuat. Kemudian coba lagi file ekspor yang sama. Mengekspor ulang dengan kompresi nonaktif merupakan langkah mundur ketika tujuan tidak dapat diubah, dengan potensi biaya download yang lebih besar.

Contoh: tekstur asli berfungsi, tetapi KTX2 gagal setelah diterapkan

Jaga agar pengaturan geometri tetap dan bandingkan tekstur asli dengan KTX2. Untuk aplikasi Three.js, periksa apakah KTX2Loader terpasang dan detectSupport telah dijalankan. Periksa permintaan untuk basis_transcoder.js dan basis_transcoder.wasm. Respons 404, atau laman aplikasi HTML yang ditampilkan pada URL tersebut, mengarah pada pengiriman aset, bukan kualitas tekstur.

Uji ulang keluaran KTX2 yang sama setelah memperbaiki jalur pemuat atau aset, termasuk pada perangkat seluler target. File yang dimuat di pratinjau situs ini telah melewati penyiapan pemirsa ini; penampil produksi Anda masih harus memenuhi persyaratan pemuatannya sendiri.

Nama, extras dan perilaku adegan

Tiga tombol pelestarian diaktifkan secara default. Biarkan diaktifkan ketika aplikasi Anda menemukan objek atau material berdasarkan nama atau membaca extras. Mereka tidak menjanjikan indeks node, hierarki, contoh animasi, atau atribut khusus yang identik. Pengoptimalan dapat menggabungkan atau mengatur ulang data dan mengubah presisi.

Pemilihan tes, perubahan material, pemutaran animasi, target morph dan transformasi objek dalam aplikasi sebenarnya. Mempertahankan extras bukanlah cara untuk mempertahankan ekstensi khusus yang sewenang-wenang.

Pembatasan masukan

Layanan ini menolak input terkompresi Draco, sumber daya eksternal, dan ekstensi diperlukan yang tidak didukung. Ekstensi opsional yang tidak diketahui dapat dibuang. Ekspor GLB sumber daya tertanam yang tidak terkompresi dari aplikasi sumber bila diperlukan.

Untuk daftar ekstensi mesin dan perilaku pengoptimalan, lihat dokumentasi gltfpack hulu. Layanan web menerapkan validasi tambahan dan batasan sumber daya.

Muat model gltfpack di Three.js →

Buka pengoptimal ↗