资源

什么是资源？资源是指一切非代码的文件，如图片、音频和视频。

你既可以使用项目中保存在本地的资源，也可以使用在线资源。若选择在线资源，你需要确保你使用的云服务支持CORS（跨域资源共享）请求。 如果使用在线资源，你的游戏将需要网络连接。 如果缺少网络连接，你应该及时通知用户，并阻止游戏继续运行。

如果你正在制作的是视觉小说，建议将频繁使用的资源存储在本地。 而对于那些在游戏中仅使用一次的资源，则更适合发布在线上。

要加载和操作资源（如图片、动图、视频等）， 需要使用 Assets。 Assets来自PixiJS库，是一个具有丰富功能的类。 如要了解更多信息，请参阅此处。 我们强烈建议你阅读这份文档，以便于更好地组织资源的上传工作。

你主要有两种存储资源的选择：本地或在线。

本地资源

要在本地保存与使用资源，你可以使用任意文件夹，没有限制。 不过，建议使用assets文件夹。 在该文件夹内，你可以创建子文件夹，来更好地组织资源。

以下是如何在项目中导入及加载资源的示例：

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

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

资源托管

你可以将你的资源保存在线上。 如果想节省电脑空间的话，这是一个不错的选择。 你可以使用任何允许上传文件并生成公开URL（需启用 CORS）的云服务。

以下是如何在项目中导入及加载资源的示例：

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

你可以随心所欲、完全自由地按照自己的喜好保存资源。 如果你计划将资源保存在线上，这里有一些可选方案：

其他叙事功能