LogoPixi’VN

Live2D

How to use the Live2D integration in Pixi’VN to load models, play motions, switch expressions, and combine them with Pixi’VN's own animations — the character animation style popular in Gal Games.

L'integrazione di Live2D è al momento in una fase di test, e la sua API potrebbe subire modifiche nelle versioni future.

Nel tuo progetto di Pixi'VN, puoi utilizzare l'integrazione di Live2D per mostrare e animare i modelli di Live2D per i tuoi personaggi. Questa integrazione funge da strato di astrazione per untitled-pixi-live2d-engine; nota che questo non è un plugin ufficiale di PixiJS/Live2D, ma un motore gestito dalla community che collega Live2D a PixiJS, consentendoti di utilizzarne le funzionalità, direttamente nel tuo progetto di Pixi'VN.

Installazione

Per installare il pacchetto di Live2D in un progetto JavaScript esistente, utilizza uno dei seguenti comandi:

npm install @drincs/pixi-vn-live2d

extensions.add(Live2DPlugin) dev'essere chiamato all'avvio, nel tuo file principale, prima che Game.init sia chiamato.

main.ts
import { extensions } from "pixi.js";
import { Live2DPlugin } from "@drincs/pixi-vn-live2d/core";
extensions.add(Live2DPlugin);

Game.init(body, {
    // ...
});

Utilizzo

Puoi utilizzare il componente Live2D proprio come qualsiasi altro componente di Pixi’VN. A differenza di Spine, un modello di Live2D non dev'essere precaricato tramite Assets.load; la registrazione dell'alias con Assets.add è sufficiente, poiché Live2D si occupa automaticamente di risolvere e recuperare il modello.

Poiché tale recupero è asincrono, il modello non è sicuro da utilizzare finché la sua promessa ready si risolve; esegui await subito dopo la costruzione, prima di leggere qualsiasi cosa che derivi dal modello caricato (es., le sue dimensioni).

Ad esempio:

main.ts
import { canvas } from "@drincs/pixi-vn";
import { Live2D } from "@drincs/pixi-vn-live2d";

const live2d = new Live2D({
    source: "shizuku",
    xAlign: 0.5,
    yAlign: 1,
    scale: 0.5,
});
await live2d.ready;
canvas.add("shizuku", live2d);

In questa pagina