LogoPixi’VN
NarrazioneNarrazione con JS/TS

Richiesta di input

Spiega come richiedere input al giocatore in Pixi’VN, incluso l'utilizzo, il recupero e la rimozione delle richieste di input.

Schermata UI

Un esempio dell'interfaccia utente della finestra di dialogo di input è disponibile nella sezione esempi di interfaccia.

ink

Puoi usare questo metodo con la sintassi ink. Scopri di più qui.

Nelle visual novel potrebbe essere necessario chiedere al giocatore di inserire testo, numeri, date o altri valori.

Pixi’VN fornisce funzioni per gestire le richieste di input. Lo sviluppatore può richiedere al giocatore di immettere un valore (il gioco non continuerà finché non verrà fornito un valore), mentre l'interfaccia utente è responsabile della visualizzazione del prompt.

Richiesta

Per richiedere un input al giocatore, utilizza la funzione narration.requestInput(). This function has the following parameters:

  • props: Un oggetto con proprietà di prompt di input:
    • type (Opzionale): Tipo di prompt di input (stringa).
  • defaultValue (Opzionale): Valore predefinito da visualizzare nel campo di input.
content/labels/start.label.ts
import { narration, newLabel } from "@drincs/pixi-vn";

export const startLabel = newLabel("start", [
    () => {
        narration.dialogue = "Hello";
    },
    () => {
        narration.dialogue = "What is your name?";
        narration.requestInput({ type: "string" });
    },
    () => {
        narration.dialogue = `My name is ${narration.inputValue}`;
    },
    () => {
        narration.dialogue = "How old are you?";
        narration.requestInput({ type: "number" }, 18);
    },
    () => {
        narration.dialogue = `I am ${narration.inputValue} years old`;
    },
    () => {
        narration.dialogue = "Describe who you are:";
        narration.requestInput({ type: "html textarea" });
    },
    () => {
        narration.dialogue = `${narration.inputValue}`;
    },
    () => {
        narration.dialogue = "Restart";
    },
]);

Ottenere

Per ottenere informazioni di input, utilizzare:

  • narration.isRequiredInput: restituisce true se il giocatore deve immettere un valore.
  • narration.inputType: restituisce il tipo di prompt di input richiesto.
if (narration.isRequiredInput) {
    openInputModal(narration.inputType);
}

Remove

Per rimuovere la richiesta di prompt di input, utilizzare narration.removeInputRequest().

narration.removeInputRequest();

On this page