Convert To Sandbox Path
BlueprintPathsLibraryЧто это
Pure-функция (без exec-пинов). Преобразует указанный путь в sandbox-путь — изолированное представление файлового пути, используемое на платформах с ограниченным доступом к файловой системе (консоли, мобильные устройства). Позволяет единообразно работать с файлами в защищённой среде.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные): _(не уверен в точной сигнатуре)_
Выходы (данные): _(не уверен в точной сигнатуре)_
Когда используется
- Сохранение пользовательских настроек, прогресса или кэша в изолированную папку.
- Загрузка ассетов из sandbox-директории на платформах с жёсткими правами доступа.
- Любые файловые операции, которые должны быть переносимы между платформами с разной политикой безопасности.
Типичные проблемы
- Забывают выполнить обратное преобразование (
ConvertFromSandboxPath) при чтении файла, что приводит к ошибкам доступа или неверному пути. - Не учитывают, что sandbox-путь может быть относительным и платформозависимым, из-за чего отладка на ПК и консоли даёт разные результаты.
- Используют функцию на платформах без поддержки песочницы (например, Windows) — в этом случае она возвращает исходный путь без изменений, что может скрыть логическую ошибку.