LogoPixi’VN

Sons et musique

Comment lire, mettre en pause, reprendre, modifier et arrêter des sons et de la musique dans Pixi’VN à l'aide de media, channels et du gestionnaire sound, y compris les transitions en fondu et les filtres, basé sur Tone.js.

L'ensemble du système audio a été révisé dans la version 1.6.0/1.8.0.

Le module sound est un wrapper autour de la bibliothèque Tone.js. Il fournit une interface simple pour lire des sons et enregistre l'état actuel à chaque step.

ink

Vous pouvez utiliser cette méthode avec la syntaxe ink. Découvrez-en plus ici.

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

Il est également recommandé de définir les channels immédiatement après l'initialisation du jeu. 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";
});

Lecture

Si aucun channel n'est spécifié lors de la fonction play, le media sera assigné à sound.defaultChannelAlias.

La fonctionnalité de base consiste à démarrer un son (asset). Cela peut être fait à l'aide de la fonction play. La fonction play génère une instance media avec laquelle vous pouvez interagir pour contrôler le son produit.

Transitions

Pause et reprise

Il existe plusieurs façons de mettre en pause un ou plusieurs media.

Modifier

Seuls les paramètres de media seront sauvegardés dans les fichiers de sauvegarde de jeu.

Il est possible de modifier presque tous les paramètres à tout moment pour différentes finalités.

Arrêt

Pour arrêter un son, vous pouvez utiliser la fonction stop.

Filtres

Actuellement, ils ne peuvent être modifiés qu'au démarrage d'un media.

Les filtres sont des éléments qui permettent une personnalisation avancée des sons.

Autres fonctionnalités

Sur cette page