LogoPixi’VN
Narration/Narration with 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.

UI screen

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

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(). Questa funzione ha i seguenti parametri:

  • 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.
labels/startLabel.ts
import { narration, newLabel } from "@drincs/pixi-vn";

export const startLabel = newLabel("start_label", [
    () => {
        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";
    },
]);

Ottieni

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)
}

Rimuovi

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

narration.removeInputRequest()