Assets

Cosa sono gli assets? Gli assets sono tutti i file che non sono codice, come immagini, suoni e video.

È possibile utilizzare asset salvati localmente nel progetto oppure online (per la seconda opzione, è necessario assicurarsi che il servizio cloud utilizzato consenta le richieste CORS). Se i tuoi asset sono online, il gioco richiederà una connessione Internet. Se non c'è connessione, dovresti avvisare l'utente e bloccare il gioco.

Se stai creando una visual novel, è consigliabile conservare localmente gli asset utilizzati di frequente. Per gli asset utilizzati una sola volta nel gioco, è meglio pubblicarli online.

Per caricare e manipolare assets (immagini, gif, video, ecc.) sarà necessario utilizzare Assets. Assets è una classe con molte funzionalità e proviene dalla libreria PixiJS. Per maggiori informazioni, leggere qui. È inoltre molto importante leggere questa documentazione per organizzare al meglio il caricamento delle risorse.

Principalmente hai due possibilità per salvare i tuoi asset: localmente o online.

Assets del progetto

Per salvare e utilizzare le risorse in locale, puoi usare qualsiasi cartella: non ci sono restrizioni. Tuttavia, si consiglia di utilizzare la cartella assets. All'interno di questa cartella puoi creare delle sottocartelle per organizzare meglio i tuoi assets.

Ecco un esempio di come importare e caricare una risorsa nel tuo progetto:

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

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

Hosting degli assets

Puoi salvare i tuoi assets online. Questa è una buona opzione se vuoi risparmiare spazio sul tuo computer. Puoi utilizzare qualsiasi servizio cloud che ti consenta di caricare file e generare un URL pubblico (CORS abilitato).

Ecco un esempio di come importare e caricare una risorsa nel tuo progetto:

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",
});

Puoi salvare i tuoi assets come preferisci, in totale libertà. Se intendi salvare i tuoi assets online, ecco alcune opzioni:

Altre funzionalità