Звуки и музыка

Модуль sound — это обёртка над библиотекой Tone.js. Он предоставляет простой интерфейс для воспроизведения звуков и сохраняет текущее состояние на каждом нарративном шаге (step).

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

Также рекомендуется определить channels сразу после инициализации игры. To do this, you can use the sound.channels.add function.

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

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

Воспроизведение

Базовая функциональность заключается в запуске звука (asset). Это можно сделать с помощью функции play. Функция play создаёт экземпляр media, с которым вы можете взаимодействовать, чтобы управлять воспроизводимым звуком.

Переходы

Пауза и возобновление

Существуют различные способы приостановить один или несколько media.

Редактировать

Можно редактировать почти все настройки в любое время для разных целей.

Остановка

Чтобы остановить звук, вы можете использовать функцию stop.

Фильтры

Фильтры — это элементы, позволяющие выполнять расширенную настройку звуков.

Другие возможности