Bắt đầu dùng Liftmira trên website của bạn

Liftmira chạy trên nền tảng Comnoira. Trên trang của bạn, một đoạn script tên là Comnoira SDK mở Viewer 3D trong một iframe. Viewer hiển thị một Showcase (ở Dashboard tiếng Việt gọi là Trưng bày): bộ sản phẩm và tuỳ chọn bạn đã cấu hình trong Comnoira Dashboard. Bài này nói về thứ tự công việc. Các bài sau đi vào từng phần.

Ba bước

Từ đăng ký đến Viewer chạy thật gồm ba bước. Bước 2 có một điều kiện, ghi ngay dưới danh sách.

1. Khởi tạo tài khoản. Bạn đăng ký và thiết lập shop trong Dashboard.
2. Lấy mã nhúng và License key. Dashboard cấp đoạn mã cho trang của bạn và một License key định danh shop.
3. Cung cấp thông tin sản phẩm. Bạn gửi hình ảnh, bản vẽ hoặc danh mục mẫu cabin, đội ngũ Liftmira dựng mô hình 3D tương tác để hiển thị trên website của bạn.

License key và mã chính thức được cấp khi Comnoira kích hoạt shop. Trước đó Dashboard có Bản xem thử (Preview), mô tả ở phần dưới.

Ba bước: tạo tài khoản, nhận mã nhúng và License key, sau đó gửi thông tin sản phẩm.

1. 1 Bước

   Tạo tài khoản

   Đăng ký và thiết lập cửa hàng trong Dashboard.

2. 2 Bước

   Nhận mã nhúng và License key

   Dashboard cung cấp mã để nhúng vào trang và License key định danh cửa hàng của bạn.

   License key và mã production sẽ được cấp khi Comnoira kích hoạt cửa hàng của bạn. Trong thời gian chờ, hãy sử dụng Preview.

3. 3 Bước

   Gửi thông tin sản phẩm

   Gửi hình ảnh, bản vẽ hoặc catalogue các mẫu cabin. Đội ngũ Liftmira sẽ xây dựng mô hình 3D tương tác cho website của bạn.

Phần nào chạy ở đâu

Mỗi lần tải trang có ba bên tham gia. Website của bạn giữ SDK và khung chứa Viewer. Server của bạn là nơi duy nhất giữ License key. Comnoira giữ Showcase, các file mô hình 3D đã mã hoá và các bước kiểm tra xem ai được xem.

1. 1Trang web yêu cầu một endpoint trên máy chủ của bạn cấp mã.
2. 2Máy chủ của bạn gửi License key đến Comnoira và nhận về một mã có hiệu lực trong 60 giây và chỉ sử dụng được một lần.
3. 3Trình duyệt gửi mã đến Comnoira. Comnoira kiểm tra Origin và trả về session token.
4. 4SDK mở trình xem trong iframe trên trang của bạn và truyền session token cho trình xem.
5. 5Trình xem tải Showcase và yêu cầu session key cho từng tệp mô hình.
6. 6Trình xem tải tệp mô hình đã mã hóa và giải mã tệp ngay trong trình duyệt.

Nếu site chạy WordPress hoặc Shopify, plugin hoặc ứng dụng đóng vai server của bạn. Xem Ba cách tích hợp.

Bạn cần gì cho cách dùng mã nhúng

• License key, chỉ để trên server của bạn. Không đặt vào code trang, file theme hay repository.
• publicKey và Showcase ID của Showcase, đều hiện trong Dashboard. publicKey (bắt đầu bằng pk_live_) đặt trong trang web được.
• Một route trên server để xin mã từ Comnoira. Bài Trao đổi session token trình bày từng request.
• Domain website của bạn, thêm vào danh sách domain được phép của Showcase trong Dashboard.
• Một thẻ <script> cho SDK và một phần tử trống có id để Viewer hiện ra.

Dùng thử Showcase trước khi kích hoạt

Có hai cách xem Showcase chạy thật, phù hợp với hai nhu cầu khác nhau.

Bản xem thử (Preview) dành cho shop chưa kích hoạt. Trong Dashboard, bạn dán một đoạn mã lên một trang thuộc website của mình rồi xác minh trang đó. Preview khi ấy hiển thị bản demo mặc định của ngành bạn trên trang đó. Preview kết thúc sau 14 ngày hoặc 300 phiên, và chỉ chạy trên website bạn đã xác minh. Comnoira có thể tắt Preview: khi đang tắt, Viewer báo bản xem thử tạm thời không dùng được. Khi bạn yêu cầu chạy chính thức và quản trị viên duyệt shop, Preview trở thành Showcase production của bạn. Đoạn mã Preview lúc đó không còn là mã đúng, nên bạn thay bằng mã production (xem Checklist trước khi lên production).

Chế độ demo, Comnoira.init(null, showcaseId, { demo: true }), dành cho các trang của chính Comnoira. Backend chỉ trả demo session cho các origin nằm trong danh sách Comnoira quản lý, nên demo trên domain của bạn bị từ chối với ORIGIN_NOT_ALLOWED. Muốn xem demo mà không cần thiết lập gì, mở liftmira.com/vi/demo.

Khi mô hình của bạn thay mẫu

Showcase tạo trong Dashboard bắt đầu với nội dung mẫu của ngành bạn. Trong lúc đó, Viewer hiện một nhãn nhỏ "Sample content". Khi đội ngũ Liftmira thêm mô hình của bạn vào cùng Showcase, Showcase ID, publicKey và đoạn mã trên trang của bạn giữ nguyên. Nội dung được lấy từ Showcase lúc Viewer tải, nên không có gì trên website phải sửa.

Điều này đúng trong phạm vi một Showcase. Mã Preview và mã production là hai đoạn mã khác nhau: Preview dùng preview key, mã production dùng License key qua server của bạn.

Tiếp theo

Ba cách tích hợp so sánh mã nhúng, plugin WordPress và ứng dụng Shopify. Trao đổi session token giải thích bước trao đổi phía sau mỗi lần tải trang.