TVN 3D Viewer 1.0.29

1. Tải file TVN_3DViewer.rbz.
2. Trong SketchUp: Window › Extension Manager › Install Extension → chọn file vừa tải → Yes.
3. Toolbar TVN 3D Viewer có 2 nút: TVN 3D Viewer · hộp quản lý. Menu Extensions › TVN 3D Viewer có: TVN 3D Viewer · Tài khoản · Gallery trên web · Hướng dẫn sử dụng (trang này).

Vật đang chọn có 4 góc vàng (không viền xanh), con trỏ là bàn tay. Có cài TVN Touch: ở chế độ cảm ứng nút TVN 3D Viewer nằm trên toolbar trái, ⚙ hộp quản lý nằm cuối thanh nút đáy.

1. Nhân viên: cài plugin, bấm Máy nhân viên. Hộp thoại hiện mã QR, mã ghép 8 ký tự và mã xác nhận 4 ký tự.
2. Nhân viên bấm Sao chép link gửi chủ → dán vào Zalo gửi chủ. Chủ đứng cạnh thì quét QR bằng điện thoại.
3. Chủ bấm link trên điện thoại (đăng nhập thichvenha.com bằng Gmail của chủ, trên máy của chủ) — hoặc trong plugin máy chủ: Cài đặt › Duyệt máy nhân viên → gõ mã ghép. So mã xác nhận với màn hình nhân viên, gõ tên người (vd. Hoa) → Duyệt. Khác mã, hoặc không biết máy đó: Từ chối.
4. Máy nhân viên tự vào sau vài giây: dùng chung gói, mô hình, khách hàng của tài khoản.

Mã ghép sống 10 phút, dùng 1 lần, không có chủ bấm Duyệt thì vô dụng. Máy nhân viên không mua, không duyệt / thu hồi máy khác, không đổi tên cửa hàng, không thấy email chủ. Đã đủ máy: trang Duyệt cho chọn 1 máy để thu hồi, hoặc mua thêm máy.

• Khách: nhớ theo file .skp (lần sau mở file này tự chọn sẵn). Dòng đầu Không gắn khách.
• Tầng / Phòng: dòng đầu Tự động (theo tag) = tự điền theo tag 3. / 4. như trước. Chỉ áp cho vật đang chọn — chọn vật khác thì về Tự động.
• Danh sách dài: ▲ ▼ lật trang. + Thêm… mở hộp thoại ở Cài đặt để thêm tên mới.
• Có chọn gì ở đây thì xuất xong hộp thoại gắn luôn, không phải bấm ✓ (vẫn sửa lại được ngay dưới QR).
• Mã kiểm ▾: mã bảo mật 4–6 số cho việc kiểm hàng. Chạm → bàn phím số (gõ phím thật cũng được), OK để lưu, Không dùng mã để bỏ. Mã lưu trên vật, mỗi lần ✓ Xuất / Cập nhật thì gửi lên link. Đặt mã cho vật đã xuất → bấm ✓ Cập nhật.
• Bấm nút plugin là tự tải danh sách mới nhất của tài khoản (kể cả tên vừa thêm / xoá ở máy khác) và lưu trên máy — mất mạng vẫn chọn được. Lần đầu đang tải → bảng hiện Đang tải danh sách….

• Giữ Ctrl hoặc Shift rồi chạm thêm vật (máy tính bảng: bật nút Chọn nhiều). Chọn bằng Select / Outliner cũng được.
• Thanh đáy: 3 vật ✕ (chạm = bỏ chọn) · Khách ▾ chung cho cả lượt · ✓ = xuất từng vật, mỗi vật 1 link riêng. Tầng / Phòng tự theo tag từng vật.
• Góc ảnh đại diện + nút Toàn cảnh: xuất nhiều vật tự lấy phối cảnh 45° phía trước bên phải của từng vật (thấy mặt cánh + hông phải), không theo góc đang nhìn — đang nhìn Top mặt bằng vẫn ra ảnh đẹp. Xuất 1 vật thì giữ đúng góc bạn đang nhìn.
• Xong cả lượt → hộp thoại hiện danh sách link (mở thử, chép tên + link tất cả). Lỗi giữa chừng → dừng đúng vật đó, bấm Thử lại; đóng hộp thoại = thôi các vật còn lại.

