---
doc_id: "DOC-CLI-001"
title: "Công Nghệ Client 2.5D Isometric & Tối Ưu Hóa Apple Metal 120Hz"
category: "client"
diataxis_type: "explanation"
status: "canonical"
version: "2026.1"
owner_role: "ios_client_engineer"
last_updated: "2026-09-29"
tags: ["ios", "metal", "120hz", "promotion", "zero-garbage", "performance"]
related_code:
  - "client/webapp/js/engine/world_renderer.js"
  - "client/webapp/js/engine/iso_math.js"
related_docs:
  - "docs/client/ISOMETRIC_COLLISION_BOUNDARIES_AND_PROP_SYSTEM.md"
summary: "Kiến trúc render Metal API trên iOS, hỗ trợ màn hình ProMotion 120Hz, Zero Garbage Object Pooling trong Hot Path."
---

# CÔNG NGHỆ CLIENT 2.5D ISOMETRIC & TỐI ƯU HÓA CHUYÊN SÂU NỀN TẢNG IOS (IPHONE)

## 1. TRIẾT LÝ ĐỒ HỌA 2.5D: TINH HOA VÕ LÂM 1 VỚI CÔNG NGHỆ ĐỒ HỌA HIỆN ĐẠI

Trò chơi huyền thoại *Võ Lâm Truyền Kỳ 1 (VLTK1)* ghi dấu ấn sâu đậm nhờ góc nhìn Isometric 2.5D kinh điển:
- **Tầm nhìn thoáng đãng, dễ quan sát trận chiến quy mô lớn**: Hàng ngàn nhân vật giao tranh cùng lúc mà người chơi vẫn nhìn rõ toàn cục.
- **Tải trọng phần cứng siêu nhẹ**: Nhẹ hơn rất nhiều so với thế giới 3D góc nhìn thứ ba, giúp điện thoại luôn mát mẻ, tiết kiệm pin tối đa.

Tuy nhiên, `FreeExile` nâng tầm đồ họa 2.5D lên chuẩn mực đồ họa đỉnh cao thế hệ mới (Next-Gen 2.5D):
1. **Dynamic 2D/3D Hybrid Pipeline (Sprite-Stacking & Normal-Mapped Sprites)**:
   - Các nhân vật và quái vật có mô hình 3D độ chi tiết cao được dựng sẵn và chiếu sáng bằng Normal Map thời gian thực.
   - Khi có nguồn sáng (ngọn đuốc, quả cầu lửa bay qua), bề mặt giáp trụ phản chiếu ánh sáng động (PBR Light Reflection) chân thực như một game 3D AAA, nhưng với chi phí tính toán chỉ bằng 1/10.
2. **GPU Particle VFX (Metal Compute Shaders)**:
   - Hàng triệu hạt hiệu ứng kỹ năng (băng giá, tia sét, khói lửa) được tính toán trực tiếp trên GPU Metal, đảm bảo mượt mà 120 FPS kể cả khi 50 người cùng lúc xả chiêu diện rộng.
3. **Sorting Layer & Depth Buffer Tối Ưu**:
   - Thuật toán sắp xếp thứ tự hiển thị trục Y (Y-Sorting) sử dụng Z-Buffer phần cứng, không gây hiện tượng chồng chéo hình ảnh (Z-fighting) khi nhân vật di chuyển qua tán cây, góc mái nhà.

---

## 2. NỀN TẢNG CÔNG NGHỆ CLIENT: COCOS CREATOR 3.8+ (TYPESCRIPT + NATIVE METAL)

| Tiêu Chí | Unity / Unreal Engine | Cocos Creator 3.8+ (Được Lựa Chọn) |
| :--- | :--- | :--- |
| **Ngôn ngữ lập trình** | C# (Unity) / C++ (Unreal) | **TypeScript** (100% Khớp với thói quen và sở trường của Lập trình viên) |
| **Tầng hiển thị đồ họa** | Khung bao bọc nặng nề | **Native Metal Pipeline** viết riêng cho Apple Silicon (A-series, M-series) |
| **Dung lượng bộ cài đặt (Base IPA)**| 150MB - 300MB | **Chỉ 25MB - 35MB** (Tải nhanh trong vài giây trên App Store) |
| **Thời gian khởi động lạnh** | 5s - 12s | **< 1.5s** (Mở app vào ngay thế giới game) |
| **Nhiệt độ & Pin iPhone** | Rất nóng, dễ bị Apple giảm xung (Thermal Throttle) | **Mát máy, tiết kiệm pin 40%**, chơi liên tục 4-5 tiếng không tụt FPS |
| **Khả năng đa nền tảng** | Tốt | **Xuất sắc**: 1 bộ mã nguồn TypeScript chạy mượt mà trên iOS, Android, macOS, PC, Web |

