Переход с 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теперь показывает встроенный экран, а не ничего.
Изменилось для Blueprint
Заголовок раздела «Изменилось для Blueprint»- 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: ключ сохранён. Завершение теперь определяется удержаниями.
Изменилось для C++
Заголовок раздела «Изменилось для C++»- Стабильны только публичные заголовки
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++, читавший или писавший её, не скомпилируется.
Полный список изменений — в Что нового.