1. Class definition

========================================================

function SoundPlayer(scriptNameForSounds) {

    LL.bindClass(‘java.io.File’);

    LL.bindClass(‘java.io.FileInputStream’);            

    LL.bindClass(‘java.io.FileOutputStream’);

    LL.bindClass(‘android.os.Environment’);

    LL.bindClass(‘android.media.MediaPlayer’);

    LL.bindClass(‘android.util.Base64’);

    this.SCRIPT_NAME_FOR_SOUNDS = scriptNameForSounds;

    this.PATH_SOUNDS = Environment.getExternalStorageDirectory() + ‘/LightningLauncher/Sounds’;

    new File(this.PATH_SOUNDS).mkdir();

    // Use one MediaPlayer for several instance of SoundPlayer.

    if (self.mediaPlayer) {

        this.mediaPlayer = self.mediaPlayer;

    }

    else {

        this.mediaPlayer = self.mediaPlayer = new MediaPlayer();

    }

    SoundPlayer.prototype.play = function(name) {

        try {

            if (!name) {

                throw ‘Error(SoundPlayer.play): No sound name entered.’;

            }

            var soundFile = new File(this.PATH_SOUNDS, name);

            if (!soundFile.exists() || soundFile.length() == 0) {

                if (!this.SCRIPT_NAME_FOR_SOUNDS) {

                    return; // No script for sounds and no file in folder, just exit.

                }

                var scriptSounds = LL.getScriptByName(this.SCRIPT_NAME_FOR_SOUNDS);

                if (!scriptSounds) { throw ‘Error(SoundPlayer.play): No ‘ + this.SCRIPT_NAME_FOR_SOUNDS + ‘ script’; }            

                var sounds = eval(scriptSounds.getText());

                if (!sounds[name]) { throw ‘Error(SoundPlayer.play): No ‘ + name + ‘ in ‘ + this.SCRIPT_NAME_FOR_SOUNDS + ‘ script’; }

                var fos = new FileOutputStream(soundFile);

                fos.write(Base64.decode(sounds[name], Base64.DEFAULT));

                fos.close();            

            }

            var mp = this.mediaPlayer;

            mp.reset();

            mp.setDataSource(new FileInputStream(soundFile).getFD());

            mp.prepare();

            mp.start();    

        }

        catch(e) {

            // for debug. normally ignore all errors/exceptions silently.

            // Android.makeNewToast(e, true).show();

        }        

    }

}

========================================================

2. How to play local sound file (for normal end users)

– Place any sound files under ~LightningLauncher/Sounds folder.

In your script,

var player = new SoundPlayer();

player.play(‘click1.mp3’);  // plays ~LL…/Sounds/click1.mp3

========================================================

3. How to play scripted sound file (for developers who want to distribute their own sound clips or open-sourced ones within scripts)

– Prepare sound clip.

– Encode it to MP3, or OGG for a small size. I use http://media.io site.

– Encode MP3/OGG.. to base64 form I use http://base64-encoding.online-domain-tools.com

– Create and fill it with

// my_sounds_script_name

(function() {

  return {

    SOUND_NAME : ‘BASE64 String…’,

    ‘click2.mp3’ : ‘ZFSAACSD … =’,

    ‘click3.ogg’ : ‘DSDSW.ds … =’

  };

})();

You can embed as many as BASE64’ed sound clip in script.

—

In your script using sounds,

var player = new SoundPlayer(SOUND_SCRIPT_NAME);

player.play(SOUND_NAME); 

ie.

var player = new SoundPlayer(‘my_sounds_script_name’);

player.play(‘click1.mp3’); 

player.play(‘click3.ogg’);

// If ~LL…/Sounds/click1.mp3 exists, then play that file.

// If not, it creates ‘click1.mp3’ file using ‘s data, and then play that.

If you’ are to use sounds in several scripts, you had better cache SoundPlayer object, for example:

if (!self.mySoundPlayer) {

  self.mySoundPlayer = new SoundPlayer(‘my_sound_script’);

}

self.mySoundPlayer.play(‘click.mp3’);

========================================================

Using this method, you can use sound effects and distribute them only using LL’s script feature.