Работа с ресурсами¶

В скриптах вы можете программно работать с любыми(аудио, видео, модели и т.д.) ресурсами проекта.

Important

Если вы добавили ресурс в проект, но не назначили его какому-либо объекту, то он не будет добавляться в пакет на экспорте и соответственно не будет доступен программно в скриптах. Чтобы использовать такой ресурс в скриптах, поставьте галочку “Всегда добавлять в пакет на экспорте”, выбрав необходимый ресурс во вкладке “Ресурсы”.

Note

На системах Android, если установлена опция “Всегда добавлять в пакет на экспорте”, то не устанавливайте опцию “Добавлять в assets на экспорте”, иначе чтение файла ресурса будет происходить с диска, а не из оперативной памяти.

Типы ресурсов¶

Тип ресурса	Описание
Resource.Kind.MODEL	3D Модели. Поддерживаемые форматы: “fbx”, “gltf”, “glb”, “obj”, “osgb”, “osgt”
Resource.Kind.SCRIPT	Скрипты. Поддерживаемые форматы: “lua”
Resource.Kind.IMAGE	Изображения. Поддерживаемые форматы: “png”, “bmp”, “jpg”, “jpeg”, “tiff”, “tif”, “hdr”, “dds”, “ktx”
Resource.Kind.AUDIO	Аудио. Поддерживаемые форматы: “ogg”, “wav”, “flac”, “mp3”
Resource.Kind.VIDEO	Видео. Поддерживаемые форматы: “webm”
Resource.Kind.FONT	Шрифты. Поддерживаемые форматы: “ttf”, “otf”, “woff”
Resource.Kind.CONFIG	Файлы конфигурации. Поддерживаемые форматы: “csv”, “xml”, “json”, “txt”, “arobject”
Resource.Kind.LIBRARY	Библиотеки. Поддерживаемые форматы: “dll”, “so”, “dylib”
Resource.Kind.UNDEFINED	Прочие файлы

Управление ресурсами проекта¶

Управление ресурсами проекта осуществляется с помощью глобального объекта resourceRepository. Ниже описаны его методы:

Метод	Описание
`getResourcesCount(aKind)`	Возвращает количество ресурсов в проекте заданного типа. Параметр: `aKind` - тип ресурса. Если не указан, то метод вернет общее количество ресурсов проекта.
`addResource(aResource)`	Добавляет указанный ресурс в репозиторий ресурсов. Параметр: `aResource` - ресурс, который необходимо добавить.
`removeResource(aId)`	Удаляет ресурс с указанным идентификатором из репозитория ресурсов. Параметр: `aId` - идентификатор ресурса, который необходимо удалить.
`findResourcesByPrefix(aPrefix, aCaseSensitive)`	Находит ресурс по префиксу. Параметры: `aPrefix` - префикс ресурса. `aCaseSensitive` - флаг, учитывать ли регистр букв.
`removeResource(aId)`	Удаляет ресурс с указанным идентификатором из репозитория ресурсов. Параметр: `aId` - идентификатор ресурса, который необходимо удалить.
`getResourceById(aId)`	Возвращает ресурс с указанным идентификатором. Параметр: `aId` - идентификатор ресурса.
`getResourceByName(aName, aKind)`	Самый часто используемый метод. Возвращает ресурс с указанным именем файла. Параметры: `aName` - имя файла ресурса. `aKind` - тип ресурса. Если не указан, будет произведен поиск по всем типам ресурсов.
`getResourcePath(id)`	Возвращает путь к файлу ресурса с указанным идентификатором. Параметры: `id` - идентификатор ресурса.

Пример кода:

local audio = reactorController:getReactorByName("audio")

resource = resourceRepository:getResourceByName("sound.mp3")

audio.audioResource = resource

audio:play()

Документация

Работа с ресурсами¶

Типы ресурсов¶

Управление ресурсами проекта¶