Here's a quick tutorial to using the gwt-voices module in your own application.

While the Eclipse IDE is not strictly necessary, having a good IDE such as Eclispe will make your life a lot easier. Certainly feel free to use your IDE of choice.

GWT Compatibility

If you can, please switch to the latest GWT version and gwt-voices version.

Adding the gwt-voices Module to your Eclipse Project

1. Download the latest gwt-voices-<version>.jar and place it in a convenient location.
2. Create a GWT Eclipse project as instructed here: http://code.google.com/webtoolkit/gettingstarted.html#NewEclipse

mkdir MyProject
cd MyProject
projectCreator -eclipse MyProject
applicationCreator -eclipse MyProject com.mycompany.client.MyApplication

3. Import your new project via 'File > Import > Existing Project into Workspace'. Specify the MyProject directory you created in a previous step.
4. To allow the GWT command line scripts to continue to work, modify the -cp parameter value in both MyApplication-shell.cmd and MyApplication-compile.cmd to include the path to gwt-voices-<version>.jar. You can add it just before the path to gwt-user.jar. Don't forget the path separator ';' or ':', depending on your platform.
5. Right-click on the project node in the Package Explorer and select 'Build Path > Add External Archives...'. Select gwt-voices-<version>.jar.
6. Make sure GWT can find the gwt-voices module at runtime. Modify MyProject/src/com/mycompany/MyApplication.gwt.xml to include these lines:

	<!-- Inherit sound support                           -->
	<inherits name='com.allen_sauer.gwt.voices.gwt-voices'/>

A Quick Example

package com.mycompany.client;

import com.google.gwt.core.client.EntryPoint;

import com.allen_sauer.gwt.voices.client.Sound;
import com.allen_sauer.gwt.voices.client.SoundController;

public class SimpleApplication implements EntryPoint {
  public void onModuleLoad() {
    SoundController soundController = new SoundController();
    Sound sound = soundController.createSound(Sound.MIME_TYPE_AUDIO_MPEG,
        "url/to/your/sound/file.mp3");

    sound.play();
  }
}

A More Elaborate Example

package com.mycompany.client;

import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.core.client.GWT;
import com.google.gwt.user.client.Command;
import com.google.gwt.user.client.DeferredCommand;
import com.google.gwt.user.client.Window;
import com.google.gwt.user.client.ui.Button;
import com.google.gwt.user.client.ui.ClickListener;
import com.google.gwt.user.client.ui.HTML;
import com.google.gwt.user.client.ui.RootPanel;
import com.google.gwt.user.client.ui.Widget;

import com.allen_sauer.gwt.voices.client.Sound;
import com.allen_sauer.gwt.voices.client.SoundController;
import com.allen_sauer.gwt.voices.client.handler.PlaybackCompleteEvent;
import com.allen_sauer.gwt.voices.client.handler.SoundHandler;
import com.allen_sauer.gwt.voices.client.handler.SoundLoadStateChangeEvent;

public class MyApplication implements EntryPoint {
  public void onModuleLoad() {
    // set uncaught exception handler
    GWT.setUncaughtExceptionHandler(new GWT.UncaughtExceptionHandler() {
      public void onUncaughtException(Throwable e) {
        Window.alert("Uncaught exception:\n" + e);
      }
    });

    // use deferred command to catch initialization exceptions
    DeferredCommand.addCommand(new Command() {
      public void execute() {
        onModuleLoad2();
      }
    });
  }

  public void onModuleLoad2() {
    // create a (disabled) play button
    final Button playButton = new Button("click to play");

    // create a place holder for the load state
    final HTML loadStateHTML = new HTML();

    // create sound controller
    SoundController soundController = new SoundController();

    // create a sound
    final Sound sound = soundController.createSound(Sound.MIME_TYPE_AUDIO_MPEG,
        "url/to/your/sound/file.mp3");

    // add a sound handler so we know when the sound has loaded
    sound.addEventHandler(new SoundHandler() {
      public void onPlaybackComplete(PlaybackCompleteEvent event) {
      }

      public void onSoundLoadStateChange(SoundLoadStateChangeEvent event) {
        loadStateHTML.setHTML("Load state: " + event.getLoadStateAsString());
      }
    });

    // when we click, play the sound
    playButton.addClickListener(new ClickListener() {
      public void onClick(Widget sender) {
        sound.play();
      }
    });

    // add the button
    RootPanel.get().add(playButton);

    // add the load state status
    RootPanel.get().add(loadStateHTML);
  }
}

Tips

1. Make sure you use an UncaughtExceptionHandler so that unexpected exceptions are not lost in web mode

Working Examples

There is a working examples along with the demo source code for you to look at.

There's also the library source code if you want to see what makes it tick.