Перейти к содержимому
Документация описывает SGC Loading Screen 2.5.0, версия скоро появится на FAB. Сейчас на FAB — 1.0.0.

Переход с 1.0.0

Страница перечисляет, что проверить при переходе проекта с версии 1.0.0 на текущую. Часть про C++ читайте, если игра подключает заголовки плагина.

  • Все 15 нод Blueprint из 1.0.0 сохранили имена и пины: Push / Dismiss Loading Screen, Is Loading Screen Visible, Get Active Loading Screen Widget, Set Custom Progress, Notify Custom, четыре сеттера Metrics Overlay, Wait For Loading Screen Dismissed с выходом On Dismissed. Существующие графы загружаются и работают.
  • Все события SGC Loading Screen Widget (Set Custom Text 1/2/3, Set Custom Progress, Level Load Status, Notify Custom, Set Custom Image) по-прежнему вызываются.
  • Ключи DefaultGame.ini сохранили имена и типы в обеих секциях (SGCLoadingScreenSettings, SGCStartupLoadingScreenSettings), включая ShadowBlur (в Details называется Shadow Opacity). Enum оверлея метрик сохранили имена и значения.
  • bManualLoadingScreen=True без записи режима переносится в режим Manual.
  • Пустой LoadingScreenWidget теперь показывает встроенный экран, а не ничего.
  • Set Custom Text 1/2/3 устарели: используйте Add Loading Tips. Они работают и по-прежнему вызывают события виджета.
  • Set Custom Image устарела: используйте Add Loading Backgrounds. Она работает.
  • Push Loading Screen и Dismiss Loading Screen могут быть скрыты из меню нод в зависимости от Loading Screen Mode. Уже стоящие ноды работают. Режим по умолчанию (Auto Show / Manual Dismiss) ведёт себя как в 1.0.0.
  • Wait For Loading Screen Dismissed теперь срабатывает и на dedicated server (в следующем кадре).
  • Block Input While Visible: в PIE проходят Escape и Shift+F1. Во всех не-shipping сборках проходят клавиша консоли и вся клавиатура при открытой консоли. В Shipping ввод игры блокируется полностью.
  • Load Status Complete Delay Secs: ключ сохранён. Завершение теперь определяется удержаниями.
  • Стабильны только публичные заголовки SGCLoadingScreenRuntime. Заголовки остальных модулей (Startup, Core, Editor) могут меняться в любой версии.
  • USGCLoadingScreenSubsystem (PushLoadingScreen, DismissLoadingScreen, IsLoadingScreenVisible, HasLoadingScreenRequest, GetActiveLoadingScreenWidget, CallOrRegister_OnLoadingScreenDismissed, RemoveOnLoadingScreenDismissed, FOnSGCLoadingScreenDismissed) был экспортирован и публичен. Теперь он Private, include не работает. Используйте USGCLoadingScreenBlueprintLibrary (Push, Dismiss, Is Loading Screen Visible, Get Active Loading Screen Widget) и FSGCScopedLoadingHold. Ждать закрытия — USGCAsyncAction_WaitLoadingScreenDismissed. Замены для HasLoadingScreenRequest и нативного делегата FOnSGCLoadingScreenDismissed нет.
  • USGCStartupLoadingScreenSettings::PersistDefaultConfig() и EditorSyncImagePathsFromDisk() (только редактор) удалены, deprecated-обёртки нет. Публичной замены нет. Правьте DefaultGame.ini или Project Settings.
  • SGCStartupLoadingScreenStatusPage::Create(const FSGCStartupLoadingScreenViewConfig&, bool) удалена. FSGCStartupLoadingScreenViewConfig теперь Private. Используйте CreateFromSettings(Settings).
  • SGCStartupLoadingScreenStatusPage::CreateFromSettings(Settings, bool): параметр bool удалён. Вызовы с одним аргументом компилируются. Вызовы с явным bool и указатели на прежний тип функции — нет. Страница всегда создаётся в режиме предпросмотра.
  • FSGCLoadWorkSnapshot::Capture() (с 2.0.0): вызывайте только в игровом потоке.
  • Заголовки USGCLoadingScreenWidgetFactory и FSGCLoadingScreenEditorStyle теперь Private. Фабрика создаёт готовый макет, а не пустой виджет.
  • USGCLoadingScreenSettings::bManualLoadingScreen сохранён только для переноса старых ini и скрыт из Details. Запись из C++ во время работы больше не меняет режим. Задавайте LoadingScreenMode.

ShowRetryIntervalSecs (Show Retry Interval Secs) удалена. Старая запись в DefaultGame.ini игнорируется: это не ошибка и ничего не делает. Строку можно удалить. Код на C++, читавший или писавший её, не скомпилируется.

Полный список изменений — в Что нового.