# Extension tải model 3D từ web vào studio

> Cài adayroi Model Grabber cho Chrome để bắt model GLB/FBX từ Neural4D, Tripo và đẩy thẳng vào thư viện model của Director Studio. Có ảnh từng bước và video làm mẫu.
Nguồn: https://studio.adayroi.online/docs/extension-tai-model-tu-web

**adayroi Model Grabber** là một extension cho Chrome (và các trình duyệt cùng nhân: Edge, Brave, Cốc Cốc). Khi bạn xem một model 3D trên **Neural4D** hoặc **Tripo**, extension bắt được file model mà trang nạp vào viewer (GLB, glTF, OBJ, FBX, STL, PLY, USDZ…) rồi cho bạn **tải về máy** hoặc **đẩy thẳng vào adayroi studio** để thêm vào thư viện model. Không cần tìm nút Download của trang, không cần đổi tên file.

> Chỉ dùng cho model bạn có quyền sử dụng: model do chính bạn tạo, hoặc được chủ sở hữu cho phép tải.

## Xem video làm mẫu

Video dưới đây đi trọn một lượt: mở trang model trên Neural4D, bấm icon extension, bấm **Đẩy vào Studio**, rồi cửa sổ **Tải model lên** của Director Studio tự mở và lưu model vào thư viện.

