Pixi’VNUI de React
Cómo integrar Pixi’VN con React, incluyendo la configuración, plantillas y las mejores bibliotecas de UI. Crea una visual novel o un juego narrativo con React.
Pixi’VN funciona muy bien como motor de visual novel en React, permitiéndote construir la UI de tu visual novel o juego narrativo con componentes de React, mientras que Pixi’VN se encarga de la narración y el canvas.
¿Qué es React? React es una biblioteca de JavaScript para crear interfaces de usuario (UI) para sitios web, aplicaciones y más. Es gratuita, de código abierto y mantenida por Meta (anteriormente Facebook) y una gran comunidad.
Puedes obtener más información sobre React en el sitio web de React.
Cómo añadir Pixi’VN a una aplicación de React
Templates
Hay plantillas de Pixi’VN disponibles que usan React. Puedes leer más sobre ellas en la sección de plantillas.Si deseas añadir Pixi’VN a una aplicación de React existente, sigue los pasos a continuación.
Si deseas añadir Pixi’VN a una aplicación de React existente, sigue los pasos a continuación.
Primero, necesitas una aplicación de React y instalar pixi-vn. Se recomienda usar Vite para crear una nueva aplicación de React.
Ahora puedes reemplazar el contenido de los siguientes archivos con el código de abajo:
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.layers.add("ui", new Container());
// Sound setup
sound.channels.add("bgm", { background: true });
sound.channels.add("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.htmlLayers.add("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));