Патчи
В патчах логика собирается из нод и проводов, а не пишется кодом. Берите патч, когда события уже не хватает.
Патч находится между событиями и скриптами:
- События простые, но не умеют хранить значения и считать.
- Скрипты умеют всё, но для них нужно писать код.
Попробуйте патч, как только захотите «…но только если счёт больше десяти» или «…каждый раз сдвигать чуть дальше».
Патч работает так же быстро, как код, написанный руками. В панели Код его можно в любой момент посмотреть в виде кода. Заодно это самый быстрый способ проверить, что граф делает то, что вы задумали.
Все ноды и их порты — в справочнике нод патчей: 203 ноды в 24 категориях.
Соберите патч
- Откройте Редактор патчей на левой панели. Там показан граф сцены.
- Нажмите + Добавить ноду и выберите ноду из группы События. С неё начинается граф.
- Добавьте ноду, которая что-то делает, например меняет компонент.
- Протяните провод от выхода-пульса ноды события ко входу-пульсу другой ноды.
- Откройте панель Код и проверьте граф в виде кода.
Виды нод
| Вид | Как узнать | Что делает |
|---|---|---|
| Событие | только выходы, один из них — пульс | запускает граф: при запуске, по нажатию, в каждом кадре |
| Эффект | пульс на входе и пульс на выходе | что-то делает, по порядку |
| Управление | разветвляет или повторяет пульс | ветвление, шлюз, повтор, перебор, один раз, задержка |
| Данные | пульсов нет совсем | даёт значение: число, сумму, поле компонента |
Провод пульса задаёт порядок, в котором всё происходит. Чтобы прочитать последовательность, идите по нему от ноды события. Провода данных только передают значения, порядка у них нет.
Порты и провода
У каждого порта есть тип: число, логическое значение, строка, вектор, цвет или объект. Порты разных типов не соединяются. Так многие ошибки видны ещё до запуска.
Порт вектора раскрывается в x, y и z. Можно подключить провод к одному из них, а два
других ввести вручную.
Вход без провода берёт значение, которое вы ввели в ноду. Поэтому подключайте провода только к тому, что меняется.
Выберите, с каким объектом работает нода
Нодам компонентов, например «получить трансформацию» или «задать материал», нужно знать, с каким объектом работать.
- Оставьте объект пустым — нода будет работать с этим объектом, к которому прикреплён патч.
- Укажите объект — нода будет работать с ним.
Работать с ними проще благодаря двум правилам:
- Ноды чтения не ломаются. Если прочитать компонент, которого у объекта нет, нода ничего не вернёт, а граф продолжит работать.
- Ноды записи меняют только то, что вы заполнили. Всё остальное остаётся как было.
Как и всё остальное, что вы видите в редакторе. В скриптах поворот в радианах, поэтому пересчитывайте его, когда передаёте между патчем и скриптом.
Что есть в меню нод
| Группа | Что там |
|---|---|
| События | 30 точек старта: запуск, кадр, нажатие, клавиши, столкновения, трекинг |
| Компоненты | чтение и изменение любого компонента |
| Математика, Векторы, Логика, Строки | вычисления, сравнения, векторы и текст |
| Поток | ветвление, шлюз, повтор, перебор, один раз, задержка, последовательность |
| Состояние | счётчик, переключатель, таймер, сглаживание |
| Сущности, Жизненный цикл | найти, создать, породить и удалить объекты |
| Физика | импульсы, силы, скорость, raycast |
| Мультиплеер | отправка, получение, общее состояние, порождение объектов |
| Глобальные, Переменные, Сообщения | значения, общие с другими патчами и скриптами |
| Интерфейс | чтение и изменение переменных карточки интерфейса |
| Функции | вызов другого патча или скрипта |
Используйте патч повторно
Сохраните граф как патч в ассетах проекта, и его можно будет добавлять на другие холсты. Что получится, зависит от того, как вы его собрали:
| Вы собрали | Вы получите |
|---|---|
| без нод входов и выходов | поведение: добавили — и оно работает, провода не нужны |
| входы, выходы и вход-пульс | шаг: выполняется, когда приходит пульс, после чего готовы выходы |
| входы и выходы, но без пульса | функцию: её выходы вычисляются там, где их читают |
Разъёмы патча берутся из нод входов и выходов внутри него. Добавьте такую ноду, и разъём появится везде, где используется патч. Когда вы меняете патч, всё, что его использует, сразу обновляется.
Внутри функции нет «этого объекта», поэтому ноды объектов и компонентов там не работают. Используйте функции для данных, математики и логики. А работу со сценой делайте в патче, который вызывает функцию.
Патчи умеют вызывать и скрипты. Обычно так делают то, для чего нет подходящей ноды.
Сохраняйте значения между запусками
Сохранить значение можно тремя способами. Они отличаются тем, кому это значение видно:
| Группа нод | Кому доступно |
|---|---|
| Переменные | нодам этого патча |
| Глобальные | всем патчам, скриптам и событиям проекта |
| Сообщения | всем, кто их слушает; это разовое уведомление, отправленное по имени |
Глобальные значения бывают двух видов:
- глобальные значения проекта сохраняются, когда посетитель переходит между пространствами;
- глобальные значения пространства в каждом пространстве начинаются заново.
Имена переменных, глобальных значений и сообщений вводятся текстом, а не подключаются проводом.
Напишите строчку JavaScript
Две ноды принимают JavaScript напрямую:
- Выражение (
expression) возвращает значение. - Действие (
action) выполняет инструкции.
Внутри них доступно всё, что доступно скрипту.
Используйте их для одной небольшой задачи, для которой нет подходящей ноды. Если кода в них становится много, лучше напишите скрипт и вызовите его из графа.
Если что-то не работает
Откройте панель Код. Если с графом что-то не так, причина будет видна там. Две частые причины — петля в проводах данных и ошибка в JavaScript в ноде Действие.
Сломанный патч не останавливает сцену. Остальные патчи продолжают работать.
Дальше: Игровое управление — как дать людям ходить по сцене.