Основні компоненти

Вивчення що є що.

Tutorial Scene References (TSR)

Компонент, який містить посилання на всі компоненти системи. Він також містить публічні методи-обгортки для ручного виклику кроків туторіалу через скрипт. TSR містить публічні поля в інспекторі для взаємодії з:

  • Main Camera (обов'язково). Тут призначте камеру поточної сцени.

  • Target Canvas (обов'язково). Тут призначте UI Canvas поточної сцени.

  • Target World Holder. Тут призначений батьківський об'єкт, де з'являються світові підказки (2D/3D).

  • CurrentDevice_ATM (обов'язково). Унікальний рядок-назва для поточного ATM на сцені. Якщо на сцені присутні кілька ATM, їх слід розрізняти за цим рядком. Див. Адаптивний Туторіал.

  • InputTextStrings (обов'язково). Посилання на об'єкт, який зберігає всі тексти та переклади для кожної частини туторіалу в проекті.

  • Autostart. Вимкніть цей булевий параметр, щоб запобігти автоматичному запуску туторіалу. Він запуститься лише при ручному запуску через TurnOnTutorial(). Див. Ручні Виклики.

  • ForMobileBuildOnly. Якщо цей параметр True, тоді цей туторіал буде програватися лише на Mobile пристроях. Це дозволяє тримати декілька різних АТМ під різні пристрої на одній сцені.

  • ForPCBuildOnly. Якщо цей параметр True, тоді цей туторіал буде програватися лише на Desktop пристроях. Це дозволяє тримати декілька різних АТМ під різні пристрої на одній сцені.

  • Посилання на налаштування візуалізації за замовчуванням та префаби. Див. Префаби Візуалів.

  • Auto Initialized. Показує стан авто ініціалізації при першому додаванні TutorialSystem на сцену.

Automatic Tutorial Maker (ATM)

Основний компонент для запису та генерації туторіалу. Не призначений для ручного редагування. Цей скрипт розпізнає тип кожної дії під час запису та генерує найбільш підходящу підказку для неї. Наприклад, коли об'єкт переміщується в слот інвентаря, він розпізнає, що це дія drag-and-drop, і генерує покажчик разом з текстовою міткою для пояснення дії. Пізніше це можна налаштувати в інспекторі. Див. Налаштування Кроків. ATM містить публічні поля в інспекторі для взаємодії з:

  • Current Language. Перемикач мови змінює текст усіх підказок кроків туторіалу в проекті на вибрану мову. Він пов'язаний з об'єктом InputTextStrings в TSR.

  • Start Recording/Stop Recording кнопка. Доступна під час виконання. Використовується для початку запису та генерації туторіалу, а потім збереження його після завершення.

  • Публічний Step Sequence список. Кожен елемент у цьому списку представляє крок туторіалу. Він містить інформацію про умови початку кроку, виконання та візуальне відображення.

  • Copy Sequence, Paste Sequence, і Clear Sequence кнопки. Розроблені для спрощення ручної роботи зі списком: копіювання, вставка та очищення.

Step Sequence Player (SSP)

Основний компонент, відповідальний за логіку відтворення кроків туторіалу. Не призначений для ручного редагування. Цей скрипт знаходить, які кроки гравець повинен зробити на даний момент, відслідковує введення для їх завершення, а також зберігає прогрес виконаних і невиконаних кроків для кожного ATM окремо. SSP містить публічне поле в інспекторі для взаємодії з:

  • Reset Tutorial Progress кнопка. Доступна під час виконання. Скидає прогрес туторіалу на поточній сцені для тестування.

Tutorial Visual Manager (TVM)

Цей компонент допомагає вмикати та знищувати різні візуальні підказки на сцені залежно від кроку відтворення. Не призначений для ручного редагування.

Input Controller

Цей компонент відстежує все введення для запису та відтворення. Не призначений для ручного редагування. Підтримує як мобільні пристрої, так і ПК, і геймпади. Містить публічні поля в інспекторі:

  • Input System Type для перемикання між новою та старою системами введення.

  • Min Hold Duration. Встановіть мінімальний часовий інтервал, який повинен пройти, перш ніж буде розпізнана взаємодія Hold. Він повинен бути більшим за 0, щоб відрізнити введення від кліку.

  • Min і Max Swipe Distance, Swipe Angle Tolerance. Аналогічно, це визначає мінімальну тривалість і відстань свайпу в пікселях для взаємодії Swipe.

  • Min Drag Distance визначає мінімальну відстань, після якої об'єкт вважається переміщеним для взаємодії Drag.

  • Joystick Axes містить назви осей в Input Manager, які потрібні для введення джойстика. Joystick Mapping містить певні кнопки джойстика за індексом. Див. Підтримуване Введення (Джойстик).

InputStringsScriptableObject

Скрипт, що містить логіку локалізації туторіалу. Він пов'язаний з об'єктом InputTextStrings в TSR. Всередині скрипта ви замінюєте попередньо визначені записи AddCustomLanguage на власні мови в публічному перерахуванні Language. Див. Локалізація.

IrisCutoutMask

Компонент, який можна прикріпити до Image у UI-префабі з увімкненим Raycast Target, використовується для "вирізання" області, в якій дозволено raycast. Застосовується для блокування небажаних взаємодій, залишаючи доступною лише цільову зону. Компонент дозволяє налаштовувати форму та розмір вирізу. Опція Enable Visual Mask створює візуальну область навколо "вирізу" з обраним кольором. Для роботи компоненту потрібно призначити Target Image та його Rect Transform; якщо не вказано вручну, вони призначаються автоматично під час Awake.

BackgroundManager, GrayedAttribute, KeyboardInputHelper, KeyCodeExtensions, ReadOnlyAttribute, TutorialSceneReferencesEditor, JoystickTipController - допоміжні компоненти для зрозумілого дизайну асету та оптимізації введення.

Last updated