주요 콘텐츠로 건너뛰기

참조

3D 모델 사양

3D 모델 사양

이 페이지에서는 3D Menu Pro에서 사용하는 3D 모델 생성 및 최적화 파이프라인에 대한 상세한 기술 참조를 제공합니다.

출력 형식

모든 3D 모델은 GLB (glTF Binary) 파일로 제공됩니다. GLB는 웹 3D 콘텐츠의 업계 표준으로, Three.js와 <model-viewer> 웹 컴포넌트를 비롯한 모든 주요 브라우저와 프레임워크에서 지원됩니다.

크기 제한

최종 최적화된 모델의 최대 크기는 2 MB입니다. 초기 최적화 단계 후에도 이 한도를 초과하는 모델은 자동으로 단순화됩니다. 자동 단순화는 모델이 2 MB를 초과하고 폴리곤 수가 10,000개를 넘을 때 실행됩니다. 폴리곤 수 데이터를 사용할 수 없는 경우 시스템은 안전 조치로 기본적으로 단순화를 수행합니다.

최적화 파이프라인

생성된 모든 3D 모델은 모바일 기기에서 빠르게 로드되도록 다단계 최적화 파이프라인을 거칩니다.

  1. 중복 제거 — 중복된 접근자, 머티리얼, 메시, 텍스처를 제거하여 중복성을 줄입니다.
  2. 가지치기 — 보이는 모델에 기여하지 않는 사용되지 않는 노드, 머티리얼 및 기타 리소스를 제거합니다.
  3. 용접 — 동일한 위치와 속성을 공유하는 정점을 병합하여 정점 수를 줄입니다.
  4. 단순화 — 시각적 충실도를 유지하면서 폴리곤 수를 줄입니다. 품질을 고려한 메시 데시메이션을 위해 meshoptimizer 라이브러리를 사용합니다.
  5. 양자화 — 정점 속성(위치, 노멀, UV)의 정밀도를 낮춰 시각적 영향을 최소화하면서 메모리 사용량을 줄입니다.
  6. 텍스처 압축 — 시각적 품질을 유지하면서 파일 크기를 줄이기 위해 텍스처를 WebP 형식으로 변환합니다.
  7. 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 사진이 대신 표시됩니다.