Pixi’VNЗвуки и музыка
Как воспроизводить, приостанавливать, возобновлять, редактировать и останавливать звуки и музыку в Pixi’VN с помощью медиа, каналов и менеджера звука, включая переходы с затуханием и фильтры, на основе Tone.js.
Вся аудиосистема была переработана в версии 1.6.0/1.8.0.
Модуль sound — это обёртка над библиотекой Tone.js. Он предоставляет простой интерфейс для воспроизведения звуков и сохраняет текущее состояние на каждом нарративном шаге (step).
ink
Этот метод можно использовать с синтаксисом ink. Подробнее здесь.
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!";
},
]);Инициализация
Также рекомендуется определить channels сразу после инициализации игры. Для этого вы можете использовать функцию sound.addChannel.
import { Game, sound } from "@drincs/pixi-vn";
Game.init(body, {
// ...
}).then(() => {
sound.addChannel("bgm", { background: true });
sound.addChannel("sfx");
sound.defaultChannelAlias = "sfx";
});Воспроизведение
Если во время выполнения функции play не указан channel, media будет назначен на sound.defaultChannelAlias.
Базовая функциональность заключается в запуске звука (asset). Это можно сделать с помощью функции play. Функция play создаёт экземпляр media, с которым вы можете взаимодействовать, чтобы управлять воспроизводимым звуком.
Переходы
Пауза и возобновление
Существуют различные способы приостановить один или несколько media.
Редактировать
Только настройки media будут сохранены в файлах сохранения игры.
Можно редактировать почти все настройки в любое время для разных целей.
Остановка
Чтобы остановить звук, вы можете использовать функцию stop.
Фильтры
В настоящее время их можно изменять только при запуске media.
Фильтры — это элементы, позволяющие выполнять расширенную настройку звуков.