LogoPixi’VN

Sonidos y música

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

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

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

ink

Puedes usar este método con la sintaxis ink. Descubre más 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!";
    },
]);

Initialize

También se recomienda definir los channels inmediatamente después de la inicialización del juego. To do this, you can use the sound.channels.add function.

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 usando la función play. La función play genera una instancia 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 usar 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