51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
---
|
|
summary: "Ứng dụng iOS (Nút mạng): Kết nối với Gateway, ghép nối, canvas và xử lý sự cố"
|
|
read_when:
|
|
- Bạn đang ghép nối hoặc kết nối lại thiết bị iOS
|
|
- Bạn đang chạy thử ứng dụng iOS từ mã nguồn
|
|
---
|
|
|
|
# Ứng dụng iOS (Nút mạng)
|
|
|
|
Trạng thái: Đang thử nghiệm nội bộ. Ứng dụng iOS hiện chưa được phát hành rộng rãi trên App Store.
|
|
|
|
## Tính năng chính
|
|
- Kết nối tới Gateway qua WebSocket (mạng LAN hoặc mạng ảo Tailscale).
|
|
- Cung cấp các khả năng cho nút mạng: Hiển thị Canvas, Chụp màn hình, Chụp ảnh camera, Định vị, Chế độ đàm thoại và Đánh thức bằng giọng nói.
|
|
- Nhận các lệnh điều khiển `node.invoke` từ Agent.
|
|
|
|
## Yêu cầu
|
|
- Đã chạy Gateway trên một thiết bị khác (macOS, Linux hoặc Windows qua WSL2).
|
|
- Đường truyền mạng:
|
|
- Cùng mạng LAN (qua Bonjour).
|
|
- Hoặc qua mạng Tailscale.
|
|
- Hoặc nhập địa chỉ IP thủ công.
|
|
|
|
## Bắt đầu nhanh (Ghép nối + Kết nối)
|
|
|
|
1. **Khởi động Gateway** trên máy tính:
|
|
```bash
|
|
moltbot gateway --port 18789
|
|
```
|
|
|
|
2. **Trên điện thoại iOS**, mở mục Settings và chọn máy chủ Gateway tìm thấy được (hoặc nhập thủ công).
|
|
|
|
3. **Phê duyệt ghép nối** trên máy tính:
|
|
```bash
|
|
moltbot nodes pending
|
|
moltbot nodes approve <requestId>
|
|
```
|
|
|
|
4. **Kiểm tra kết nối**:
|
|
```bash
|
|
moltbot nodes status
|
|
```
|
|
|
|
## Các lỗi thường gặp
|
|
- `NODE_BACKGROUND_UNAVAILABLE`: Hãy mở ứng dụng iOS lên màn hình chính (các lệnh canvas/camera/màn hình yêu cầu ứng dụng phải đang hiển thị phía trước).
|
|
- `A2UI_HOST_NOT_CONFIGURED`: Gateway chưa được cấu hình máy chủ Canvas; hãy kiểm tra lại file `moltbot.json`.
|
|
- Yêu cầu ghép nối không xuất hiện: Hãy chạy lệnh `moltbot nodes pending` để kiểm tra và phê duyệt thủ công.
|
|
|
|
---
|
|
Tài liệu liên quan: [Ghép nối](../../gateway/pairing.vi.md), [Tìm kiếm thiết bị](../../gateway/discovery.vi.md).
|