@bitsy/hecks
Version:
a collection of re-usable scripts for bitsy game maker
77 lines (65 loc) ā¢ 2.34 kB
JavaScript
/**
š
@file basic sfx
@summary "walk" and "talk" sound effect support
@license MIT
@version 2.0.3
@author Sean S. LeBlanc
@description
Adds a basic sound effect API and hooks up "walk" and "talk" sound effects
The walk sound effect plays every time the player moves.
The talk sound effect plays every time the dialog box changes "pages" (e.g. when it opens, when the player presses a key to continue).
Includes an optional feature which makes sound effect volume reduce if it was played recently.
HOW TO USE:
1. Place your "walk" and "talk" sound files somewhere relative to your bitsy html file
2. Copy-paste `<audio id="walk" src="<relative path to your walk sound file>" preload="auto" volume="1.0"></audio>` into the <body> of your document
3. Copy-paste `<audio id="talk" src="<relative path to your talk sound file>" preload="auto" volume="1.0"></audio>` into the <body> of your document
4. Copy-paste this script into a script tag after the bitsy source
Additional sounds can be added by by including more <audio> tags with different ids and calling `sounds.<sound id>()` as needed.
If you'd like to trigger sounds from dialog, check out the bitsymuse hack!
*/
import bitsy from "bitsy";
import {
before,
after
} from "./helpers/kitsy-script-toolkit";
export var hackOptions = {
beNiceToEars: true // if `true`, reduces volume of recently played sound effects
};
var sounds = {};
before('startExportedGame', function () {
function playSound(sound) {
if (hackOptions.beNiceToEars) {
// reduce volume if played recently
sound.volume = Math.min(1.0, Math.max(0.25, Math.pow((bitsy.prevTime - sound.lastPlayed) * .002, .5)));
sound.lastPlayed = bitsy.prevTime;
}
// play sound
if (sound.paused) {
sound.play();
} else {
sound.currentTime = 0;
}
}
// get sound elements
var s = document.getElementsByTagName("audio");
for (var i in s) {
if (Object.prototype.hasOwnProperty.call(s, i)) {
i = s[i];
i.lastPlayed = -Infinity;
i.volume = 1;
sounds[i.id] = playSound.bind(undefined, i);
}
}
});
// walk hook
after('onPlayerMoved', function () {
sounds.walk();
});
// talk hooks
after('startDialog', function () {
sounds.talk();
});
after('dialogBuffer.FlipPage', function () {
sounds.talk();
});