aego/modules/input/res/docs/input.ru.md

id, title

id	title
input	Ввод

Ввод

Игры читают действия, а не клавиши. У действия есть имя, тип и привязки; один и тот же скрипт работает с клавиатурой и с геймпадом.

Действия

input version=2 {
  stack=[Gameplay]
  action {
    name=Move
    type=axis1
    bind=["Key.A/Key.D", "Key.Left/Key.Right", "Pad.LeftX"]
  }
  action {
    name=Jump
    type=button
    buffer=0.1
    bind=["Key.Space", "Pad.A"]
  }
  context {
    name=Gameplay
    actions=[Move, Jump]
  }
}

Типы: button, axis1, axis2, pointer, pointerDelta.

Привязка — это один элемент управления или составная привязка:

Форма	Пример
один элемент	Key.Space, Mouse.Left, Pad.A, Pad.LT
минус/плюс	Key.A/Key.D
вверх/вниз/влево/вправо	Key.W/Key.S/Key.A/Key.D
стик	Pad.LeftStick
аккорд	Key.Z+Key.S

Параметры идут после элемента: invert, scale=2, deadzone=0.3.

• Кнопки геймпада: A B X Y Back Guide Start L3 R3 LB RB DPadUp DPadDown DPadLeft DPadRight.
• Оси геймпада: LeftX LeftY RightX RightY LT RT.
• У axis2 ось Y направлена вниз, как в 2D-мире.
• У стика мёртвая зона радиальная, у одиночной оси — осевая. По умолчанию deadzone=0.2.

interaction меняет момент срабатывания кнопки: press (по умолчанию), release, hold, tap, doubleTap, toggle. time задаёт окно в секундах.

Контексты

Контекст — именованный набор действий. Стек решает, что читается: сначала больший priority, затем последний добавленный.

• Контекст с consume=true перехватывает ввод: прячет свои элементы управления от контекстов ниже. Меню с Back на Escape не даёт сработать Pause на Escape.
• Переключение контекстов не посылает ложных Pressed или Released. release=true у контекста посылает Released для его удерживаемых действий, когда он уходит со стека.

Кадры и фиксированные шаги

Pressed в Update истинно один кадр. В FixedUpdate оно истинно в первом фиксированном шаге после нажатия.

• Короткое нажатие между двумя фиксированными шагами всё равно даёт ровно один Pressed, а за ним один Released.
• Held истинно в каждом шаге кадра.
• Потеря фокуса окна или геймпада отпускает все удерживаемые действия в том же шаге. input.DeviceChanged() истинно в этом кадре.

Скрипты

import "aego/input"

func FixedUpdate(dt float) {
  x := input.Axis("Move")
  if grounded && input.Buffered("Jump", 0) {
    input.Consume("Jump")
    jump()
  }
}

Функция
Pressed Released Held(action) bool	состояние действия
Axis(action) float	значение оси
Axis2(action) Vec2	значение 2D-действия
Buffered(action, window) bool, Consume(action)	буфер нажатий
PushContext PopContext SetContext	стек контекстов
PressedP ReleasedP HeldP AxisP Axis2P(player, action)	для каждого игрока
ActiveDevice() int, DeviceChanged() bool, Glyph(action) string	устройства и подсказки
BeginRebind(action, slot) bool, Rebinding(), RebindConflict(), ResetBinding, ResetBindings, SaveBindings	меню

Переназначения и настройки обзора — настройки игрока: они сохраняются в профиле игрока; старый user://input.aetext импортируется один раз.

Прямые клавиши (Down, KeyPressed, KeyReleased, MouseDown, MousePressed, MousePos, MouseWorld) остаются для прототипов. Не выпускайте игру с ними.

Игроки

players=2 даёт каждому игроку своё состояние действий.

• Клавиатура и мышь принадлежат игроку 0.
• Геймпад при первом нажатии достаётся первому игроку без устройства.
• В Go Assign(player, device) закрепляет соответствие.

Запись и тесты

s := sdk.Actions(world)
s.Inject(40, "Jump", 1)
s.Inject(43, "Jump", 0)
s.Record(input.RecordMeta{Project: "mygame", FixedHz: 60})
data := s.StopRecording()
s.Replay(data)

Повтор заменяет все устройства. С той же сценой, зерном, настройками физики и фиксированным шагом повтор воспроизводит запуск бит в бит.

Действия из модулей

Модуль добавляет свои действия и контексты, не импортируя модуль ввода:

sdk.ProvideInputActions(r, sdk.InputActionSet{
  Actions:  []sdk.InputAction{{Name: "Kick", Type: "button", Bindings: []string{"Key.K", "Pad.Y"}}},
  Contexts: []sdk.InputContext{{Name: "Combat", Actions: []string{"Kick"}, Default: true}},
})

Как действия модулей сочетаются с проектом:

• Действие или контекст проекта с тем же именем побеждает.
• Контекст с пометкой Default входит в стартовый стек.
• Действия модулей не появляются на странице настроек; файл проекта показывает только то, что объявляет сам.

Редактор

• Настройки проекта → Ввод редактирует действия, привязки, контексты и стартовый стек. Чтобы назначить элемент управления, щёлкните по нему, затем нажмите клавишу, кнопку мыши (не левую), кнопку геймпада или сдвиньте стик; Escape отменяет. Элементы, привязанные к двум действиям одного контекста, красные, а подсказка называет другое действие.
• Устройства ввода перечисляет клавиатуру, мышь и геймпады, показывает живые значения действий во время игры и содержит виртуальный геймпад: кнопки и два стика, которые вы двигаете мышью.
• Фокус ввода показывает стек контекстов и для каждого действия — контекст, через который оно прочитано, и перехвативший контекст, который его заблокировал.

В редакторе Escape уходит в игру, поэтому меню паузы работают в игре. Shift+Esc или щелчок вне панели «Игра» возвращают ввод редактору; это команда «Отпустить ввод игры», её привязку можно изменить в «Сочетаниях клавиш».

Inject(0, action, v) действует со следующего кадра. Используйте его, пока игровое время на паузе или его масштаб равен 0, когда фиксированные шаги не идут.