Hướng dẫn sử dụng MGW SDK (com.mgw.sdk)
Làm lần đầu theo thứ tự này
Chương 2 (cài đặt và cấu hình) → Chương 1 (gọi dịch vụ đầu tiên) → các chương dịch vụ 3–8 theo nhu cầu của game → Chương 10 (bài thực hành trọn vẹn) → Chương 11 (nghiệm thu).
1. Mục lục hướng dẫn
| Chương | Bạn sẽ làm được | Nội dung chính |
|---|---|---|
| 1. Bắt đầu: truy cập dịch vụ | Gọi được App.X đúng thời điểm, biết service nào đã sẵn sàng. |
using, App.X, ServiceLocator, bảng sẵn sàng của từng service, log khởi động. |
| 2. Cài đặt & Cấu hình | Cài package, điền CoreConfig, build được bản Release. |
Cài qua Git tag, SDK bên thứ ba, scene Loading, CoreConfig, SDK Settings, Build Guard. |
| 3. Quảng cáo (App.Ads) | Hiện banner, interstitial, rewarded, app open đúng chính sách. | TryShowInterstitial, ShowRewarded, AdsPolicy, Remove Ads. |
| 4. In-App Purchase (App.Iap) | Bán gói vật phẩm, khôi phục mua hàng, xác thực biên lai. | SetGrantHandler, Purchase, Restore, IReceiptValidator. |
| 5. Analytics (App.Analytics) | Gắn tracking màn chơi, tiền tệ, hướng dẫn, sự kiện tùy chỉnh. | Các hàm Level*, Stage*, Currency*, Event, LogEvent. |
| 6. Remote Config | Chỉnh thông số game từ xa, có giá trị mặc định ngoại tuyến. | Bind<T>, Get*, Updated, khóa mặc định trong CoreConfig. |
| 7. Hạ tầng & UI | Tạo popup, hàng đợi popup, đổi scene, lưu dữ liệu, âm thanh, haptic. | DialogBase, DialogService, DialogQueue, SceneLoader, LocalStorage. |
| 8. Dịch vụ nền tảng | Dùng ATT, cập nhật app, đánh giá app, Firebase, Realtime DB, thông báo cục bộ. | AttService, AppUpdateService, IReviewService, NotificationService... |
| 9. Chọn & Chuyển Provider | Chuyển giữa MGW và SayKit, bật GameAnalytics / AppMetrica, viết code chạy cả hai. | Menu chuyển stack, define, bảng khác biệt, Build Guard theo provider. |
| 10. Thực hành End-to-End | Tích hợp ads + IAP + analytics + remote config trong một vòng chơi. | Code đầy đủ từng bước và log mong đợi. |
| 11. Kiểm tra & Gỡ lỗi | Nghiệm thu bản build, đọc log, xử lý lỗi thường gặp. | Log khởi động chuẩn, bảng triệu chứng – nguyên nhân – cách sửa, Build Guard. |
| 12. Tra cứu nhanh & Quy chuẩn | Tra chữ ký API khi đang code. | Bảng API đầy đủ, quy tắc cho code game, thuật ngữ, FAQ. |
2. Các lệnh thường dùng
Đoạn mã dưới đây là bản rút gọn. Phiên bản đầy đủ (có using, ngữ cảnh gọi và lưu ý) nằm trong chương tương ứng.
| Nhu cầu thực hiện | Dòng code hoặc thao tác tương ứng |
|---|---|
| Hiện quảng cáo chèn (Interstitial) | App.Ads.TryShowInterstitial("level_end", () => OnNextLevel()); |
| Hiện quảng cáo nhận thưởng (Rewarded) | App.Ads.ShowRewarded("double_reward", res => { if (res == RewardedResult.Rewarded) GrantReward(); }); |
| Khởi tạo mua gói IAP | App.Iap.Purchase("coin_pack_small", res => UpdateShopUI(res)); |
Đăng ký bộ xử lý trao thưởng IAP (chỉ trả về true khi đã giao vật phẩm và lưu xong) |
App.Iap.SetGrantHandler(productId => Inventory.Deliver(productId)); |
| Gửi sự kiện kết thúc màn chơi | App.Analytics.LevelCompleted(level: 5, score: 1200); |
| Ánh xạ biến Remote Config tự động (gọi một lần duy nhất khi khởi động game) | App.RemoteConfig.Bind(myConfigInstance); |
| Mở một hộp thoại (Popup) | App.Dialogs.Show<ShopDialog>(); |
| Chuyển Scene có hiệu ứng mờ dần (Fade) | App.Scenes.Load(buildIndex: 1); |
| Lưu dữ liệu máy người chơi an toàn | LocalStorage.SetInt("game.coins", 500); LocalStorage.Save(); |
| Kiểm tra tính hợp lệ của cấu hình SDK | Unity Menu: TapBrain > Validate Core Config |
| Mở cửa sổ thiết lập Scripting Defines | Unity Menu: TapBrain > SDK Settings... |
| Chuyển đổi Provider sang SayKit hoặc MGW | Unity Menu: TapBrain > SDK > Switch To SayKit... / Switch To MGW... |