배송하기 전에

GLB 압축 및 뷰어 호환성

GLB 파일 확장자는 모든 응용 프로그램이 해당 내용을 로드할 수 있다고 보장하지 않습니다. 출력에 사용된 확장자를 확인하고 대상을 테스트하십시오.

로더에 맞게 설정을 일치시키세요

이러한 요구 사항은 결합될 수 있습니다. 결과 패널은 출력에 대한 호환성 정보를 보고합니다. 우리의 미리보기에는 디코더가 포함되어 있으므로 성공적인 미리보기가 귀하의 애플리케이션에 디코더가 구성되어 있음을 입증하지는 않습니다.

사전 설정은 기본적으로 기하학 양자화를 사용합니다. 이를 비활성화하면 지오메트리 양자화 요구 사항이 제거될 수 있지만 Meshopt 또는 변환된 텍스처에는 여전히 해당 로더가 필요합니다. 실제 결과는 보고된 확장자를 확인하세요.

Three.js 사용

다음을 통해 Meshopt 디코더를 구성하세요. GLTFLoader.setMeshoptDecoder() 압축된 기하학의 경우. KTX2의 경우 KTX2Loader, 렌더러 지원을 감지하고 이를 통해 연결합니다. setKTX2Loader(). 애플리케이션에 일치하는 트랜스코더 자산을 제공하세요. 상담하세요 GLTFLoader 문서 및 KTX2Loader 문서 귀하의 버전에 맞게.

예: 원본은 로드되지만 더 작은 파일 내보내기는 로드되지 않습니다.

원본 텍스처를 유지하고 동일한 소스를 두 번 내보냅니다. 한 번은 Conservative로, 한 번은 Smaller 파일로 내보냅니다. 응용프로그램에서 두 번째 파일만 실패하는 경우 형상 설정을 변경하기 전에 보고된 확장자와 로더 오류를 확인하십시오. 이 비교를 통해 문제는 변경된 로딩 요구 사항으로 좁혀집니다. 모든 실패가 디코더 누락이라는 것을 증명하는 것은 아닙니다.

Three.js의 EXT_meshopt_compression 결과의 경우 로드하기 전에 MeshoptDecoder를 등록하세요. 그런 다음 내보낸 동일한 파일을 다시 시도하십시오. 압축을 끈 상태로 다시 내보내는 것은 잠재적으로 더 큰 다운로드를 희생하여 대상을 변경할 수 없는 경우 대체 방법입니다.

예: 원본 텍스처는 작동하지만 배포 후 KTX2가 실패합니다.

지오메트리 설정을 고정한 상태로 유지하고 원본 텍스처를 KTX2와 비교하세요. Three.js 애플리케이션의 경우 KTX2Loader가 첨부되어 있고 detectSupport가 실행되었는지 확인하세요. Basis_transcoder.js 및 Basis_transcoder.wasm에 대한 요청을 검사합니다. 404 응답 또는 해당 URL에서 반환된 HTML 애플리케이션 페이지는 텍스처 품질보다는 자산 전달을 가리킵니다.

대상 모바일 장치를 포함하여 로더 또는 자산 경로를 수정한 후 동일한 KTX2 출력을 다시 테스트합니다. 이 사이트의 미리보기에 로드되는 파일이 이 뷰어의 설정을 통과했습니다. 프로덕션 뷰어는 여전히 자체 로딩 요구 사항을 충족해야 합니다.

이름, extras 및 장면 동작

세 가지 보존 토글은 기본적으로 활성화되어 있습니다. 응용 프로그램이 이름으로 개체나 재료를 찾거나 extras를 읽을 때 활성화된 상태로 둡니다. 동일한 노드 인덱스, 계층 구조, 애니메이션 샘플 또는 사용자 정의 속성을 약속하지 않습니다. 최적화를 통해 데이터를 병합하거나 재구성하고 정밀도를 변경할 수 있습니다.

실제 애플리케이션에서 선택, 재질 변경, 애니메이션 재생, 모프 타겟 및 객체 변환을 테스트합니다. extras 보존은 임의의 사용자 정의 확장을 보존하는 방법이 아닙니다.

입력 제한

이 서비스는 Draco 압축 입력, 외부 리소스 및 지원되지 않는 필수 확장을 거부합니다. 알 수 없는 선택적 확장은 삭제될 수 있습니다. 필요한 경우 소스 애플리케이션에서 압축되지 않은 임베디드 리소스 GLB를 내보냅니다.

엔진의 확장 목록 및 최적화 동작은 다음을 참조하세요. 업스트림 gltfpack 문서. 웹 서비스는 추가 유효성 검사 및 리소스 제한을 적용합니다.

Three.js에 gltfpack 모델 로드 →