Resource

public Resource();

Создаёт собственный Resource без пути и имени. Не загружает файл, не регистрирует формат и не добавляет Entity в дерево. Ресурсы могут быть общими: для независимых данных выбирайте нужный режим Duplicate, а не ещё одну переменную с той же ссылкой.

public bool ResourceLocalToScene { get; set; }

Флаг отдельного ресурса для экземпляра уровня/префаба при обработке PackedEntity. Задавайте до инстанцирования; изменение флага не отделяет уже разделяемые ссылки задним числом. Это не уникальность на каждую Entity и не сетевой ID. Механика реального PackedEntity здесь сверена по исходникам; отдельно проверено, что один флаг не назначает GetLocalScene.

public string ResourceName { get; set; }

Имя для отображения. Изменение вызывает Changed, даже при повторной записи того же значения; не переименовывает файл и не меняет ResourcePath.

public string ResourcePath { get; set; }

Путь и ключ общего ресурсного кэша, не команда сохранения файла. Setter регистрирует непустой путь; пустой снимает регистрацию. При занятом пути используйте осознанный TakeOverPath либо другой путь. В текущем native-коде отказ из-за занятого пути происходит после удаления прежней регистрации и очистки пути этого объекта: операция не обещает откат. Этот конфликт разобран по исходникам, без выполнения ошибочного сценария.

public string ResourceSceneUniqueId { get; set; }

Локальный ID подресурса при сериализации. Допустимы ASCII-буквы, цифры, подчёркивание и пустая строка. Недопустимый символ вызывает native-диагностику и замену ID сгенерированным кандидатом; это не сохранение старого значения. Не путайте с uid:// и уникальностью на весь проект.

public Error CopyFromResource(Resource resource);

Копирует STORAGE-свойства в существующий объект, сохраняя его ResourcePath. Сначала вызывает ResetState; вложенные Resource остаются общими, это не глубокая копия. Проверяет совпадение native engine-класса, не строгое равенство C# типов. Несовпадение даёт InvalidParameter; null также недопустим. Сигналы Changed во время копирования объединяются в один отложенный, если было уведомление; возврат Ok не обещает независимость данных или запись файла.

public Resource Duplicate(bool deep = false);

Создаёт новый корневой Resource и копирует сохраняемые свойства/скрипт, но не ResourcePath. По умолчанию контейнеры и вложенные ресурсы общие. deep=true копирует контейнеры и встроенные вложенные Resource; ресурсы с внешним путём обычно сохраняются общими. Повторные ссылки на один копируемый ресурс переназначаются к одной копии. Флаги использования свойств могут переопределить правило. Для всех внешних ресурсов используйте DuplicateDeep(All); пользовательские конструкторы/скрипты могут ограничить копирование.

public Resource DuplicateDeep(Resource.DeepDuplicateMode deepSubresourcesMode = Resource.DeepDuplicateMode.Internal);

Создаёт новый корень и рекурсивно копирует Array/Dictionary. None сохраняет вложенные Resource общими; Internal копирует встроенные; All включает внешние Resource. All не является обещанием полной независимости: скрипты и свойства с NEVER_DUPLICATE могут остаться общими. Сохраняет повторные ссылки внутри копируемого графа через remap, а не создаёт отдельную копию на каждое вхождение. Исходные пути Resource не переносятся на копии; операция ничего не сохраняет на диск.

public void EmitChanged();

Уведомляет подписчиков Changed после изменения данных. Не записывает файл и не гарантирует обновление всех редакторных представлений. В custom C# setter вызовите после фактического изменения; не вызывайте бесконечно из собственного Changed handler. Во время фоновой загрузки native backend может перенести уведомление на главный поток.

public static string GenerateSceneUniqueId();

Создаёт короткий пятисимвольный кандидат внутреннего ID. Не глобальный UID, не криптографический идентификатор и не резервирование уникальности. Формат текущей реализации использует a–y и 0–8; не стройте на нём постоянный публичный протокол. Совпадения разрешаются вызывающей системой сохранения.

public string GetIdForPath(string path);

Читает редакторный кэш ID для пары: путь ссылающегося файла и текущий ResourcePath этого ресурса. Не ResourceUid и не чтение ID из произвольного файла. Без записи или в сборке без TOOLS_ENABLED возвращает пустую строку. Редакторная персистентность здесь проверена только по исходникам.

public Entity GetLocalScene();

Возвращает корень Entity, назначенный механикой local-to-scene, либо доступный editor-контекст, либо null. Одна установка ResourceLocalToScene=true не создаёт и не назначает корень. Возвращённая Entity заимствована: не Free её как собственный временный объект. Реальное PackedEntity-инстанцирование в этом проходе не выполнялось.

public string GetName();

Возвращает ResourceName — имя для отображения, не путь файла или ключ глобального реестра.

public string GetPath();

Возвращает текущую строку ResourcePath. Может быть пустой, внутренней или заданной через SetPathCache без регистрации. Непустой путь не доказывает существующий файл, загрузку или запись на диск.

public Rid GetRid();

