ModelAsset06 / 7

Загружаем GLB

Добавим в Three-сцену готовый 3D-объект.

Поместим файл tree.glb в game/assets/models/. GLB хранит 3D-объект и его ресурсы в одном файле. Загрузчик SDK принимает статический GLB 2.0 без анимации, скелета, внешних файлов и обязательных расширений.

В AssetManifestBuilder передадим поле models с URL файлов, собранными через import.meta.glob<string>('@game/assets/models/**/*.glb', { eager: true, query: '?url', import: 'default' }). Стандартная политика создаст набор models.

В SceneConfig.assets.bundles добавим 'models', а в children узла Group — дерево:

"tree": {
  "type": "Model",
  "props": {
    "asset": "models/tree.glb",
    "position": { "x": 2, "y": 0, "z": 0 }
  }
}
GLBОбщие геометрия, материалы и текстуры
ModelОтдельная иерархия каждого дерева
УдалениеУзел освобождает свой экземпляр

Узлы Model используют общие ресурсы файла, поэтому их нельзя уничтожать вручную у одного дерева. Узел освобождает свой экземпляр при удалении. Затем assets.unload('models/tree.glb') может удалить файл из кэша.

Для собственной Three-сцены внутри Pixi-текстуры можно получить ModelAsset, вызвать acquire() и добавить view в сцену. Компонент удаляет этот объект из сцены и вызывает release() при очистке. Живые экземпляры блокируют удаление общего ресурса.