KULLANIMA ALMADAN ÖNCE

GLB sıkıştırması ve görüntüleyici uyumluluğu

Dosya uzantısının GLB olması, her uygulamanın içeriği yükleyebileceği anlamına gelmez. Çıktının kullandığı uzantıları kontrol edip hedef ortamda test edin.

Ayarları yükleyicinize göre seçin

Bu gereksinimler birlikte ortaya çıkabilir. Sonuç paneli çıktının uyumluluk bilgilerini gösterir. Önizlememizde çözücüler hazır bulunduğundan, önizlemenin çalışması sizin uygulamanızda da yapılandırıldıklarını göstermez.

Önayarlar varsayılan olarak geometri nicemlemesi kullanır. Bunu kapatmak nicemleme desteği gereksinimini kaldırabilir; ancak Meshopt veya dönüştürülmüş dokular yine kendi yükleyicilerine ihtiyaç duyar. Gerçek sonuç için bildirilen uzantıları kontrol edin.

Three.js kullanımı

Meshopt ile sıkıştırılmış geometri için çözücüyü GLTFLoader.setMeshoptDecoder() ile kaydedin. KTX2 dokuları için KTX2Loader yapılandırmasını yapın, oluşturucunun desteğini tespit edin ve setKTX2Loader() ile bağlayın. Uyumlu dönüştürücü dosyalarını uygulamanızla birlikte sunun ve kullandığınız Three.js sürümünün belgelerini izleyin.

GLTFLoader belgelerini · KTX2Loader belgelerini

Örnek: orijinal yükleniyor ama Daha küçük dosya çıktısı yüklenmiyor

Orijinal dokuları koruyarak aynı kaynağı iki kez dışa aktarın: bir kez Temkinli, bir kez Daha küçük dosya önayarıyla. Uygulamanızda yalnızca ikincisi başarısız oluyorsa geometri ayarlarını değiştirmeden önce bildirilen uzantılara ve yükleyici hatasına bakın. Bu karşılaştırma sorunu değişen yükleme gereksinimine daraltır; her hatanın eksik çözücüden kaynaklandığını kanıtlamaz.

Three.js'te EXT_meshopt_compression kullanan bir sonuç için yüklemeden önce MeshoptDecoder'ı kaydedin. Ardından aynı dışa aktarılmış dosyayı yeniden deneyin. Hedef uygulama değiştirilemiyorsa sıkıştırmayı kapatarak yeniden dışa aktarmak bir alternatiftir, ancak indirme boyutu artabilir.

Örnek: orijinal dokular çalışıyor ama dağıtımdan sonra KTX2 çalışmıyor

Geometri ayarlarını sabit tutarak orijinal dokularla KTX2'yi karşılaştırın. Three.js uygulamasında KTX2Loader'ın bağlı ve detectSupport'un çalıştırılmış olduğunu doğrulayın. basis_transcoder.js ve basis_transcoder.wasm isteklerini inceleyin. Bu adreslerden 404 veya uygulamanın HTML sayfası dönüyorsa sorun doku kalitesinden çok kaynakların sunulmasıyla ilgilidir.

Yükleyiciyi veya kaynak yolunu düzelttikten sonra aynı KTX2 çıktısını, hedef mobil cihaz dahil yeniden test edin. Bu sitenin önizlemesinde açılan dosya bu görüntüleyicinin yapılandırmasında çalışmıştır; üretimdeki görüntüleyicinizin kendi yükleme gereksinimlerini yine sağlamanız gerekir.

Adlar, extras ve sahne davranışı

Üç koruma seçeneği varsayılan olarak açıktır. Uygulamanız nesneleri veya malzemeleri adlarıyla buluyor ya da extras okuyorsa bunları açık bırakın. Düğüm indekslerinin, hiyerarşinin, animasyon örneklerinin veya özel özniteliklerin aynı kalacağını garanti etmezler. Optimizasyon verileri birleştirebilir, yeniden düzenleyebilir ve hassasiyeti değiştirebilir.

Gerçek uygulamada seçimi, malzeme değişikliklerini, animasyon oynatmayı, biçim değiştirme hedeflerini ve nesne dönüşümlerini test edin. extras verisini korumak, tüm özel uzantıları korumanın bir yolu değildir.

Girdi kısıtları

Hizmet Draco ile sıkıştırılmış girdileri, harici kaynakları ve desteklenmeyen zorunlu uzantıları reddeder. Bilinmeyen isteğe bağlı uzantılar kaldırılabilir. Gerektiğinde kaynak uygulamadan sıkıştırılmamış ve kaynakları gömülü bir GLB dışa aktarın.

Motorun uzantı listesi ve optimizasyon davranışı için gltfpack kaynak proje belgelerine bakın. Web hizmeti ek doğrulama ve kaynak sınırları uygular.

gltfpack modellerini Three.js'te yükleme →