lukehollis/sphr

🌐 SPHR — Runtime web hackable cho digital twin và cảnh 3D trình duyệt

SPHR là runtime web cho không gian ảo, digital twin và cảnh 3D trình duyệt — hỗ trợ 3D Gaussian Splatting, ảnh 360° và hiệu ứng VFX.

SPHR là một runtime web hackable, được viết bằng Next.js + Three.js, dùng để xây dựng các chuyến dạo ảo, digital twin và cảnh 3D chạy trực tiếp trên trình duyệt. Dự án hỗ trợ tải lên các tài nguyên 3D Gaussian Splatting (.splat, .ply, .spz, .ksplat, .sog, .rad), ảnh 360° và các lớp phủ VFX khác. SPHR có thể khởi chạy từ một tệp JSON cấu hình từ xa, dữ liệu nhúng trong trang hoặc demo mặc định.

✨ Điểm nổi bật

• 3D Gaussian Splatting: hỗ trợ hiển thị các tệp .splat, .ply, .spz, .ksplat, .sog, .rad trực tiếp trên trình duyệt thông qua SparkSplatLayer.
• Cấu hình linh hoạt: khởi chạy cảnh từ URL JSON cấu hình, biến toàn cục window.__SPHR_BOOTSTRAP__, thẻ script nhúng hoặc demo mặc định.
• Đa dạng lớp dữ liệu: hỗ trợ PanoramaLayer (ảnh 360°), IiifImageLayer (ảnh IIIF), SceneGraphLayer (mô hình GLB), AnnotationLayer (chú thích 3D).
• Chuyển động camera mượt mà: hỗ trợ chế độ camera thứ nhất (FPV) và quay orbit, kèm hoạt ảnh chuyển cảnh.
• Chuyến dẫn có hướng dẫn: hỗ trợ tour văn bản, âm thanh, chú thích, hiển thị mô hình và di chuyển camera theo trình tự.
• Hackable: kiến trúc modul cho phép tù biến và mở rộng các lớp hiển thị, điều khiển và hiệu ứng.
• Tích hợp dễ dàng: khởi chạy nhanh với npm install && npm run dev, truy cập http://localhost:3000.
• Tương thích CORS: hỗ trợ tải tài nguyên từ máy chủ hoặc CDN từ xa, yêu cầu cấu hình CORS phù hợp.

💡 Vì sao đáng chú ý

SPHR khác biệt vì tích trung vào 3D Gaussian Splatting — một công nghệ hiến thị 3D siêu chân thực từ các điểm đám mây. Thay vì dựa vào backend phức tạp, phiên bản mới chỉ sử dụng Next.js + Three.js để chạy hoàn toàn trên trình duyệt. Điều này giúp giảm chi phí triển khai và tăng tính khả dụng, đồng thời cho phép dễ dàng tích hợp vào bất kỳ trang web nào thông qua cấu hình JSON đơn giản.

Dự án rất phù hợp cho các nhà nghiên cứu, nhà thiết kế không gian ảo hoặc các đội phát triển muốn xây dựng trải nghiệm điện tụy với hiệu suất cao mà không cần xây dựng toàn bộ engine 3D từ đầu.

#DigitalTwin #3DGaussianSplatting #ThreeJS #VirtualTour #OpenSource #TiniX