Hướng dẫn upload mẫu 3D

Dành cho team thiết kế — quy trình chuẩn từ SketchUp đến web viewer

Quan trọng: File gốc SketchUp (.skp) KHÔNG hiển thị được trên web. Bắt buộc phải export sang .glb trước khi upload.

1. Tổng quan quy trình

Mỗi mẫu thiết kế cần chuẩn bị các file sau:

FileBắt buộc?Mục đích
.glbBắt buộcHiển thị 3D trên web (xoay, zoom, AR Android)
.jpg / .png (poster)Bắt buộcẢnh thumbnail hiển thị trong gallery
.usdzTuỳ chọnAR trên iPhone (Quick Look)

Sơ đồ quy trình:

SketchUp (.skp)
   ↓  export .dae / plugin glTF
Blender (clean + Draco + material variants)
   ↓  export .glb (+ .usdz cho iOS)
Upload lên /admin/mau-thiet-ke

2. Export từ SketchUp sang GLB

Cách 1 — Plugin glTF (nhanh nhất)

  1. Mở SketchUp → Window → Extension Warehouse, tìm "glTF Exporter" của Centaur Engineering, nhấn Install.
  2. Mở file thiết kế cần export.
  3. File → Export → glTF (.glb) → chọn Binary (.glb).
  4. Bật Draco compression nếu có (giảm dung lượng 5–10 lần).

Cách 2 — Qua Blender (kiểm soát tốt hơn)

  1. SketchUp: File → Export → 3D Model → chọn định dạng .dae (Collada — bản free) hoặc .fbx (cần SketchUp Pro).
  2. Mở Blender (miễn phí tại blender.org) → File → Import → Collada (.dae) hoặc FBX.
  3. Kiểm tra vật liệu, gộp mesh, xoá object thừa.
  4. File → Export → glTF 2.0 (.glb) với các tuỳ chọn:
    • Format: glTF Binary (.glb)
    • Bật Compression (Draco) — mức 6
    • Include: Materials, UVs, Normals

Cách 3 — Online converter

Dùng cho file đơn giản, không có vật liệu phức tạp:

3. Tối ưu file (rất quan trọng)

File SketchUp xuất ra thường rất nặng. Trước khi upload phải tối ưu:

Vấn đềCách xử lý
File quá nặng (>50 MB), nhiều mặt thừaBlender: Decimate modifier → giảm còn dưới 100k triangles
Texture bị mất khi exportSketchUp: File → Save AsPurge Unused; đảm bảo texture đã embed trong file
File GLB vẫn > 15 MBBật Draco compression + convert texture sang KTX2 bằng gltf-transform
Model bị tối / không có ánh sángKhông cần thêm đèn — viewer dùng HDR environment mặc định
Khuyến nghị: File GLB nên < 15 MB để load nhanh trên 4G. Số polygon < 200,000 triangles.

4. Đổi vật liệu/màu trong viewer (KHR_materials_variants)

Nếu muốn khách hàng có thể chuyển đổi vật liệu trực tiếp trên web (VD: đá trắng → đá đen → granite), cần setup material variants trong Blender:

  1. Mở file .glb trong Blender.
  2. Cài addon KHR_materials_variants (có sẵn từ Blender 3.2+, bật trong Edit → Preferences → Add-ons).
  3. Trong panel Object Properties → Material Variants, tạo các variant:
    • "Đá trắng" → gán material đá trắng
    • "Đá đen" → gán material đá đen
    • "Granite đỏ" → gán material granite
  4. Export lại .glb — nhớ bật "Material variants" trong dialog export.
Tên variant sẽ tự động xuất hiện thành các nút bấm cho khách trên trang chi tiết.

5. Tạo file .usdz cho iPhone AR (tuỳ chọn)

iPhone/iPad cần định dạng riêng .usdz để xem AR. Ba cách:

  • Reality Converter (Mac, miễn phí từ Apple): kéo thả .glb → File → Export → .usdz.
  • Aspose GLB → USDZ (online, không cần Mac).
  • CLI: npm i -g @gltf-transform/cli gltf-transform usdz model.glb model.usdz.

6. Tạo ảnh poster (thumbnail)

Mỗi mẫu cần 1 ảnh đại diện hiển thị trong gallery. Cách dễ nhất:

  1. SketchUp: chọn góc nhìn đẹp → File → Export → 2D Graphic → JPG.
  2. Kích thước khuyên dùng: 1200 × 900 px, dung lượng < 500 KB.
  3. Có thể dùng squoosh.app để nén ảnh online.

7. Upload lên hệ thống

  1. Vào trang /admin/mau-thiet-ke (cần đăng nhập tài khoản admin).
  2. Nhấn "Thêm mẫu mới", điền:
    • Tên mẫu — VD: "Khuôn viên hoa văn rồng phụng"
    • Danh mục — Khuôn viên / Mộ đá
    • Mô tả — kích thước, chất liệu, đặc điểm
    • Tên khách hàng (nếu là mẫu thiết kế riêng)
  3. Upload 3 file: .glb, ảnh poster, .usdz (tuỳ chọn).
  4. Tích "Công khai" nếu muốn hiển thị cho khách. Lưu lại.

8. Xử lý sự cố thường gặp

Model load nhưng bị đen / không thấy gì

Thiếu normals khi export. Quay lại Blender, khi export GLB bật "Include Normals".

Model bị lật ngược / nằm nghiêng

SketchUp dùng trục Z up, GLB dùng Y up. Trong Blender, xoay model 90° quanh trục X trước khi export.

Upload thất bại "file too large"

Giới hạn 50 MB. Bật Draco + giảm texture xuống 1024×1024 hoặc nhỏ hơn.

Trên iPhone không có nút "Xem AR"

iPhone bắt buộc cần file .usdz. Xem mục 5 để tạo file này.

Mọi thắc mắc kỹ thuật, liên hệ admin công ty. Khuyến nghị mỗi designer cài sẵn SketchUp + plugin glTF ExporterBlender để tự xử lý được toàn bộ quy trình.