3D 모델 사양
이 페이지에서는 3D Menu Pro에서 사용하는 3D 모델 생성 및 최적화 파이프라인에 대한 상세한 기술 참조를 제공합니다.
출력 형식
모든 3D 모델은 GLB (glTF Binary) 파일로 제공됩니다. GLB는 웹 3D 콘텐츠의
업계 표준으로, Three.js와
<model-viewer> 웹 컴포넌트를 비롯한 모든 주요 브라우저와
프레임워크에서 지원됩니다.
크기 제한
최종 최적화된 모델의 최대 크기는 2 MB입니다. 초기 최적화 단계 후에도 이 한도를 초과하는 모델은 자동으로 단순화됩니다. 자동 단순화는 모델이 2 MB를 초과하고 폴리곤 수가 10,000개를 넘을 때 실행됩니다. 폴리곤 수 데이터를 사용할 수 없는 경우 시스템은 안전 조치로 기본적으로 단순화를 수행합니다.
최적화 파이프라인
생성된 모든 3D 모델은 모바일 기기에서 빠르게 로드되도록 다단계 최적화 파이프라인을 거칩니다.
- 중복 제거 — 중복된 접근자, 머티리얼, 메시, 텍스처를 제거하여 중복성을 줄입니다.
- 가지치기 — 보이는 모델에 기여하지 않는 사용되지 않는 노드, 머티리얼 및 기타 리소스를 제거합니다.
- 용접 — 동일한 위치와 속성을 공유하는 정점을 병합하여 정점 수를 줄입니다.
- 단순화 — 시각적 충실도를 유지하면서 폴리곤 수를 줄입니다. 품질을 고려한 메시 데시메이션을 위해 meshoptimizer 라이브러리를 사용합니다.
- 양자화 — 정점 속성(위치, 노멀, UV)의 정밀도를 낮춰 시각적 영향을 최소화하면서 메모리 사용량을 줄입니다.
- 텍스처 압축 — 시각적 품질을 유지하면서 파일 크기를 줄이기 위해 텍스처를 WebP 형식으로 변환합니다.
- Draco 압축 — 파일 크기를 최종적으로 줄이기 위해 Draco 메시 압축을 적용합니다. Draco는 로드 시점에 브라우저에서 디코딩됩니다.
모델 상태
| 상태 | 설명 | 소요 시간 |
|---|---|---|
PENDING |
항목이 처리 대기열에 들어가 사용 가능한 워커를 기다리고 있습니다. | 대기열 길이에 따라 다름 |
GENERATING |
AI 제공업체가 입력 사진으로부터 3D 모델을 생성하고 있습니다. | 30초~2분 |
PROCESSING |
생성된 모델을 위 파이프라인으로 최적화하고 있습니다. | 10~30초 |
READY |
모델이 최적화되어 공개 메뉴에 게시되었습니다. | 최종 상태 |
FAILED |
처리 중 오류가 발생했습니다. 대시보드에서 다시 시도할 수 있습니다. | 최종 상태(다시 시도할 때까지) |
가져오기 시간 제한
시스템은 로딩이 느려지는 경험을 방지하기 위해 모델 전송 중 시간 제한을 적용합니다.
- 포스터 이미지 가져오기: 30초 시간 제한
- 모델 다운로드: 120초 시간 제한
모델 다운로드 시간이 초과되면 뷰어는 포스터 이미지(보정된 사진)로 대체하므로 고객은 항상 무언가를 볼 수 있습니다.
WebGL 호환성
3D 모델은 브라우저에서 WebGL로 렌더링됩니다. WebGL을 사용할 수 없거나
컨텍스트가 손실되는 경우(메모리가 제한된 모바일 기기에서 발생할 수 있음)
뷰어는 자동으로 폭넓은 호환성을 제공하는
<model-viewer> 웹 컴포넌트로 대체됩니다.
WebGL과 model-viewer 모두 지원되지 않으면 보정된
2D 사진이 대신 표시됩니다.