• Gom mọi thứ của 1 tầng (mặt bằng 2D + các tủ, mỗi phòng 1 group 4. …) vào 1 group tag 3. …, vd 3. Tầng 3. Chọn group tầng đó → ✓ = Xuất sa bàn.
• Plugin tự tìm tủ 3D trong tầng: vật tag 7. Nội thất / 7. Nội thất rời cao từ 15 cm (ký hiệu 2D dẹt thì bỏ qua), chụp nền mặt bằng nhìn thẳng từ trên xuống (giấu các tủ 3D), nền trong suốt như TVN Sale: ngoài tường không còn tấm trắng. Mặt bằng chỉ là ảnh JPG / PNG import vào cũng dùng được (lề trắng có sẵn trong ảnh thì vẫn còn).
• Hộp thoại cho xem trước: tủ nào Có link (giữ nguyên, không tốn lượt), tủ nào Xuất mới / Cập nhật → bấm Xuất sa bàn. Tủ Có link mà anh đã sửa nhưng plugin chưa nhận ra → bấm Xuất lại ở dòng tủ đó. Có link cũ sắp bị đè (link sa bàn, tủ cần cập nhật) → 2 nút: Xuất sa bàn · cập nhật link cũ hoặc Xuất sa bàn · tạo link mới (link cũ giữ nguyên như khách đang xem). Mỗi tủ vẫn 1 link riêng (Tầng / Phòng tự theo tag), thêm 1 link sa bàn cho cả tầng.
• Khách mở link sa bàn: mặt bằng + các tủ 3D đứng đúng chỗ, nhãn tên trên nóc từng tủ. Chạm nhãn = chọn tủ + bay tới; Cánh / Tag / Tấm dùng như link thường. Đo kích thước 1 tủ: mở link riêng của tủ đó.
• Sửa 1 tủ → Cập nhật link tủ đó là sa bàn tự thấy bản mới. Dời tủ / thêm tủ → chọn group tầng bấm ✓ lại (cập nhật link sa bàn cũ, hoặc tạo link mới để giữ bản khách đang xem).

Khách · Tầng · Phòng

• Tầng / Phòng tự điền theo tag của group bao tầng / phòng chứa vật: 3. Tầng 1 → Tầng 1, 4. Phòng ngủ 2 → Phòng ngủ 02, 4. Kitchen & dining → Bếp – phòng ăn… (hiểu cả tên Việt lẫn tên Anh của bảng tag). Tag đúng dạng có dấu chấm (3. / 4.) được gắn luôn, kể cả tên riêng như 4. Phòng khám (tự thêm vào danh sách). Tag kiểu cũ (vd 4_bep) chỉ gợi ý: tên mới hiện dấu ✦ và được thêm khi bấm ✓.
• Khách được nhớ theo file .skp: lần sau xuất từ file đó tự chọn sẵn. Chọn trước được ngay trên thanh đáy SketchUp (ở trên).
• Danh sách Khách / Tầng / Phòng sửa ở Cài đặt hoặc trên web.

Gói gửi khách gồm gì

• Xem từng module: tủ có module con (tủ trên, tủ dưới…) cũng thuộc tag nội thất và có tấm bên trong → khách chạm 2 lần vào 1 module để xem riêng.
• Nút Cánh trên điện thoại = tag 9. Cánh tủ; nút LED = tag 9. LED. Mở link là cánh luôn hiện, kể cả lúc xuất đang tắt tag cánh. Tag khác đang tắt lúc xuất thì khách không thấy. Mô hình có tag (kể cả thư mục tag lồng nhau) → khách có nút Tag với con mắt bật / tắt từng tag, từng thư mục.
• Không đưa vào gói (khách duyệt tủ, không cần): vật thuộc tag 7. Vật dụng trang trí, 7. Cây xanh trong nhà, 7. Rèm, 7. Đèn trang trí, tag thông tin !…, tham chiếu ~… và #Ẩn. Vật trong SketchUp giữ nguyên.
• Ảnh vân gỗ / đá thu nhỏ còn 512 px (WebP) — đủ xem tủ, mở nhanh trên điện thoại.
• Giới hạn 1 gói: 300.000 tam giác và 5 MB (đã nén).
• Copy 1 vật đã xuất → bản sao không mang link của bản gốc; xuất bản sao ra link mới.

