View source

[[Category:Java ME]][[Category:How To]][[Category:Code_Examples]][[Category:Multimedia]]
[[Category:Audio]]

'''MMAPI (JSR 135)''' allows Java ME applications to easily access '''MultiMedia functionalities''', like '''playing and recording both video and audio data'''. This article shows the '''steps required to play a sound''', from both local and network resources.

==Source code==
You need to import the following packages:
<code java>
import java.io.*;
import javax.microedition.media.*;
</code>

The following code helps to play sound which is embedded in your jar file

<code java>
InputStream is = getClass().getResourceAsStream("sound.wav");
Player p = Manager.createPlayer(is, "audio/X-wav"); 
p.start();
</code>

The following code helps to play sound which is stored in a web server
<code java>
Player p = Manager.createPlayer("http://server/sound.wav"); 
p.start();
</code>

You may also try other sound formats by minor changing ie; by changing the mime type.

Also you have to keep in mind while giving the url in the second case, use of special characters like '&' etc are not supported. In such case you should follow the following method
<code java>
HttpConnection hc = (HttpConnection) Connector.open(url);
InputStream in = hc.openInputStream();
Player p = Manager.createPlayer(is, "audio/X-wav"); 
p.start();
</code>

===Notes===
* When playing a multimedia file, you should always check if the used format is supported by the target device. To do this, you should use the [http://library.forum.nokia.com/index.jsp?topic=/Java_Developers_Library/GUID-8F9BE454-FC5E-4B87-B805-765DEFA66C99/javax/microedition/media/Manager.html Manager] getSupportedContentTypes()
* Also, you should always check which protocols are supported, by using Manager getSupportedProtocols() method

==Related resources==
* [http://library.forum.nokia.com/index.jsp?topic=/Java_Developers_Library/GUID-5D55EA03-888E-437A-9498-82F606097B48_GUID-875A4B88-C784-4270-90DF-610C7B9ADA2F.html MultiMedia section on Java Me Developer's Library]
* [[MMAPI]] Wiki article