PRIMA DI PUBBLICARE

Compressione GLB e compatibilità dei visualizzatori

L'estensione GLB non garantisce che tutte le applicazioni possano caricarne il contenuto. Controlla le estensioni usate nel risultato e prova il visualizzatore di destinazione.

Adatta le impostazioni al loader

Questi requisiti possono combinarsi. Il pannello dei risultati indica le informazioni di compatibilità del file. La nostra anteprima include i decoder: un'anteprima corretta non dimostra che siano configurati anche nella tua applicazione.

I preset usano la quantizzazione della geometria per impostazione predefinita. Disattivandola puoi eliminare tale requisito, ma Meshopt e le texture convertite richiedono comunque i rispettivi loader. Controlla le estensioni indicate per il risultato effettivo.

Usare Three.js

Per la geometria compressa con Meshopt, registra il decoder con GLTFLoader.setMeshoptDecoder(). Per le texture KTX2, configura KTX2Loader, rileva il supporto del renderer e collegalo con setKTX2Loader(). Distribuisci i file corrispondenti del transcoder con la tua applicazione e consulta la documentazione della versione di Three.js che utilizzi.

documentazione di GLTFLoader · documentazione di KTX2Loader

Esempio: l'originale si carica, ma il risultato di File più piccolo no

Mantieni le texture originali ed esporta due volte la stessa sorgente: una con Conservativo e una con File più piccolo. Se solo il secondo file non funziona nell'applicazione, controlla le estensioni segnalate e l'errore del loader prima di cambiare la geometria. Il confronto circoscrive il problema a un requisito di caricamento modificato; non dimostra che ogni errore sia dovuto a un decoder mancante.

Per un risultato con EXT_meshopt_compression in Three.js, registra MeshoptDecoder prima del caricamento. Poi riprova lo stesso file esportato. Se non puoi modificare l'applicazione di destinazione, riesportare senza compressione è un'alternativa, ma il download potrebbe essere più grande.

Esempio: le texture originali funzionano, ma KTX2 fallisce dopo la distribuzione

Mantieni fisse le impostazioni della geometria e confronta texture originali e KTX2. In un'applicazione Three.js, verifica che KTX2Loader sia collegato e che detectSupport sia stato eseguito. Esamina le richieste di basis_transcoder.js e basis_transcoder.wasm. Una risposta 404 o una pagina HTML restituita a quegli URL indicano un problema nella distribuzione delle risorse, non nella qualità delle texture.

Dopo aver corretto il loader o il percorso delle risorse, riprova lo stesso risultato KTX2, anche su un dispositivo mobile di destinazione. Un file che si carica nell'anteprima di questo sito funziona con la configurazione di questo visualizzatore; quello di produzione deve comunque soddisfare i propri requisiti di caricamento.

Nomi, extras e comportamento della scena

Le tre opzioni di conservazione sono attive per impostazione predefinita. Lasciale attive se l'applicazione cerca oggetti o materiali per nome o legge gli extras. Non garantiscono indici dei nodi, gerarchia, campioni di animazione o attributi personalizzati identici. L'ottimizzazione può unire o riorganizzare dati e modificarne la precisione.

Prova selezione, cambio dei materiali, riproduzione delle animazioni, morph target e trasformazioni degli oggetti nell'applicazione reale. Mantieni gli extras non permette di preservare estensioni personalizzate arbitrarie.

Restrizioni sui file in ingresso

Il servizio rifiuta file compressi con Draco, risorse esterne ed estensioni obbligatorie non supportate. Le estensioni facoltative sconosciute possono essere eliminate. Se necessario, esporta dall'applicazione di origine un GLB non compresso con risorse incorporate.

Per l'elenco delle estensioni del motore e il comportamento dell'ottimizzazione, consulta la documentazione ufficiale di gltfpack. Il servizio web applica ulteriori controlli e limiti sulle risorse.

Caricare modelli gltfpack in Three.js →