Consistent Audio Plugin

じ☆ve冰风 · 发表于 6 天前

Consistent Audio (CA) v1.01
Author: Michael Morris @Blue Booth Studios

Introduction
Hailed by some as "the most useful plugin of all time," Consistent Audio (CA) is one of two planned plugins for consistent map state between map transitions, saves, and loads (the second being Consistent Weather (CW)).  In est, CA automatically ensures that the BGM and BGS you last have playing on a map will always play for that map.  If the BGM or BGS changes, it will become the new "last BGM/BGS" for that map.  If you transition to another map, and then back to the first map, BGM/BGS will be lost without the use of parallel events.  Not anymore!  Likewise, loading a saved game can often result in different BGM/BGS without use of the same events.  This is also no longer a problem.  BGM/BGS Fadein and Fadeout?  Automated for you.  BGM/BGS will fade out and then in when changing maps.  Fadein is also automatically called whenever a new BGM/BGS plays.  Tracking any custom volumes, pitch, and pan for both BGM/BGS are also automated.

To be blunt, the value of this plugin does not lay in its ability to do something that could not be done without events, but rather, to simplify development and testing.  With CA, having the BGM/BGS you expect to have playing, playing, is a much simpler task; in fact, no audio parallel events, switches, or variables are necessary!

The only commands you need to make to BGM/BGS are the play and fadeout commands.  This logic can be as complicated or simple as you need.  Once the BGM/BGS starts playing, everything else is taken care of for you.

Features
- Uses triage to determine what BGM/BGS to play; if CA has a BGM/BGS stored for the target map already, it will play that BGM/BGS.  If no BGM/BGS is already stored, it will attempt to play the Map BGM/BGS (defined in Map Properties).  If neither of the two are set, CA will play nothing.  If and when an event on the target map later plays a BGM/BGS, CA will store that BGM/BGS.

- CA saves an array of all map audio settings into player save files, when the player elects to save the game.  This reduces the change for inconsistencies arising from resetting the game after a BGM/BGS change takes effect, and allows for saving more than one map audio state (very important when returning to other maps).  The downside to this is that it will increase the size of player save files, but given that the save data is in text format, save files are not expected to bloat to unreasonable levels.

- BGM/BGS are remembered for every single map in your project.  In comparison, the "Save BGM/BGS" and "Replay BGM/BGS" commands in RMMV will only remember the current map's audio.

- BGM/BGS are remembered across save, loads, and program exits.  In comparison, the "Save BGM/BGS" and "Replay BGM/BGS" commands in RMMV will not remember across any of these scenarios.

- Apart from merely playing BGM/BGS, changes to volume, pitch, pan are also stored and remembered.

- Automatically fades out BGM/BGS, and fades in new BGM/BGS during map transitions.

- Autoplay BGM/BGS (Map settings) are now also set to (automatically) fade-in when loading from a save file.

- Sets all audio fades to one universal fade-in duration of your choice.

- Compatible with projects that already use parallel events, switches, or variables to track audio state.

- Storage settings can be overwritten.  Using the "ConsistentAudio IgnoreNext," "ConsistentAudio IgnoreNextBGM," and
"ConsistentAudio IgnoreNextBGS") commands will instruct CA not to store the next BGM/BGS change (IgnoreNextBGM and IgnoreNextBGS provide greater granularity over this override).  After the next change is ignored, CA will resume storing changes.

- Fast.  No perceptible performance drop was noted during tests.

How to Use
- Copy script into your game js/plugins directory.
- Import and configure plugin.

Requirements
This script has no external requirements.

Screenshots
N/A

Demo
See attachments.
To run the demo, create a new project in RPGMaker MV, and extract the provided
archive to the root folder of the new project.  If prompted to overwrite any files, select yes.

Script
Spoiler Code:

