Pixi’VNReact UI
Как интегрировать Pixi’VN с React, включая настройку, шаблоны и лучшие UI-библиотеки. Создание визуальных новелл или 2D-игр с React.
Что такое React? React — это JavaScript-библиотека для создания пользовательских интерфейсов (UI) для веб-сайтов, приложений и других платформ. Она бесплатна, имеет открытый исходный код и поддерживается компанией Meta (ранее Facebook) и большим сообществом.
Подробнее о React можно узнать на React website.
Как добавить Pixi’VN в React-приложение
React template
Доступны шаблоны Pixi’VN, использующие React. Подробнее о них можно прочитать в разделе templates.
Если вы хотите добавить Pixi’VN в существующее React-приложение, следуйте шагам ниже.
Сначала вам понадобится React-приложение и необходимо установить pixi-vn. Для создания нового React-приложения рекомендуется использовать Vite.
Затем вы можете заменить содержимое следующих файлов кодом из примеров:
import { Assets, canvas, Container, drawCanvasErrorHandler, Game, showImage, sound } from "@drincs/pixi-vn";
import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import App from "./App.tsx";
import "./index.css";
createRoot(document.getElementById("root")!).render(
const body = document.body;
if (!body) {
throw new Error("body element not found");
}
Game.init(body, {
height: 1080,
width: 1920,
backgroundColor: "#303030",
resizeMode: "contain",
}).then(() => {
showImage(
"juliette",
"https://raw.githubusercontent.com/DRincs-Productions/pixi-vn-bucket/refs/heads/main/icon.webp",
{ xAlign: 0.9, yAlign: 0.1, anchor: 0.5 },
).then(() => {
canvas.animate("juliette", { angle: 360 }, { repeat: Infinity, duration: 5 });
});
// Pixi.JS UI Layer
canvas.addLayer("ui", new Container());
// Sound setup
sound.addChannel("bgm", { background: true });
sound.addChannel("sfx");
sound.defaultChannelAlias = "sfx";
// React setup with ReactDOM
const root = document.getElementById("root");
if (!root) {
throw new Error("root element not found");
}
const htmlLayout = canvas.addHtmlLayer("ui", root);
if (!htmlLayout) {
throw new Error("htmlLayout not found");
}
const reactRoot = createRoot(htmlLayout);
reactRoot.render(
<StrictMode>
<App />
</StrictMode>,
)
});
Game.onEnd(async (props) => {
Game.clear();
// Navigate to the main menu after the game ends
});
Game.addOnError(drawCanvasErrorHandler());
Game.addOnError((error, props) => {
console.error(`Error occurred`, error);
});
Game.onLoadingLabel((_stepId, { id }) => Assets.backgroundLoadBundle(id));