ScriptableObject в Unity: общие определения и отдельное состояние экземпляров

Начните с владельца данных

Определение оружия и оружие, которое сейчас держит персонаж, — разные категории данных. Если их смешать, изменение боезапаса одного персонажа может затронуть всех, кто использует этот ресурс. Прежде чем выбирать контейнер Unity, определите, принадлежит ли значение повторно используемому определению, отдельному созданному экземпляру или сохранённому профилю игрока. У каждой категории должен быть понятный владелец.

Что делает ресурс общим

ScriptableObject может содержать данные независимо от компонентов сцены. Несколько объектов могут ссылаться на один ресурс и совместно использовать его значения вместо хранения отдельных копий. Это удобно для авторской конфигурации, но не делает объект по ссылке неизменяемым. Руководство Unity 6.0 описывает эту роль общих данных. [1]

Проведите явную границу

Предоставляйте созданные дизайнерами значения через интерфейс, ориентированный на чтение, а состояние экземпляров инициализируйте отдельно. Для боезапаса, таймеров перезарядки и накопленного урона часто достаточно обычного класса времени выполнения. Если объекту действительно нужна идентичность ScriptableObject, CreateInstance создаёт новый экземпляр; Object.Instantiate клонирует существующий объект. [2][3] Выбирайте способ по правилам инициализации, а не считайте оба варианта взаимозаменяемой загрузкой ресурсов.

Пример: две сигнальные ракетницы

Представим определение сигнального снаряда с вместимостью 4, длительностью перезарядки 2 секунды и ссылкой на снаряд. Две созданные ракетницы читают это определение. Каждая начинает со своего боезапаса 4 и собственного таймера перезарядки. Выстрел из ракетницы A уменьшает её боезапас до 3; у ракетницы B остаётся 4. Изменение общей длительности перезарядки при настройке баланса может намеренно повлиять на обе ракетницы при следующем чтении конфигурации. Пример различает чтение живой конфигурации и копирование значений при создании: выберите и документируйте правило для каждого поля. Сохраняйте идентификатор определения ракетницы и изменяемое состояние, затем восстанавливайте её через явно заданную процедуру загрузки.

Ограничения и проверки

Клон не гарантирует независимого владения всеми ресурсами, на которые ведут ссылки. Проверяйте вложенные ссылки, прежде чем разрешать изменение их содержимого. Определите, кто уничтожает временные объекты Unity и кто сбрасывает состояние между игровыми сеансами. Рассматривайте сохранение как отдельную функцию приложения; изменение объекта в памяти не является долговременным форматом хранения. Полезный тест создаёт два экземпляра, изменяет только один и проверяет состояние обоих вместе с исходным определением. Повторите его после перезагрузки сцены и нового запуска приложения, чтобы обнаружить случайную зависимость от состояния редактора.

Источники

1. ScriptableObject data assets — Unity Technologies.
2. ScriptableObject.CreateInstance — Unity Technologies.
3. Object.Instantiate — Unity Technologies.