Hướng dẫn Client — Tổng quan

SDK cung cấp cho mọi màn của game dữ liệu cần hiển thị và các command (lệnh) cần gọi. Team Client xây scene, UI và gameplay trên nền đó. Ví, kho đồ, stamina (thể lực), tiến trình, phần thưởng và kết quả nhiệm vụ luôn đến từ SDK; Client không bao giờ tự tính chúng.

Bạn nhận được gì

Bạn dùng	Cho	Cách dùng
Screen contract: IProjectVLobbyScreen, IProjectVCharacterScreen, IProjectVAllianceScreen, IProjectVCampaignScreen, IProjectVShopScreen	Năm màn dữ liệu	Inject, Observe(render), gọi command. Xem Screen contract
Presenter: IProjectVStartupPresenter, IProjectVAuthenticationPresenter, IProjectVAccountPresenter, IProjectVHeaderPresenter	Đăng nhập, popup tài khoản, thanh trên cùng	Inject, SubscribeAsync(listener), gọi command
IProjectVGameplayDataConsumer	Scene nhiệm vụ	Implement một lần cho mỗi scene gameplay. Xem Dữ liệu gameplay
ProjectVLoginSceneScope, ProjectVAuthenticatedSceneScope	LifetimeScope của scene	Kế thừa một scope cho mỗi scene. Xem Tích hợp scene
ProjectVSettings	Môi trường backend, endpoint, server key	Cấu hình asset một lần. Xem Cài đặt và thiết lập

Mọi type đều nằm trong một namespace SilverTiger.ProjectV.Unity.Presentation.*. Danh sách đầy đủ ở Tham chiếu presenter.

Quy tắc cho mọi màn

1. Inject interface. Dùng screen contract khi màn có; nếu không thì dùng presenter của nó. Không bao giờ tự tạo, tự tìm hay tự cache chúng.
2. Vẽ những gì được đưa. Observe và SubscribeAsync gọi bạn với dữ liệu hiện tại và gọi lại mỗi khi dữ liệu thay đổi. Giữ IDisposable trả về và dispose (giải phóng) nó khi trang đóng. Không bao giờ poll hay tải lại theo timer.
3. Mỗi lần bấm gọi command một lần. Command trả về việc server có xác nhận hành động hay không, và một thông báo để hiện khi không xác nhận. Màn tự vẽ lại qua Observe; đừng refresh sau một command.
4. Không bao giờ tự tính giá trị backend. Hiện số dư, stamina, chi phí, phần thưởng, trạng thái khoá và sao đúng như SDK đưa.
5. Không bao giờ gọi backend trực tiếp. Không dùng type Nakama, không gọi RPC, không tạo SDK root thứ hai.

Các bước tích hợp

Add the two SDK packages to Packages/manifest.json
-> run Tools > SilverTiger > ProjectV SDK > Setup in the Login scene
-> fill in ProjectVSettings (environment, endpoint, server key)
-> Login scene: Startup + Authentication presenters
-> other scenes: screen contracts and the Header presenter
-> mission scene: one IProjectVGameplayDataConsumer
-> check login, logout and account switching
-> go through the release checklist

Tiếp theo: Cài đặt và thiết lập → Tích hợp scene → Screen contract → Tham chiếu presenter.