UI и Ввод Unity: Как игрок взаимодействует с игрой

 Начало - Понимание Unity и C#

UI (интерфейс) и Input (ввод) — это мост между игроком и вашим игровым миром. Без хорошего UI игрок не поймет, сколько у него здоровья. Без правильного Input управление будет казаться «ватным». В современном Unity эти две системы тесно связаны через EventSystem — невидимый диспетчер, который распределяет клики, касания и нажатия клавиш по нужным объектам.

🖼️ Часть 1. UI — Интерфейс пользователя

⚠️ Забудьте про OnGUI!

Метод OnGUI из старых версий Unity устарел. Он работает медленно, не поддерживает адаптивность и используется только для отладочных оверлеев. Современный UI строится через Canvas и систему uGUI (Unity UI).

📐 Canvas — король интерфейса

Canvas — это специальный компонент-контейнер, внутри которого рисуются все UI-элементы.

Render Mode	Что это	Когда использовать
Screen Space - Overlay	UI поверх всего, привязан к экрану	Главные меню, HUD (здоровье, патроны)
Screen Space - Camera	UI рендерится камерой, может перекрываться	Инвентарь в 3D, прицелы с эффектами
World Space	UI как обычный 3D-объект в мире	Экраны на стенах, голограммы, кнопки в VR

🧱 Основные UI-компоненты

csharp
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
using UnityEngine.UI;
using TMPro; // TextMeshPro - современный стандарт текста
public class UIManager : MonoBehaviour
{
    [SerializeField] private TextMeshProUGUI _scoreText;
    [SerializeField] private Image _healthBar;
    [SerializeField] private Button _startButton;
    [SerializeField] private Slider _volumeSlider;
    
    void Start() {
        // Обновление текста
        _scoreText.text = $"Score: {score}";
        
        // Заполнение полоски здоровья (от 0 до 1)
        _healthBar.fillAmount = currentHealth / maxHealth;
        
        // Подписка на кнопку (современный подход)
        _startButton.onClick.AddListener(StartGame);
        
        // Подписка на слайдер
        _volumeSlider.onValueChanged.AddListener(OnVolumeChanged);
    }
    
    void OnVolumeChanged(float value) {
        AudioListener.volume = value;
    }
}

🎯 TextMeshPro — золотой стандарт текста

Забудьте про старый Text компонент. TextMeshPro (TMP) дает:

• ✅ Четкий текст на любом разрешении (SDF-шрифты)
• ✅ Поддержку эмодзи и спецсимволов
• ✅ Rich Text (цвета, жирный, ссылки внутри текста)
• ✅ Анимации и эффекты (outline, glow, shadow)

csharp
1
2
// Rich Text в TMP
_scoreText.text = "<color=yellow>NEW RECORD!</color> Score: <b>1500</b>";

---

🎮 Часть 2. Input — Система ввода

📜 Две эпохи ввода в Unity

🔴 Legacy Input Manager (Старая система)

Edit -> Project Settings -> Input Manager

• ✅ Простая, работает "из коробки"
• ❌ Жесткая привязка к клавишам
• ❌ Плохо работает с геймпадами и мобильными устройствами
• ❌ Проверка каждый кадр (if (Input.GetKey...))

csharp
1
2
3
4
5
6
7
8
9
10
11
12
13
void Update() {
    //Legacy подход - опрос каждый кадр
    if (Input.GetKeyDown(KeyCode.Space)) {
        Jump();
    }
    
    float h = Input.GetAxis("Horizontal"); // -1 до 1
    float v = Input.GetAxis("Vertical");
    
    if (Input.GetMouseButton(0)) {
        Shoot();
    }
}

🟢 New Input System (Современный стандарт)

Устанавливается через Package Manager

• ✅ Событийная модель (не нужно опрашивать каждый кадр)
• ✅ Кроссплатформенность (клавиатура, геймпад, тач, VR-контроллеры)
• ✅ Action-based (действия, а не клавиши)
• ✅ PlayerInput компонент для быстрой настройки

csharp
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// Способ 1: Через PlayerInput компонент (самый простой)
// Вешаем PlayerInput на объект, настраиваем Actions в Inspector
public void OnMove(InputValue value) {
    Vector2 moveInput = value.Get<Vector2>();
    Move(moveInput);
}
public void OnJump(InputAction.CallbackContext context) {
    if (context.performed) {
        Jump(); // Сработает только при нажатии, не каждый кадр!
    }
    
    if (context.canceled) {
        StopJump(); // Сработает при отпускании
    }
}
// Способ 2: Через прямой код (более гибкий)
[SerializeField] private InputActionReference _jumpAction;
void OnEnable() {
    _jumpAction.action.Enable();
    _jumpAction.action.performed += OnJumpPerformed;
}
void OnDisable() {
    _jumpAction.action.performed -= OnJumpPerformed;
    _jumpAction.action.Disable();
}
void OnJumpPerformed(InputAction.CallbackContext context) {
    Jump();
}

