Chương 6: Cấu hình hệ thống tập trung

1. Chi tiết từng trường trong CoreConfig

Để mở nhanh file này trong Unity Editor, hãy vào menu: TapBrain → Select Core Config.

2. Quản lý Remote Config Keys

Template định nghĩa sẵn 3 key hệ thống trong danh sách remoteConfigDefaults của CoreConfig:

Cách thêm một key Remote Config mới:

1. Khai báo hằng số trong GameKeys.cs:

   public const string RcEnergyMax = "game_energy_max";

2. Đăng ký giá trị mặc định lúc offline trong GameEntry.Init():

   App.RemoteConfig.AddDefault(GameKeys.RcEnergyMax, "100");

3. Đọc giá trị ở bất cứ đâu trong code game:

   int maxEnergy = (int)App.RemoteConfig.GetLong(GameKeys.RcEnergyMax, 100);

3. Quản lý tập trung qua GameKeys.cs

Để tránh việc gõ sai chính tả chuỗi ký tự (typo) dẫn tới lỗi runtime khó tìm, mọi key của game đều được gom vào một static class duy nhất:

// File: Assets/_Project/Game/GameKeys.cs
namespace TapBrain.Game
{
    public static class GameKeys
    {
        // LocalStorage (quy ước: luôn có tiền tố "game.")
        public const string Coins = "game.coins";
        public const string Level = "game.level";

        // Remote Config
        public const string RcWinCoins = "game_win_coins";

        // Vị trí quảng cáo (Ad Placements)
        public const string PlacementLevelEnd = "level_end";
        public const string PlacementDoubleReward = "double_reward";
        public const string PlacementMainBack = "main_back";

        // IAP Product IDs
        public const string ProductCoinsSmall = "com.tapbrain.template.coins_small";
    }
}

4. Danh mục sản phẩm IAP (IAP Catalog)

Danh mục sản phẩm được quản lý trực quan qua cửa sổ của Unity IAP: Services → In-App Purchasing → IAP Catalog. Cửa sổ này sẽ lưu dữ liệu vào file Assets/Resources/IAPProductCatalog.json.

Mặc định template có 2 sản phẩm mẫu:

• com.tapbrain.template.coins_small: Loại Consumable (tiêu hao, mua được nhiều lần).
• com.tapbrain.template.removeads: Loại Non-consumable (vĩnh viễn, tự động tắt banner và interstitial).

5. Scripting Define Symbols & Player Settings

Trong Project Settings → Player → Scripting Define Symbols, template cấu hình sẵn define:

• gameanalytics_max_enabled: Định nghĩa này bắt buộc phải có trên Android và iOS để SDK GameAnalytics tự động đăng ký lắng nghe sự kiện doanh thu quảng cáo ILRD từ AppLovin MAX SDK.

6. Chốt chặn kiểm tra lúc Build (Build Guard)

Template tích hợp sẵn class CoreConfigTools.cs (triển khai interface IPreprocessBuildWithReport của Unity). Trước khi Unity tiến hành build:

• Nó quét toàn bộ file CoreConfig.asset và Bundle ID trong Player Settings.
• Nếu là build Development: Chỉ ghi cảnh báo vàng (Warning) trong Console nếu còn placeholder.
• Nếu là build Release: Nếu phát hiện bất kỳ trường nào vẫn còn là "REPLACE_ME" hoặc Bundle ID vẫn bắt đầu bằng com.tapbrain.template, Unity sẽ LẬP TỨC HỦY BUILD (BuildFailedException)!