LogoPixi’VN

Ресурсы

Обзор типов ресурсов и вариантов хранения (локально или онлайн) в Pixi'VN с примерами использования.

Что такое ресурсы? Ресурсы - это все файлы, не являющиеся кодом, такие как изображения, звуки и видео.

Вы можете использовать ресурсы, сохранённые локально в проекте или онлайн (для второго варианта необходимо убедиться, что используемый вами облачный сервис позволяет выполнять CORS-запросы). Если ваши ресурсы находятся в сети, ваша игра потребует подключения к интернету. Вы должны уведомить пользователя и заблокировать игру, если нет соединения.

Если вы создаёте визуальную новеллу, рекомендуется хранить часто используемые ресурсы локально. Для ресурсов, используемых только один раз в игре, лучше публиковать их онлайн.

Чтобы загружать и управлять ресурсами (изображениями, гифками, видео и т. д.) вам необходимо использовать Assets. Assets — это класс с множеством функций, который принадлежит библиотеке PixiJS. Для получения дополнительной информации, ознакомьтесь здесь. Также очень важно, чтобы вы прочитали эту документацию для лучшей организации загрузки ваших ресурсов.

У вас в основном есть два варианта, где сохранять ваши ресурсы: локально или онлайн.

Локальные ресурсы

To save and use assets locally, you can use any folder—there are no restrictions. However, it is recommended to use the assets folder. Inside this folder, you can create subfolders to better organize your assets.

Here is an example of how to import and load an asset into your project:

utils/assets.ts
import { Assets } from "@drincs/pixi-vn";
import bg01hallway from "../assets/images/bg01-hallway.webp";

Assets.add({
    alias: "bg01-hallway",
    src: bg01hallway,
});

Assets hosting

You can save your assets online. This is a good option if you want to save space on your computer. You can use any cloud service that allows you to upload files and generate a public URL (CORS enabled).

Here is an example of how to import and load an asset into your project:

utils/assets.ts
import { Assets } from "@drincs/pixi-vn";

Assets.add({
    alias: "bg01-hallway",
    src: "https://raw.githubusercontent.com/DRincs-Productions/pixi-vn-bucket/refs/heads/main/breakdown/bg01-hallway.webp",
});

You can save your assets as you like, with complete freedom. If you plan to save your assets online, here are some of the options:

Другие возможности