//=============================================================================
// Bluebooth Plugins - Consistent Audio
// BBS_ConsistentAudio.js
//=============================================================================
//=============================================================================
/*:
* @plugindesc v1.01 Keep BGS/BGM consistent when transitioning between maps,
* after loading a saved file, transitioning to and from menus, etc. In other words
* this eliminates the need for checks on every map to confirm the right BGM/BGS/BGM
* is playing.
* @author Michael Morris
*
* @param Universal Fade Duration
* @desc How many frames audio should take to fade in and out. 6 by default.
* Default: 6
* @default 6
*
* @param ---Debug Settings---
* @default
*
* @param Debug Mode
* @desc Enable to activate console variable logging. Use for debugging odd behaviour.
* true to enable console variable logging.
* @default false
*
* @help
* ============================================================================
* Introduction
* ============================================================================
*
* One of my biggest pet peeves with RPG Maker MV is that it doesn't track the most
* recent weather and BGS/BGM when transitioning to an interior and then back to
* the exterior map again, or during save and loads! This is mostly a problem on
* maps where these conditions can change based on scripts (ie. the map is normally
* a "day" map, but with a time change is now a "night" map). It would be really
* helpful if such settings could be tracked for you. So I made it happen.
* This cuts down on debugging time (you won't need to check every door during
* every condition change to see which door loses changes), and
* just makes development life more pleasant.
*
* ============================================================================
* Plugin Commands
* ============================================================================
*
* consistentAudio ignoreNext Do not save the next audio change for BGM or BGS, whichever comes first.
* consistentAudio ignoreNextBgm Do not save the next audio change for BGM only.
* consistentAudio ignoreNextBgs Do not save the next audio change for BGS only.
*
* ============================================================================
* Versions
* ============================================================================
* 1.01 - Plugin finished.
*
*/
//=============================================================================
//=============================================================================
//=============================================================================
var Imported = Imported || {} ;
var BBS = BBS || {};
Imported.ConsistentAudio = 1;
BBS.ConsistentAudio = BBS.ConsistentAudio || {};
(function() {
//=============================================================================
// Parameter Variables
//=============================================================================
var parameters = PluginManager.parameters('BBS_ConsistentTimeWeather');
// Save variables (weather)
var universalDuration = Number(parameters['Universal Fade Duration'] || 6);
// Other
var debugging = eval(String(parameters['Debug Mode'] || 'false'));
// Track audio
var $mapConditions = null;
var ignoreNextBgm = false;
var ignoreNextBgs = false;
//=============================================================================
// Game_Interpreter
//=============================================================================
var BBS_CA_Game_Interpreter_pluginCommand = Game_Interpreter.prototype.pluginCommand;
Game_Interpreter.prototype.pluginCommand = function(command, args) {
if (command === 'consistentAudio') {
switch (args[0])
{
case 'ignoreNext':
ignoreNextBgm = true;
ignoreNextBgs = true;
break;
case 'ignoreNextBgm':
ignoreNextBgm = true;
break;
case 'ignoreNextBgs':
ignoreNextBgs = true;
break;
};
}
else {
BBS_CA_Game_Interpreter_pluginCommand.call(this, command, args);
}
};
// Fadeout BGM - need to update BGM Saved Audio.
var BBS_CA_GameInterpreter_command242 = Game_Interpreter.prototype.command242;
Game_Interpreter.prototype.command242 = function() {
if (ignoreNextBgm === true) {
ignoreNextBgm = false;
return BBS_CA_GameInterpreter_command242.call(this);
}
// Make sure $gameMap exists
if (SceneManager._scene instanceof Scene_Map) {
$mapConditions.setBGM($gameMap.mapId(), AudioManager.makeEmptyAudioObject());
}
return BBS_CA_GameInterpreter_command242.call(this);
};
// Fadeout BGS - need to update BGS Saved Audio.
var BBS_CA_GameInterpreter_command246 = Game_Interpreter.prototype.command246;
Game_Interpreter.prototype.command246 = function() {
if (ignoreNextBgs === true) {
ignoreNextBgs = false;
return BBS_CA_GameInterpreter_command246.call(this);
}
// Make sure $gameMap exists
if (SceneManager._scene instanceof Scene_Map) {
$mapConditions.setBGS($gameMap.mapId(), AudioManager.makeEmptyAudioObject());
}
return BBS_CA_GameInterpreter_command246.call(this);
};
//=============================================================================
// Map_Conditions
//=============================================================================
function Map_Conditions() {
this.initialize.apply(this, arguments);
};
Map_Conditions.prototype.initialize = function() {
this._savedBGMs = {};
this._savedBGSs = {};
};
Map_Conditions.prototype = Object.create(Map_Conditions.prototype);
Map_Conditions.prototype.constructor = Map_Conditions;
Map_Conditions.prototype.getBGM = function(mapId) {
console.log(this._savedBGMs);
if (this._savedBGMs[mapId] !== undefined) {
return this._savedBGMs[mapId];
}
console.log("getBGM with mapId " + mapId + " not found.");
return undefined;
};
Map_Conditions.prototype.getBGS = function(mapId) {
if (this._savedBGSs[mapId] !== undefined) {
return this._savedBGSs[mapId];
}
console.log("getBGS with mapId " + mapId + " not found.");
return undefined;
};
Map_Conditions.prototype.setBGM = function(mapId, bgm) {
this._savedBGMs[mapId] = {
name: bgm.name,
volume: bgm.volume,
pitch: bgm.pitch,
pan: bgm.pan,
pos: 0
};
};
Map_Conditions.prototype.setBGS = function(mapId, bgs) {
this._savedBGSs[mapId] = {
name: bgs.name,
volume: bgs.volume,
pitch: bgs.pitch,
pan: bgs.pan,
pos: 0
};
};
//=============================================================================
// Game_Player
//=============================================================================
var BBS_CA_performTransfer = Game_Player.prototype.performTransfer;
Game_Player.prototype.performTransfer = function() {
AudioManager.fadeOutBgm(universalDuration);
AudioManager.fadeOutBgs(universalDuration);
BBS_CA_performTransfer.call(this);
};
//=============================================================================
// Data_Manager
//=============================================================================
var BBS_CA_DataManager_makeSaveContents = DataManager.makeSaveContents;
DataManager.makeSaveContents = function() {
var contents = BBS_CA_DataManager_makeSaveContents.call(this);
contents.savedBGMs = $mapConditions._savedBGMs;
contents.savedBGSs = $mapConditions._savedBGSs;
if (debugging === true) {
console.log("Saved BGM and BGS conditions.");
}
return contents;
};
var BBS_CA_DataManager_extractSaveContents = DataManager.extractSaveContents;
DataManager.extractSaveContents = function(contents) {
BBS_CA_DataManager_extractSaveContents.call(this, contents);
$mapConditions = new Map_Conditions();
console.log(contents.savedBGMs);
$mapConditions._savedBGMs = contents.savedBGMs;
$mapConditions._savedBGSs = contents.savedBGSs;
if (debugging === true) {
console.log("Extracted BGM and BGS saved conditions.");
}
};
var BBS_CA_DataManager_createGameObjects = DataManager.createGameObjects;
DataManager.createGameObjects = function() {
BBS_CA_DataManager_createGameObjects.call(this);
// Create global map conditions class
$mapConditions = new Map_Conditions();
if (debugging === true) {
console.log("Created Map Conditions object.");
}
};
//=============================================================================
// Game_System
//=============================================================================
// For handling custom data...
Game_System.prototype.storeBgm = function(mapId) {
if (ignoreNextBgm === true) {
ignoreNextBgm = false;
return;
}
var bgm = AudioManager.saveBgm();
$mapConditions.setBGM(mapId, bgm);
if (debugging === true) {
console.log("Stored BGM for " + mapId);
console.log(mapId);
console.log(JSON.stringify(bgm));
}
};
Game_System.prototype.storeBgs = function(mapId) {
if (ignoreNextBgs === true) {
ignoreNextBgs = false;
return;
}
var bgs = AudioManager.saveBgs();
$mapConditions.setBGS(mapId, bgs);
if (debugging === true) {
console.log("Stored BGS for " + mapId);
console.log(mapId);
console.log(JSON.stringify(bgs));
}
};
Game_System.prototype.retrieveBgm = function(mapId) {
console.log($mapConditions.getBGM(mapId));
var bgm = $mapConditions.getBGM(mapId);
console.log($dataMap);
// If we don't already have the BGM logged, log the BGM of the current map. If that's not set, play nothing.
if (bgm === undefined) {
if ($dataMap.autoplayBgm) {
bgm = $dataMap.bgm;
} else {
bgm = AudioManager.makeEmptyAudioObject();
}
}
AudioManager.playBgm(bgm, bgm.pos);
AudioManager.fadeInBgm(universalDuration);
};
Game_System.prototype.retrieveBgs = function(mapId) {
var bgs = $mapConditions.getBGS(mapId);
// If we don't already have the BGS logged, log the BGS of the current map. If that's not set, play nothing.
if (bgs === undefined) {
if ($dataMap.autoplayBgs) {
bgs = $dataMap.bgs;
} else {
bgs = AudioManager.makeEmptyAudioObject();
}
}
AudioManager.playBgs(bgs, bgs.pos);
AudioManager.fadeInBgs(universalDuration);
};
//=============================================================================
// AudioManager
//=============================================================================
var BBS_CA_AudioManager_initialize = AudioManager.initialize;
AudioManager.initialize = function() {
BBS_CA_AudioManager_initialize.call(this);
AudioManager._replayFadeTime = universalDuration;
};
var BBS_CA_AudioManager_playBgm = AudioManager.playBgm;
AudioManager.playBgm = function(bgm, pos) {
BBS_CA_AudioManager_playBgm.call(this, bgm, pos);
if (SceneManager._scene instanceof Scene_Map) {
$gameSystem.storeBgm($gameMap.mapId());
}
this.fadeInBgm(universalDuration);
};
var BBS_CA_AudioManager_playBgs = AudioManager.playBgs;
AudioManager.playBgs = function(bgs, pos) {
BBS_CA_AudioManager_playBgs.call(this, bgs, pos);
if (SceneManager._scene instanceof Scene_Map) {
$gameSystem.storeBgs($gameMap.mapId());
}
this.fadeInBgs(universalDuration);
};
var BBS_CA_AudioManager_stopBgm = AudioManager.stopBgm;
AudioManager.stopBgm = function() {
BBS_CA_AudioManager_stopBgm.call(this);
//$gameSystem.storeBgm(this.makeEmptyAudioObject(), 0);
};
var BBS_CA_AudioManager_stopBgs = AudioManager.stopBgs;
AudioManager.stopBgs = function() {
BBS_CA_AudioManager_stopBgs.call(this);
//$gameSystem.storeBgs(this.makeEmptyAudioObject(), 0);
};
//=============================================================================
// Game_Map
//=============================================================================
// Overwrite necessary to force loading of correct audio!
Game_Map.prototype.autoplay = function() {
var mapId = $gameMap.mapId();
$gameSystem.retrieveBgm(mapId);
$gameSystem.retrieveBgs(mapId);
};
//=============================================================================
// Scene_Map
//=============================================================================
Scene_Map.prototype.reloadCondition = function() {
$gameSystem.retrieveBgm($gameMap.mapId());
$gameSystem.retrieveBgs($gameMap.mapId());
}
Scene_Map.prototype.saveCondition = function() {
$gameSystem.storeBgm($gameMap.mapId());
$gameSystem.storeBgs($gameMap.mapId());
};
// Save current state of map before transitioning to another map, to battle, or to menu.
var BBS_CTW_Scene_Map_updateScene = Scene_Map.prototype.updateScene;
Scene_Map.prototype.updateScene = function() {
this.checkGameover(); // Do not save condition if game over.
this.saveCondition();
BBS_CTW_Scene_Map_updateScene.call(this);
};
})(BBS.ConsistentAudio);
//=============================================================================
// End of File
//=============================================================================

复制代码

Change Log
1.01
- Plugin finished.

Known Bugs / TODO
Suggestions, bug reports, and feature requests are welcomed!

Compatibility Issues
None known.

Credit and Thanks
- Micheal Morris @Blue Booth Studios

Author's Notes
Free for non-commercial as long as credit is given.
Please contact me regarding commercial usage.

No extra JSON file necessary.

本贴来自国际rpgmaker官方论坛作者:bluebooth处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/consistent-audio-plugin.77448/

下载

教程

申请

插件

下载

教程

插件

下载

教程

插件

[转载发布] Consistent Audio Plugin

本帖子中包含更多资源

灌水之王

幸运抽奖