---

⚡ Часть 3. EventSystem — Невидимый диспетчер

EventSystem автоматически добавляется на сцену при создании Canvas. Он отвечает за:

• 🔍 Определение, какой UI-элемент находится под курсором/пальцем
• 📡 Распределение событий (клики, наведения, перетаскивания)
• 🎯 Работу с Raycasters (лучами, которые "щупают" UI)

🎯 Интерфейсы событий (IPointerClickHandler и другие)

Вместо того чтобы вешать Button на всё подряд, любой объект с Collider или Image может стать кликабельным через интерфейсы:

csharp
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
using UnityEngine.EventSystems;
public class ClickableObject : MonoBehaviour, 
    IPointerClickHandler,      // Клик
    IPointerEnterHandler,      // Наведение мыши
    IPointerExitHandler,       // Уход мыши
    IDragHandler,              // Перетаскивание
    IBeginDragHandler,         // Начало перетаскивания
    IEndDragHandler            // Конец перетаскивания
{
    public void OnPointerClick(PointerEventData eventData) {
        Debug.Log($"Кликнули по {gameObject.name}");
        Debug.Log($"Позиция клика: {eventData.position}");
        Debug.Log($"Какая кнопка: {eventData.button}"); // Left/Right/Middle
    }
    
    public void OnPointerEnter(PointerEventData eventData) {
        // Подсветить объект при наведении
        GetComponent<Image>().color = Color.yellow;
    }
    
    public void OnPointerExit(PointerEventData eventData) {
        GetComponent<Image>().color = Color.white;
    }
    
    public void OnDrag(PointerEventData eventData) {
        // Перетаскивание объекта мышью
        transform.position = eventData.position;
    }
}

🔧 Основные интерфейсы EventSystem

Интерфейс	Событие	Когда использовать
IPointerClickHandler	Клик по объекту	Кнопки, иконки инвентаря
IPointerEnterHandler	Курсор навелся	Подсветка, подсказки
IDragHandler	Перетаскивание	Слайдеры, drag'n'drop
IScrollHandler	Прокрутка колесом	Списки, инвентари
ISubmitHandler	Enter/кнопка геймпада	Подтверждение в меню
IMoveHandler	Стрелки/D-pad	Навигация по меню

---

💡 Шпаргалка: "Что использовать и где?"

Задача	Решение	Компонент/Метод
Текст на экране	TextMeshPro	TextMeshProUGUI компонент
Полоска здоровья	Заполняемая картинка	Image с fillAmount
Кнопка в меню	Button компонент	onClick.AddListener(...)
Кликабельный 3D объект	Интерфейсы событий	IPointerClickHandler + Collider
Движение персонажа	New Input System	InputAction + PlayerInput
Нажатие прыжка	Событие performed	context.performed в Input Action
Сенсорное управление	New Input System	Touchscreen API
Виртуальный джойстик	UI + Events	IDragHandler на UI элементе
Инвентарь drag'n'drop	EventSystem	IBeginDragHandler, IDragHandler, IEndDragHandler

⚠️ Золотые правила UI и Input

1. Всегда используйте TextMeshPro вместо старого Text — это стандарт индустрии с 2018 года.
2. Используйте New Input System для новых проектов — Legacy официально deprecated.
3. Не опрашивайте Input каждый кадр (Input.GetKey) — используйте событийную модель (context.performed).
4. Для UI-кликов используйте интерфейсы (IPointerClickHandler), а не OnMouseDown (он работает только с 3D-коллайдерами и камерой).
5. Кэшируйте ссылки на UI-элементы в Awake или через [SerializeField] — не ищите их через GetComponent в Update.
6. Используйте Canvas Scaler для адаптивности — настройте Scale With Screen Size и выберите референсное разрешение (например, 1920x1080).
7. Для сложных UI используйте Layout Groups (VerticalLayoutGroup, GridLayoutGroup) — они автоматически расставляют элементы.
8. Не смешивайте UI и 3D-мир без необходимости — World Space Canvas должен использоваться только для внутриигровых интерфейсов (экраны, голограммы).

🚀 Pro-совет: ScriptableObjects для UI

Храните настройки UI (цвета, размеры шрифтов, стили кнопок) в ScriptableObjects. Это позволит дизайнеру менять внешний вид игры без правки кода и создания префабов для каждой кнопки.

csharp
1
2
3
4
5
6
7
[CreateAssetMenu(menuName = "UI/Theme")]
public class UITheme : ScriptableObject {
    public Color primaryColor;
    public Color secondaryColor;
    public TMP_FontAsset mainFont;
    public int fontSize;
}