audioAlert(filename,pos,despam)

/* #######################################################################################
   audioAlert.js v0.1
   audioAlert(filename, pos despam) -- plays an audio alert to the human player
   
   * filename -- Required: Filename (including .ogg extension) of audio file to play
   * pos      -- Optional: Display a beacon on mini map by passing in a game object
   * despam   -- Optional: Throttle the alert, default 2000ms before playing it again
   ####################################################################################### */

// Play an audio alert (de-spammed):
function audioAlert(filename, pos, despam) {
  if ( (!(filename in audioAlert.despam)) || audioAlert.despam[filename] < gameTime ) {
    // define when this particular alert can next be played
    audioAlert.despam[filename] = gameTime + (despam || 2000); // default to 2 second despam
    // play sound and show beacom where the event occurred
    (!!pos) ? playSound(filename,pos.x,pos.y,pos.z) : playSound(filename);
  }
}
// Lookup table of time when an alert was last played
audioAlert.despam = {};

// welcome player to the game
eventStartLevel() {
  audioAlert("pcv476.ogg");
}
 
// tell me when a structure is destroyed (but no more than once per 5 seconds)
eventDestroyed(victim) {
  if (victim.type == STRUCTURE && !victim.status) {
    audioAlert("pcv340.ogg", victim, 5000);
  }
}