Tag plugin dùng — hệ tag TVN-5D v2

Từ bản 1.0.9. Mỗi tag có tên Việt và tên Anh, file dùng tên nào cũng được; không phân biệt hoa / thường, 7.Nội thất rời viết liền vẫn nhận. Tag cũ (I. FURNITURE, I. NỘI THẤT, I. DECORATION, 7_MF_CANHTU, 7_MF_LED…) không còn dùng: đổi tên tag trong SketchUp theo bảng dưới. Link đã gửi khách trước đó vẫn xem bình thường.

Vật chưa thuộc tag nội thất → bấm ✓ tự chuyển vào 7. Nội thất (file dùng tên Anh: 7. Built-in furniture).

• 2 tầng: xanh = phủ bì rộng × cao từng module (tag 7. Nội thất / 7. Nội thất rời; nhiều module → thêm phủ bì cả bộ ở vòng ngoài) · vàng = lọt lòng khoang, chỉ hiện khi thấy được bên trong.
• Dim nằm trên mặt ngoài cánh tủ. Mỗi khoang ghi 2 cạnh; khoang chồng nhau cùng rộng / cột cạnh nhau chia đợt giống nhau → ghi 1 lần (vd tủ áo 3 vùng: chuỗi cao vùng trái kéo ra trái, 2 vùng giống nhau chung 1 chuỗi bên phải, nóc ghi đủ bề ngang các khoang).
• Theo góc nhìn: chính diện → rộng + cao · nhìn hông → sâu + cao trên mặt hông · từ trên xuống → dài + sâu trên nóc · ra sau lưng → còn phủ bì, tắt lọt lòng.
• Dim ngắn quá hoặc đè chữ nhau → tạm ẩn, phóng to là hiện.
• Tủ góc chữ L (nóc / đáy 1 tấm chữ L): dim theo từng chân — dài dọc mỗi tường, sâu từng chân, lọt lòng trên mặt mở của chân đó. Góc trong bo cung → nhìn từ trên thấy R (bán kính).
• Điện thoại: chữ dim nhỏ hơn; nhìn xa chỉ có dim xanh, phóng gần mới hiện dim vàng. Nhiều module đứng cạnh nhau → dim cách đều theo phủ bì cả bộ, không theo từng module.
• Vật thuộc tag thiết bị 8. … (8. Thiết bị bếp, 8. Điện gia dụng… — bếp, lò, tủ lạnh đặt vào tủ) vẫn có trong 3D nhưng không đo, không tính vào phủ bì.
• Tắt: bấm × trên nút Đo (máy tính: Esc).

• Tìm: gõ số tấm hoặc quét tem bằng camera → mô hình bay tới tấm đó, tô sáng.
• Nhiều máy cùng kiểm: gửi đúng 1 link như gửi khách, đọc mã kiểm cho thợ. Thợ mở Tấm, nhấn giữ nút Tìm 3 giây → nhập mã 1 lần, không cần đăng nhập. Khách không thấy nút Kiểm nên không bấm nhầm. Máy này quét, các máy kia thấy ngay (khoảng 1 giây). Máy đứng chờ không tải gì.
• Nhập sai mã 3 lần: hộp nhập đóng, máy đó không kiểm được mô hình này nữa. Đổi mã (thanh đáy → ✓ Cập nhật): máy đang dùng mã cũ thoát Kiểm ngay. Chưa đặt mã: chỉ chủ kiểm được, người khác giữ nút Tìm không thấy gì.
• Mất mạng: vẫn quét được, chấm góc trên đổi từ xanh sang vàng; có mạng lại tự gửi bù.
• Chủ bấm ↻ = quét lại từ đầu (bấm 2 lần). Thoát Kiểm: × (máy tính: Esc).