---

## 3. THIẾT KẾ CÔNG THÁI HỌC VÀ TRẢI NGHIỆM ĐIỀU KHIỂN CẢM ỨNG TRÊN IPHONE

Màn hình cảm ứng di động là thách thức lớn nhất của thể loại Action RPG (vốn cần nhắm chiêu nhanh và né đòn chuẩn). `FreeExile` giải quyết bằng hệ thống điều khiển thông minh:

```mermaid
flowchart LR
    subgraph LeftScreen["Nửa Trái Màn Hình (Di Chuyển)"]
        ThumbTouch["Ngón Cái Chạm Vào Màn Hình"] --> SmartStick["Floating Virtual Joystick (Tự lấy tâm tại điểm chạm)"]
        SmartStick --> MoveVector["Vector Di Chuyển 360 Độ"]
        DoubleTapOrSwipe["Vuốt Nhanh / Nhấp Đúp"] --> DodgeRoll["Dodge Roll (Lăn Né i-Frame Tức Thì)"]
    end

    subgraph RightScreen["Nửa Phải Màn Hình (Kỹ Năng & Thao Tác)"]
        SkillButtons["Cụm Nút Kỹ Năng Hình Vòng Cung (Ergonomic Thumb Arc)"]
        SmartTargeting["Bộ Phận Nhắm Mục Tiêu Thông Minh (Priority: Boss > Elite > Minion)"]
        AutoAim["Tự Hướng Chiêu Thức Theo Mục Tiêu Gần Nhất"]
        ManualAim["Kéo Giữ Nút Để Nhắm Tọa Độ Thủ Công (Indicator hiển thị)"]
        SkillButtons --> SmartTargeting
    end

    subgraph TapticFeedback["Phản Hồi Xúc Giác (Apple Taptic Engine)"]
        CritHaptic["Rung sắc bén khi Chí Mạng (UIImpactFeedbackGenerator: Heavy)"]
        LootHaptic["Rung nảy khi rớt Ngọc Quý Divine/Mirror (UINotificationFeedbackGenerator: Success)"]
        DodgeHaptic["Rung lướt nhẹ khi bắt đầu Lăn Né (UIImpactFeedbackGenerator: Light)"]
    end

    DodgeRoll -.-> DodgeHaptic
    SmartTargeting -.-> CritHaptic
```

---

## 4. TỐI ƯU HÓA CHUYÊN SÂU HỆ SINH THÁI APPLE (FLAGSHIP IOS)

1. **Apple ProMotion (Dynamic 120 FPS)**:
   - Sử dụng `CADisplayLink` đồng bộ với tần số quét của màn hình iPhone 13 Pro/14 Pro/15 Pro/16 Pro trở lên.
   - Khi đứng yên trong thành phố: Hạ tần số xuống 30-60 FPS để tiết kiệm pin.
   - Khi bước vào combat hoặc lăn né: Đẩy tức thì lên 120 FPS để thao tác mượt mà tuyệt đối không độ trễ.
2. **Thích Ứng Safe Area (Dynamic Island & Tai Thỏ)**:
   - Toàn bộ HUD game (Máu, Mana, Mini-map, Phím chat) tự động co giãn theo vùng `UIEdgeInsets` của từng đời máy iPhone, không bị che khuất bởi Dynamic Island hay phần khuyết màn hình.
3. **Tích Hợp Dịch Vụ Apple Gốc**:
   - **Sign in with Apple (SiwA)**: Đăng nhập 1 chạm an toàn, ẩn danh email người dùng.
   - **Apple Game Center**: Đồng bộ danh hiệu (Achievements), bảng xếp hạng thời gian vượt tháp / Boss kill speed.
   - **StoreKit 2**: Mua sắm gói mở rộng Stash Tab, hiệu ứng cánh thời trang (Cosmetics Only) qua FaceID / TouchID an toàn bảo mật, tự động phục hồi giao dịch khi đổi thiết bị.