Tài liệu ProjectV-SDK

ProjectV-SDK là V3 Unity SDK của ProjectV. Game chỉ giao tiếp với backend Nakama thông qua SDK này: SDK quản lý session, realtime, cache, khôi phục và mọi giá trị do server quyết định, rồi trao cho game các presenter sẵn sàng cho từng màn.

Nakama (ProjectZ/Nakama v3)
  -> Shared SDK (com.silvertiger.crosssdk.*, built from ProjectZ-CrossSDK)
  -> ProjectV-SDK (com.silvertiger.projectv.*, this repository)
  -> ProjectV Client (game scenes and UI)

Tài liệu được chia theo đối tượng đọc. Hãy chọn phần của bạn.

🎮 Hướng dẫn Client

Dành cho team ProjectV Client (game): SDK cung cấp gì cho từng màn và cách dùng. Inject một screen contract hoặc presenter, vẽ (render) dữ liệu nó đưa và gọi các command (lệnh) của nó. Bạn không bao giờ gọi backend hay tự tính ví, stamina (thể lực), phần thưởng hay tiến trình.

→ Bắt đầu tại đây: Tổng quan · Cài đặt và thiết lập · Screen contract · Tham chiếu presenter · Chuyển đổi từ V1

🛠 Team SDK

Dành cho người bảo trì ProjectV-SDK. Bạn thêm presenter và các capability có kiểu, build và phát hành package qua BuildOps, và giữ tài liệu này khớp với API đã phát hành.

→ Bắt đầu tại đây: Tổng quan team SDK · Kiến trúc · Thêm một presenter · Quy trình phát hành

---

Ba lớp

1. Shared SDK (com.silvertiger.crosssdk, không phụ thuộc game): session, realtime, cache, Unity host.
2. ProjectV-SDK (com.silvertiger.projectv): contract của ProjectV, binding Nakama, screen contract và presenter, VContainer, hỗ trợ đăng nhập Google và IAP.
3. ProjectV Client: scene, UI, điều hướng và gameplay. Client chỉ dùng lớp 2 qua screen contract và presenter.

Hướng dẫn Client nói về lớp 3. Hướng dẫn team SDK nói về lớp 2 và cách phát hành lớp 1 và 2.

V1 (các Manager API của ProjectZ-CrossSDK như IPlayerManager) đã ngừng sử dụng. Các trang này thay thế site V1; xem Chuyển đổi từ V1 để biết cách ánh xạ từ Manager sang presenter.