![Video: đẩy model từ Neural4D vào adayroi studio bằng extension](https://drive.adayroi.online/of/9217/video-extension-model-grabber.mp4/)

## Bước 1 · Tải extension

**[⬇ Tải adayroi Model Grabber (.zip)](/downloads/adayroi-model-grabber.zip)**

Bản hiện tại: **0.2.0**. Extension chưa có trên Chrome Web Store nên bạn cài theo cách "Load unpacked" bên dưới, mất khoảng một phút.

## Bước 2 · Cài vào Chrome

1. Giải nén file zip ra một thư mục, ví dụ `Documents\adayroi-model-grabber`. **Giữ nguyên thư mục này sau khi cài**, đừng xoá hay di chuyển: Chrome chạy extension từ chính thư mục đó.
2. Mở Chrome, gõ vào thanh địa chỉ `chrome://extensions` rồi Enter.
3. Bật công tắc **Developer mode** (Chế độ nhà phát triển) ở góc trên bên phải. Hàng nút **Load unpacked · Pack extension · Update** sẽ hiện ra.

![Trang chrome://extensions với Developer mode đã bật và nút Load unpacked](https://studio.adayroi.online/media/public/docs/guide/extension-chrome-extensions.webp)

4. Bấm **Load unpacked** (Tải tiện ích đã giải nén) và chọn thư mục vừa giải nén. Thẻ **adayroi Model Grabber** xuất hiện trong danh sách, công tắc bật sẵn.
5. Bấm biểu tượng mảnh ghép trên thanh công cụ, chọn ghim **adayroi Model Grabber** để icon luôn hiện.

Với Edge dùng địa chỉ `edge://extensions`, bật **Developer mode** ở góc dưới bên trái rồi bấm **Load unpacked**; Brave dùng `brave://extensions`. Các bước còn lại giống hệt.

![Thẻ adayroi Model Grabber sau khi cài, ở đây trên Edge](https://studio.adayroi.online/media/public/docs/guide/extension-da-cai.webp)

## Bước 3 · Mở adayroi studio

Mở adayroi studio (phiên bản 0.1.28 trở lên) trước khi đẩy model. Extension tìm app đang chạy trên máy qua cổng nội bộ; app chưa mở thì nút **Đẩy vào Studio** bị mờ.

Trong Director Studio, model đẩy sang sẽ vào thẳng cửa sổ **Tải model lên**; nếu bạn đang ở màn hình dự án, app chỉ báo đã nhận và đợi bạn mở một Director Studio (xem bước 5).

## Bước 4 · Bắt model trên trang xem model

1. Trên `neural4d.com` (mục **Community › 3D Models** hoặc **Assets** của bạn) bấm vào một model để mở trang xem. Với Tripo là `studio.tripo3d.ai`.
2. Đợi model hiện rõ trong viewer: lúc này file đã được nạp và extension đã bắt được. Icon extension hiện con số là số file bắt được.

![Trang xem model trên Neural4D sau khi model đã hiện trong viewer](https://studio.adayroi.online/media/public/docs/guide/extension-trang-model.webp)

3. Bấm icon **Model Grabber** trên thanh công cụ để mở bảng điều khiển:

![Bảng điều khiển của extension: Studio đã kết nối, danh sách file bắt được, nút Tải và Đẩy vào Studio](https://studio.adayroi.online/media/public/docs/guide/extension-popup.webp)

   - Góc trên phải: chấm xanh **Studio v0.1.28** nghĩa là đã thấy app; **Studio chưa mở** nghĩa là chưa. Bấm vào đó để kiểm tra lại.
   - Mỗi dòng là một file bắt được, có đuôi (GLB, OBJ…), dung lượng và địa chỉ gốc. Tên file đặt theo tên model trên trang.
   - **Tải** lưu file đó về máy; **Đẩy vào Studio** gửi sang adayroi studio.
   - **Tải tất cả** / **Đẩy vào Studio** ở hàng trên áp dụng cho mọi file trong danh sách; **↻** quét lại, **✕** xoá danh sách.
   - Nhãn **chỉ URL** nghĩa là extension mới thấy đường dẫn chứ chưa có nội dung (file nạp trước khi extension kịp theo dõi, hoặc link đã hết hạn). Với dòng này nút Đẩy vào Studio bị mờ: tải lại trang (F5), đợi model hiện rồi mở lại bảng.
4. Bấm **Đẩy vào Studio** ở file GLB bạn muốn. Dòng trạng thái cuối bảng báo **Đã gửi … vào studio**. File lớn (vài chục MB) mất vài giây.

Khi một trang có cả OBJ lẫn GLB (như Neural4D), hãy chọn **GLB**: file có vật liệu và texture đầy đủ, nhẹ hơn và studio dựng đúng màu.

### Ở trang danh sách

Trên các trang danh sách model của **Tripo**, rê chuột lên một thẻ model: góc trên trái thẻ hiện hai nút **Tải** và **Studio**. Bấm nút, extension tự mở trang model ở một tab nền, bắt file, tải về hoặc đẩy vào studio rồi đóng tab đó. Bạn không cần mở từng model.

Trang **Community** của Neural4D hiện không đặt link trên thẻ model nên hai nút này chưa hiện ở đó; bạn bấm mở model rồi dùng bảng điều khiển như trên.

![Trang Community › 3D Models của Neural4D](https://studio.adayroi.online/media/public/docs/guide/extension-cong-dong.webp)

## Bước 5 · Nhận model trong adayroi studio

**Đang mở một Director Studio:** cửa sổ **Tải model lên** tự mở với file vừa nhận, giống như khi bạn kéo thả file vào studio. Các bước trong cửa sổ:

![Cửa sổ Tải model lên tự mở với model vừa nhận, bước Dựng & tỉ lệ](https://studio.adayroi.online/media/public/docs/guide/extension-them-model.webp)

1. **Dựng & tỉ lệ**: chọn loại model (Đồ vật & đạo cụ, Nhân vật, Phương tiện…), xoay cho model đứng thẳng và mặt trước hướng theo mũi tên xanh, rồi nhập **cạnh dài nhất** theo mét. Người mẫu cao 1,75 m đứng bên cạnh để bạn so kích thước. Bấm **Tiếp tục**.
2. **Thông tin**: đặt tên, nhóm, thời kỳ, từ khóa để tìm lại sau. Bấm **Tiếp tục**.
3. **Hành vi**: khai báo ghế ngồi, bánh xe, cửa… nếu model có, để model dùng được các chuyển động trong thư viện hành động. Bấm **Lưu model**.

**Chưa mở Director Studio:** một thông báo nhỏ ở góc dưới phải cho biết **Nhận 1 model từ extension trình duyệt**. Mở Director Studio bất kỳ, cửa sổ Tải model lên sẽ hiện ra với các file đang chờ. Bấm **Bỏ qua** nếu không muốn nhận nữa.

![Thông báo nhận model ở góc dưới phải khi chưa mở Director Studio](https://studio.adayroi.online/media/public/docs/guide/extension-thong-bao.webp)

Model đã lưu nằm trong **Thư viện › Quản lý model › Model tải lên** của Director Studio, dùng được cho mọi dự án: bấm **Thêm vào cảnh** để đưa vào cảnh đang mở.

![Quản lý model: model vừa đẩy sang nằm trong mục Model tải lên](https://studio.adayroi.online/media/public/docs/guide/extension-thu-vien.webp)

## Khắc phục sự cố

| Hiện tượng | Cách xử lý |
| --- | --- |
| Bảng extension báo **Studio chưa mở** | Mở adayroi studio, đợi vài giây rồi bấm vào chấm trạng thái để kiểm tra lại. Phần mềm diệt virus hoặc tường lửa chặn kết nối nội bộ (127.0.0.1) cũng gây ra lỗi này. |
| Không bắt được file nào | Trang có thể yêu cầu đăng nhập mới nạp model. Đăng nhập, tải lại trang (F5) và đợi model hiện rõ trong viewer. |
| File hiện nhãn **chỉ URL**, nút Đẩy vào Studio bị mờ | Extension chỉ thấy đường dẫn, chưa có nội dung. Tải lại trang để bắt lại nội dung, hoặc dùng nút Tải. |
| Model đẩy sang nhưng studio không mở cửa sổ Tải model lên | Đóng hộp thoại đang mở trong Director Studio (ví dụ Quản lý model) rồi thử lại; model đang chờ sẽ tự vào. |
| Cửa sổ Tải model lên báo **Model khá nặng** | Model trên 400 nghìn tam giác vẫn dùng được nhưng dựng chậm; nên chọn bản GLB nhẹ hơn nếu trang có. |
| Chrome hỏi nơi lưu mỗi lần tải | Đó là cài đặt của Chrome: Settings › Downloads › tắt "Ask where to save each file before downloading". |

![Bảng điều khiển khi chưa mở adayroi studio: chấm xám Studio chưa mở, nút Đẩy vào Studio bị mờ](https://studio.adayroi.online/media/public/docs/guide/extension-popup-chua-mo.webp)

## Cập nhật extension

Tải bản zip mới từ trang này, giải nén đè lên thư mục cũ, rồi vào `chrome://extensions` bấm **Reload** (biểu tượng ↻) trên thẻ của extension.