Возвращает RID backend-ресурса, если конкретный тип его предоставляет. Базовый Resource возвращает пустой RID; это не InstanceId. Не освобождайте возвращённый RID вручную, если его владельцем остаётся Resource. IsValid проверяет ненулевое значение, не общую пригодность для любого server API.

public string GetSceneUniqueId();

Возвращает ResourceSceneUniqueId: локальный ID сериализуемого подресурса, не глобальный ResourceUid. Пустая строка допустима.

public bool IsBuiltIn();

Классифицирует ресурс по пути: пустой, содержащий :: или начинающийся с local:// считается встроенным. Это правило используется при глубоком копировании; оно не проверяет наличие файла, сохранение или принадлежность Entity.

public bool IsLocalToScene();

Возвращает флаг ResourceLocalToScene. True не доказывает, что экземпляр уже скопирован или связан с конкретным корнем Entity.

public void ResetState();

Вызывает _ResetState для состояния, которое конкретный класс должен сбросить сам. Базовая реализация не обнуляет автоматически все экспортируемые свойства, имя и путь. CopyFromResource вызывает этот hook перед копированием.

public void SetIdForPath(string path, string id);

Записывает редакторный ID-кэш для пути ссылающегося файла и текущего ResourcePath. Пустой id удаляет запись. Не назначает ResourceUid, не сохраняет файл и не регистрирует новый ресурсный путь. Без TOOLS_ENABLED операция не делает ничего; editor workflow здесь не выполнялся.

public void SetLocalToScene(bool enable);

Задаёт ResourceLocalToScene. Не создаёт немедленную копию, не меняет существующие ссылки и не назначает корень GetLocalScene.

public void SetName(string name);

Задаёт ResourceName и вызывает Changed, включая повтор того же значения. Не выполняет файловое переименование.

public void SetPath(string path);

Задаёт ResourcePath с обычной регистрацией кэша. Не записывает и не перемещает файл. Занятый другим ресурсом путь даёт native-диагностику; прежний путь этого объекта к тому моменту уже очищен в текущей реализации. Для намеренной замены владельца есть TakeOverPath; для служебного raw-пути — SetPathCache, с другой семантикой.

public void SetPathCache(string path);

Служебно меняет строку пути и вызывает _SetPathCache, обходя регистрацию ResourceCache. Не эквивалент ResourcePath/SetPath. Не используйте для обычного перемещения уже закэшированного объекта: согласованность записей кэша не поддерживается этой операцией. Проверено на незарегистрированном QA-объекте.

public void SetSceneUniqueId(string id);

Задаёт локальный ResourceSceneUniqueId. ASCII-буквы, цифры и подчёркивание допустимы; пустое значение принято. При недопустимом символе native-код ставит сгенерированный ID и выдаёт диагностику. Не записывает файл и не резервирует глобальную уникальность.

public void SetupLocalToScene();

В SDK помечен устаревшим: внутренний вызов. Выдаёт SetupLocalToSceneRequested, затем вызывает _SetupLocalToScene. Сам по себе не копирует ресурс и не включает local-to-scene. В обычном пользовательском классе переопределяйте _SetupLocalToScene вместо ручного вызова; внутренний dispatch проверен только специальным QA-сценарием.

public void TakeOverPath(string path);

Присваивает ресурсный путь с заменой владельца кэша. Прежний владелец остаётся жив по существующим ссылкам, но его ResourcePath очищается. Последующий lookup пути указывает на этот ресурс. Файлы не перемещаются и не сохраняются; используйте только при намеренной замене общего объекта.

public virtual Rid _GetRid();

Hook для GetRid конкретного ресурса. Верните RID реально принадлежащего backend-объекта либо пустой RID. Сам факт возврата не создаёт объект сервера и не передаёт владение вызывающему коду; не подменяйте InstanceId значением RID.

public virtual void _ResetState();

Переопределите для очистки собственного несохраняемого/динамического состояния. Вызывается ResetState, в том числе перед CopyFromResource. Не вызывайте из hook сам ResetState рекурсивно; автоматического сброса всех свойств нет.

public virtual void _SetPathCache(string path);

Уведомление после служебного SetPathCache. Путь уже записан; hook не заменяет регистрацию ResourcePath и не подтверждает файловую операцию. Не вызывайте SetPathCache рекурсивно из этого callback.

public virtual void _SetupLocalToScene();

Переопределите для настройки ресурса в механике local-to-scene. GetLocalScene может дать назначенный корень, но проверяйте null вне нормального инстанцирования. Hook не является конструктором каждой Entity или _Ready. Самостоятельный callback-dispatch проверен; реальное локальное копирование PackedEntity в этом проходе не выполнялось.

public event Action Changed;

Событие уведомления об изменении, не автоматическое сохранение на диск. ResourceName вызывает его даже при повторе значения. Обычный setter собственного [Export]-свойства C# не вызывает событие автоматически: вызовите EmitChanged после значимого изменения. При общей ссылке подписчики наблюдают тот же объект.

public event Action SetupLocalToSceneRequested;

В SDK помечено устаревшим: вместо подписки для настройки ресурса переопределяйте _SetupLocalToScene. Native setup выдаёт событие перед callback; само событие не является доказательством копирования или наличия корня уровня.