Chương 4: Luồng khởi động (Boot Flow)

1. Tổng quan luồng khởi động từ BeforeSceneLoad đến Home

flowchart TD
    START(["Người chơi mở app"]) --> B1

    subgraph P1["Giai đoạn 1 · Bootstrapper (BeforeSceneLoad)"]
        B1["Load CoreConfig từ Resources"] --> B2["Tạo GameObject [Core]
(DontDestroyOnLoad)"]
        B2 --> B3["Tạo + đăng ký mọi service
vào ServiceLocator"]
        B3 --> B4["InitPipeline.Run()
(chạy nền, từng bước có timeout)"]
    end

    B4 --> L1

    subgraph P2["Giai đoạn 2 · Scene Loading + GameEntry (AfterSceneLoad)"]
        L1["Loading.unity hiện thanh tiến trình"] --> G1["GameEntry.Init():
GameWallet, LevelProgress,
SetGrantHandler, RC defaults"]
    end

    G1 --> S1

    subgraph P3["Giai đoạn 3 · 10 bước InitPipeline (tuần tự)"]
        S1["ATT → Firebase → Auth → Remote Config"] --> S2["RTDB + BI → Ads (MAX)"]
        S2 --> S3["GameAnalytics + AppMetrica → IAP"]
        S3 --> S4["Notifications → Background"]
    end

    S4 --> H1

    subgraph P4["Giai đoạn 4 · Vào Home"]
        H1{"Pipeline xong VÀ đủ
minLoadingSeconds (1.5s)?"} -->|"Có"| H2["SceneLoader.Load(SceneId.Home)
(fade, 90% → 100%)"]
        H2 --> H3(["Home sẵn sàng"])
    end
          

2. Chi tiết 4 giai đoạn khởi động

Giai đoạn 1: Bootstrapper (Trước khi Scene đầu tiên load)

Hàm Bootstrapper.Boot() chạy tại thời điểm BeforeSceneLoad. Nhiệm vụ gồm:

1. Đọc cấu hình: Tải CoreConfig.asset từ Resources/CoreConfig. Nếu thiếu, tự tạo instance tạm thời và báo lỗi trong Console.
2. Cấu hình thiết bị: Đặt Application.targetFrameRate = 60, tắt Input.multiTouchEnabled = false.
3. Tạo Root hạ tầng: Sinh một GameObject tên là [Core] mang cờ DontDestroyOnLoad, gắn component CoreHost (dùng để host coroutine cho các class C# thuần).
4. Khởi tạo và Đăng ký Services: Tạo mới toàn bộ đối tượng dịch vụ và đưa vào ServiceLocator ngay từ đầu:
   • Hạ tầng: CoreConfig, CoreHost, UserIdentity, UIOverlay, SceneLoader, DialogService, AudioService, HapticService.
   • Dịch vụ dữ liệu & SDK: AnalyticsService (kèm 3 sink), FirebaseService, RemoteConfigService, RealtimeDbService, BIService, AttService, IAdsService (MaxAdsService), IIapService (IapService), NotificationService, AppUpdateService, ReviewService, SearchAdsService.
5. Khởi chạy InitPipeline: Đưa 10 bước cấu hình vào pipeline và kích hoạt.

Giai đoạn 2: InitPipeline - 10 bước có giới hạn thời gian (Time-boxed)

Mỗi bước trong pipeline đều có một hạn mức thời gian (timeout) riêng biệt. Nếu quá thời gian này hoặc phát sinh lỗi, hệ thống sẽ ghi log cảnh báo, hủy coroutine của bước đó và chuyển ngay sang bước kế tiếp.

Giai đoạn 3: GameEntry (Composition Root phía Game)

Ngay sau khi scene đầu tiên nạp xong, hàm GameEntry.Init() được kích hoạt thông qua [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.AfterSceneLoad)]. Vì Core đã boot xong ở BeforeSceneLoad, tại đây bạn hoàn toàn có thể gọi các service của Core:

// File: Assets/_Project/Game/GameEntry.cs
[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.AfterSceneLoad)]
private static void Init()
{
    // Ngăn ngừa khởi tạo 2 lần nếu scene reload
    if (ServiceLocator.TryGet(out _)) return;

    // 1. Tạo và đăng ký các dịch vụ sống suốt game (Meta)
    var wallet = new GameWallet();
    ServiceLocator.Register(wallet);
    ServiceLocator.Register(new LevelProgress());

    // 2. Đăng ký hàm cấp thưởng IAP: Core sẽ gọi hàm này khi có đơn hàng thành công
    App.Iap.SetGrantHandler(wallet.GrantProduct);

    // 3. Đăng ký giá trị mặc định cho Remote Config của game (khi offline)
    App.RemoteConfig.AddDefault(GameKeys.RcWinCoins, "50");

    // 4. Tạo Debug panel (chỉ tồn tại trong Editor và bản build Development)
    var debug = new GameObject("[DebugPanel]");
    Object.DontDestroyOnLoad(debug);
    debug.AddComponent();
}

Giai đoạn 4: LoadingScreen chuyển sang Home

Script LoadingScreen.cs trong scene Loading.unity thực hiện một vòng lặp kiểm tra:

1. Cập nhật thanh tiến trình giao diện mượt mà từ 0% đến 90% dựa trên Bootstrapper.Pipeline.Progress.
2. Chờ cho đến khi cả 2 điều kiện được thỏa mãn:
   • Bootstrapper.Pipeline.IsDone == true (Tất cả các bước pipeline đã xong hoặc đã timeout).
   • Thời gian hiển thị đã đạt ít nhất CoreConfig.minLoadingSeconds (mặc định là 1.5 giây để người chơi kịp nhìn thấy logo thương hiệu và tránh màn hình bị giật).
3. Khi thỏa mãn, thanh tiến trình chạy nốt 10% cuối cùng và gọi:

   ServiceLocator.Get().Load(SceneId.Home, fade: true);

3. Các tình huống ngoại lệ đặc biệt

Tình huống 1: Người chơi mở game khi MẤT MẠNG (Offline)

Game mobile casual thường xuyên được chơi trên máy bay hoặc nơi sóng yếu. Khi offline:

• Bước Firebase kiểm tra dependencies nhanh chóng nhận diện không có kết nối.
• Bước Auth timeout sau 5s và bỏ qua.
• Bước Remote Config timeout sau 4s, trả về các giá trị offline mặc định trong CoreConfig và GameEntry (ví dụ: thưởng thắng level là 50 coins).
• Quảng cáo MAX và Store IAP ghi nhận chưa sẵn sàng (IsReady = false).
• Thanh loading vẫn chạy đủ 1.5s và đưa người chơi vào Home để chơi offline bình thường!

Tình huống 2: Lập trình viên bấm Play trực tiếp ở Scene Main

Khi bạn đang sửa gameplay và muốn test ngay, bạn mở scene Main.unity trong Editor và bấm Play. Điều gì xảy ra?