The following article shows how a simple mp3 file in your jar application can be played using the mmapi classes (included in the JSR-135 optional package or in all the MIDP 2.0 devices which include a subset of mmapi).

Suppose the file is sound.mp3. You can create a class implementing this method:

    public void playSound(final String soundFile, final Display display) {  
        try {
            InputStream is =
                getClass().getResourceAsStream( "/sound.mp3" );
           
            Player player = Manager.createPlayer( is, "audio/mpeg" );
            player.addPlayerListener( this );
            player.realize();
            player.prefetch( );
            player.start();
        }
        catch ( Exception e ) {        
            e.printStackTrace();
           
            if ( player != null ) {
                player.close();
                player = null;
            }
        }
    }

In the method we have added a PlayerListener (player.addPlayerListener( this )) so we suppose the class implementing the playSound method implements the following PlayerListener interface playerUpdate ( Player player, String event, Object arg2 ) method:

public void playerUpdate ( Player player, String event, Object arg2 ) {
        if ( event.equals( STOPPED ) || event.equals( ERROR ) || event.equals( END_OF_MEDIA ) ||  event.equals( DEVICE_UNAVAILABLE ) || event.equals( CLOSED ) ) {
            player.deallocate();
            player.close();
            player = null;
        }
    } 

This method frees resources when the player ends the sound playback or an unexpected error occurs. The same method can be used to play sound from network or using the FileConnection API (in those case the URL of the file changes).

If you want to set the volume in the MediaPlayer using the following code:

                InputStream is = getClass().getResourceAsStream( "/sound.amr" );
                Player player = Manager.createPlayer(is, soundType);
                player.addPlayerListener( this );
                player.realize();
                VolumeControl volumeControl =
                (VolumeControl) player .getControl( "VolumeControl" );
                if ( volumeControl != null ) {
                    volumeControl.setLevel( volume );
                }

when you launch the player with:

                player.start();

no sound can be heard on the LG KE970 Shine without getting any error.

This device requires to get the prefetched status if you want to set the volume and play the sound correctly. The working code is then:


                InputStream is = getClass().getResourceAsStream( "/sound.amr" );
                Player player = Manager.createPlayer(is, soundType);
                player.addPlayerListener( this );
                player.realize();
                player.prefetch( );
                VolumeControl volumeControl =
                (VolumeControl) player .getControl( "VolumeControl" );
                if ( volumeControl != null ) {
                    volumeControl.setLevel( volume );
                }

Maybe other phones are affected as well (especially LG). Post comment if you other phones with the same problem.

the ByteArrayOutputStream output has size equals to 0.

This is a known bug according with the Sony Ericsson Developer website says:

http://developer.sonyericsson.com/entry.jspa?externalID=705&categoryID=6

in K610 and K800 but it seems the same in the W850 (and maybe in other phones also).

Furthermore, the previous link gives a workaround to save the stream in a file but it doesn't say anything about saving the audio in a byte array stream.

If anyone else has other phone where he experienced the same problem, please post a comment!

The method setDisplaySize() for VideoControl doesn't work properly for S60 3rd edition.
The implementation doesn't user the parameters passed but uses always the max allowed size mantaining the aspect ratio.

Here is the link to the Nokia Technical Library about the bug:

Go to Technical Library