• Chạm huy hiệu → thẻ góc trên phải: tên · link · ngày xuất + còn bao nhiêu ngày. Chạm thẻ để đóng.
• Vật đã có link → ✓ → hộp thoại hỏi: Cập nhật link cũ = gửi bản mới lên đúng link cũ, khách mở lại QR đã gửi là thấy bản mới · Tạo link mới, giữ link cũ = link cũ giữ y nguyên như khách đang xem (cả báo cáo kiểm), vật trong file chuyển sang link mới. Có cảnh báo đỏ khi link đang gắn khách khác khách của file (vd Save As dự án cũ), hoặc link đã được cập nhật ở máy / file khác mới hơn. Xuất nhiều: chọn 1 lần cho cả lượt.
• Xem lại mở trang QR / link / Khách · Tầng · Phòng của vật — không tải lên, không trừ lượt. Vật đã sửa / hết hạn thì trang nhắc bấm Cập nhật.

Bản vẽ nặng, bấm Xuất 3D có bị treo SketchUp không?

Không (từ 1.0.4): plugin đọc mô hình từng mẻ nhỏ, hộp thoại có vòng quay + %, SketchUp vẫn thao tác được. Bấm × hoặc đóng hộp thoại để huỷ.

Báo "Quá nặng (… tam giác)"

Gói vượt 300.000 tam giác. Bỏ vật nặng (viền đỏ), ẩn đồ trang trí, hoặc xuất từng hạng mục nhỏ hơn (vd từng tủ thay vì cả phòng).

Báo "Chỉ chọn 1 vật thể để chia sẻ"

Chọn đúng 1 Group / Component ở cấp đang mở. Muốn gửi nhiều món một lần: gom chúng vào 1 group rồi xuất group đó.

Hết 10 lượt dùng thử

Mua gói (mục 9). Mô hình đã xuất vẫn xem / xoá được.

Đăng nhập máy mới thì báo hết chỗ thiết bị

Vào Cài đặt ở máy cũ (hoặc trang được mở khi đăng nhập) xoá 1 máy không dùng nữa, hoặc Mua thêm máy. Dùng thử: 1 máy · đã mua: 2 máy + máy mua thêm.

Chủ không muốn đăng nhập Gmail trên máy nhân viên

Dùng Máy nhân viên: nhân viên bấm Máy nhân viên, gửi link cho chủ, chủ bấm Duyệt trên điện thoại.

Nhân viên nghỉ việc

Cài đặt › bút ở máy người đó › Thu hồi mọi máy của …. Có hiệu lực ở lần máy đó gọi máy chủ kế tiếp.

Báo "Thử quá nhiều lần — đợi 10 phút"

Bấm đăng nhập / xuất liên tục quá nhanh — đợi 10 phút rồi thử lại.

Bấm Đo chỉ thấy phủ bì, không có lọt lòng

Cánh đang che khoang: bấm Cánh để ẩn. Trên điện thoại khoang còn nhỏ: phóng to, hoặc chạm 2 lần vào 1 tủ để xem riêng.

Thợ giữ nút Tìm mà báo đã nhập sai 3 lần

Máy đó đã nhập sai mã kiểm 3 lần nên thôi kiểm mô hình này. Dùng máy khác, hoặc chủ đăng nhập web trên máy đó (chủ luôn kiểm được). Nên đặt mã 6 số, khó đoán hơn 4 số.

Chưa đặt mã kiểm thì ai kiểm được?

Chỉ chủ mô hình (đăng nhập web). Người khác giữ nút Tìm không thấy gì. Muốn thợ kiểm: chọn vật → Mã kiểm ▾ đặt mã → ✓ Cập nhật, rồi đọc mã cho thợ.

Khách mở link báo hết hạn

Link dùng thử sống 90 ngày: chọn vật → ✓ Cập nhật để mở lại. Gói đã mua: link không hết hạn.

"Không kết nối được"

Kiểm tra mạng rồi bấm Thử lại. Chi tiết lỗi: Window › Ruby Console.