Pixi’VN

Sonidos y música

Cómo reproducir, pausar, reanudar, editar y detener sonidos y música en Pixi’VN utilizando media, channels y el gestor de sonido, incluyendo transiciones de fundido y filtros, basado en Tone.js.

Todo el sistema de audio ha sido revisado en la versión 1.6.0/1.8.0.

El módulo de sonido es un envoltorio de la librería Tone.js. Proporciona una interfaz sencilla para reproducir sonidos y guarda el estado actual en cada step.

ink

Puedes usar este método con la sintaxis ink. Consulta más información aquí.

import { narration, newLabel, sound } from "@drincs/pixi-vn";

export const startLabel = newLabel("start", [
    async () => {
        await sound.play("sfx_whoosh", { delay: 0.1 });
        await sound.play("bgm_cheerful", { loop: true, channel: "bgm" });
        narration.dialogue =
            "Hello, I'm a cheerful background music that will loop forever until you stop me.";
    },
    () => {
        sound.pause("bgm_cheerful");
        narration.dialogue = "I'm paused, but I can be resumed.";
    },
    () => {
        sound.resume("bgm_cheerful");
        narration.dialogue = "I'm back!";
    },
]);

Inicializar

También se recomienda definir los channels inmediatamente después de la inicialización del juego. Para hacerlo, puedes utilizar la función sound.channels.add.

main.ts
import { Game, sound } from "@drincs/pixi-vn";

Game.init(body, {
    // ...
}).then(() => {
    sound.channels.add("bgm", { background: true });
    sound.channels.add("sfx");
    sound.defaultChannelAlias = "sfx";
});

Reproducción

Si no se especifica ningún channel durante la función play, el media se asignará a sound.defaultChannelAlias.

La funcionalidad básica consiste en iniciar un sonido (asset). Esto se puede hacer utilizando la función play. La función play genera una instancia de media con la que puedes interactuar para controlar el sonido producido.

Transiciones

Pausa y reanudación

Hay varias formas de pausar uno o varios media.

Editar

Solo los ajustes de media se guardarán en los archivos de guardado del juego.

Es posible editar casi todos los ajustes en cualquier momento para diferentes propósitos.

Detención

Para detener un sonido, puedes utilizar la función stop.

Filtros

Actualmente, solo se pueden modificar al iniciar un media.

Los filtros son elementos que permiten una personalización avanzada de los sonidos.

Otras funcionalidades

En esta página