ANTES DE ENVIAR

Compressão GLB e compatibilidade do visualizador

A extensão de arquivo GLB não garante que todos os aplicativos possam carregar seu conteúdo. Verifique as extensões usadas pela saída e teste seu destino.

Combine as configurações com o seu carregador

Esses requisitos podem ser combinados. O painel de resultados relata informações de compatibilidade para sua saída. Nossa visualização inclui decodificadores, portanto, uma visualização bem-sucedida não prova que seu próprio aplicativo os tenha configurado.

As predefinições usam quantização de geometria por padrão. Desativá-lo pode remover o requisito de quantização de geometria, mas Meshopt ou texturas convertidas ainda precisam de seus carregadores correspondentes. Verifique as extensões relatadas para obter o resultado real.

Usando Three.js

Configure um decodificador Meshopt por meio de GLTFLoader.setMeshoptDecoder() para geometria comprimida. Para KTX2, configure um KTX2Loader, detecte o suporte do renderizador e anexe-o por meio setKTX2Loader(). Sirva os ativos do transcodificador correspondentes com seu aplicativo. Consulte o Documentação do GLTFLoader e Documentação do KTX2Loader para sua versão.

Exemplo: o original é carregado, mas a exportação do arquivo menor não

Mantenha as texturas originais e exporte a mesma fonte duas vezes: uma vez com Conservador e outra com arquivo Menor. Se apenas o segundo arquivo falhar em seu aplicativo, verifique as extensões relatadas e o erro do carregador antes de alterar as configurações de geometria. Esta comparação restringe o problema a um requisito de carregamento alterado; isso não prova que toda falha seja um decodificador ausente.

Para um resultado EXT_meshopt_compression em Three.js, registre MeshoptDecoder antes de carregar. Em seguida, tente novamente o mesmo arquivo exportado. A reexportação com a compactação desativada é uma alternativa quando o destino não pode ser alterado, ao custo de um download potencialmente maior.

Exemplo: texturas originais funcionam, mas KTX2 falha após a implantação

Mantenha as configurações de geometria fixas e compare as texturas originais com KTX2. Para um aplicativo Three.js, verifique se KTX2Loader está conectado e se detectSupport foi executado. Inspecione as solicitações de base_transcoder.js e base_transcoder.wasm. Uma resposta 404, ou uma página de aplicativo HTML retornada nessas URLs, aponta para a entrega de ativos em vez da qualidade da textura.

Teste novamente a mesma saída KTX2 depois de corrigir o caminho do carregador ou do ativo, inclusive em um dispositivo móvel de destino. Um arquivo carregado na visualização deste site passou na configuração deste visualizador; seu visualizador de produção ainda deve satisfazer seus próprios requisitos de carregamento.

Nomes, extras e comportamento da cena

As três opções de preservação estão habilitadas por padrão. Deixe-os habilitados quando seu aplicativo encontrar objetos ou materiais por nome ou ler extras. Eles não prometem índices de nós idênticos, hierarquia, amostras de animação ou atributos personalizados. A otimização pode mesclar ou reorganizar dados e alterar a precisão.

Seleção de testes, alterações de materiais, reprodução de animações, metamorfoses e transformações de objetos na aplicação real. Preservar extras não é uma maneira de preservar extensões personalizadas arbitrárias.

Restrições de entrada

Este serviço rejeita entrada compactada Draco, recursos externos e extensões necessárias não suportadas. Extensões opcionais desconhecidas podem ser descartadas. Exporte um recurso integrado e descompactado GLB do aplicativo de origem quando necessário.

Para a lista de extensões do mecanismo e o comportamento de otimização, consulte documentação upstream gltfpack. O serviço web aplica validação adicional e limites de recursos.

Carregar modelos gltfpack em Three.js →