Розширене: Ручні Виклики

Виклик кроків за допомогою скрипта / кнопки / тригера подій.

Тут ми працюємо з логікою виклику кроків вручну за допомогою публічних методів-обгорток у TutorialSceneReferences (TSR).

1. У скрипті, з якого ви будете викликати крок, створіть посилання на TSR. Наприклад: [SerializeField] private TutorialSceneReferences sceneReferences;

2. Використовуйте виклики публічних методів залежно від бажаного результату:

Метод в TSR	Опис	Приклад
IsStepDisplaying(int stepIndex)	Перевіряє, чи крок зараз виконується.	if (IsStepDisplaying(0)) {}
IsStepDone(int stepIndex)	Перевіряє, чи крок було завершено.	if (IsStepDone(0)) {}
IsStepManualStart(int stepIndex)	Перевіряє, чи крок чекає ручного виклику.	if (IsStepManualStart(0)) {}
TurnOffTutorial()	Вимикає туторіал. Корисно для перемикання між різними туторіалами на одній сцені.	sceneReferences.TurnOnffTutorial();
TurnOnTutorial()	Запускає туторіал на сцені. Корисно, якщо Autostart встановлено на false.	sceneReferences.TurnOnTutorial();
TranslateAllTutorial(InputStringsScriptableObject.Language language)	Перекладає всі підказки туторіалу на одну з підтримуваних мов.	sceneReferences.InputStringsScriptableObject.Language.Italian);
TranslateAllTutorialByString(string language)	Перекладає всі підказки туторіалу на будь-яку мову, присутню в CSV-файлі (знаходить заголовок з цим рядком).	sceneReferences.TranslateAllTutorialByString("Polish");
ChangeStepVisualText(int stepIndex, string textValue, TextToChange textField)	Використовується для передачі власного тексту до вибраної підказки вибраного кроку під час виконання.	sceneReferences.ChangeStepVisualText(2, "Your text", TextToChange.PointerText)
StartTutorialStep(int stepIndex)	Запускає конкретний крок туторіалу за його індексом і вимикає інші.	sceneReferences.StartTutorialStep(2);
AsyncStartTutorialStep(int stepIndex)	Запускає конкретний крок туторіалу за його індексом і не вимикає інші.	sceneReferences.AsyncStartTutorialStep(2);
StartTutorialStepWithTargets(int stepIndex, List targetObjects, bool stopOtherSteps)	Запускає крок туторіалу з власними цільовими GameObjects.	sceneReferences.ForceCompleteStep(2, myGameObjectList, false);
ForceCompleteStep(int stepIndex)	Завершує крок, встановлюючи його статус на "Done" незалежно від умов завершення.	sceneReferences.ForceCompleteStep(2);
ForceCompleteTutorial()	Завершує всі кроки туторіалу на сцені без винятку, позначаючи як Done.	sceneReferences.ForceCompleteTutorial();
SkipTutorial()	Пропускає кроки навчання, використовуючи ForceCompleteTutorial або через власну логіку (щоб завершити лише вибрані кроки).	sceneReferences.SkipTutorial();
SkipActiveTutorialModule()	Пропускає туторіал вибірково, відповідно до заданого списку кроків.	sceneReferences.SkipActiveTutorialModule();
ResetTutorialStep(int stepIndex)	Вимикає крок разом із його візуальними елементами, встановлюючи його статус на NotDoneYet.	ResetTutorialStep(0);
HideTutorial()	Скидає всі кроки туторіала, які наразі відображаються.	sceneReferences.HideTutorial();
ContinueTutorial()	Після скидання намагається автоматично відновити кроки, які були призупинені раніше.	sceneReferences.ContinueTutorial();

1. Рекомендується встановити кроки, які ви викликаєте зі скрипта, на Start Step → Manually Call, щоб забезпечити уніфікований контроль над виконанням.

2. Кнопка всередині будь-якого префаба підказки також може викликати публічні методи.

Метод UIGraphicAnimation	Опис	Приклад Виклику
InitializeByConfirm()	Запускається при натисканні кнопки і встановлює BlockedByButton на false у кроці. Потім крок продовжується, поки гравець не виконає основну умову.
FinishStep()	Також може бути запущений кнопкою для негайного завершення кроку при натисканні.
FinishStepAndSkipTutorial()	Також може бути запущений кнопкою, щоб завершити крок та пропустити весь туторіал.