18 JSR 135: Mobile Media API Support

18.1.1 Media Capture

The Java ME SDK emulator supports audio and video capture. Audio capture is supported using the capture capabilities of the system upon which the emulator runs.

Video capture is supported by simulating a camera input.

Consult the MobileMediaAPI example application for details and source code that demonstrates how to capture audio and video.

18.3.1 Download Ring Tones

Ring tone files can be downloaded from many internet sites, including the following:

• http://www.convertyourtone.com/

• http://www.phonezoo.com

18.3.2 Ring Tone Formats

This section provides samples of several formats

• RTTTL, the Ringing Tones text transfer language format, is explained at

  http://www.convertyourtone.com/rtttl.html

• Nokia Composer

  This is a rendition of Beethoven's 9th symphony in Nokia Composer format:

  16g1,16g1,16g1,4#d1,16f1,16f1,16f1,4d1,16g1,16g1,16g1,16#d1,

  16#g1,16#g1,16#g1,16g1,16#d2,16#d2,16#d2,4c2,16g1,16g1,16g1,

  16d1,16#g1,16#g1,16#g1, 16g1,16f2,16f2,16f2,4d2

• Ericsson Composer

  Beethoven's Minuet in G:

  a b + c b + c b + c b + C p + d a B p + c g A

  p f g a g a g a g A p b f G p a e F

  Beethoven's 9th symphony theme:

  f f f # C # d # d # d C p f f f # c # f #f # f f +# c + # c + # c # A ff f c # f # f # f f + # d + # d + # d

• Siemens Composer Format

  Inspector Gadget theme:

  C2(1/8) D2(1/16) Dis2(1/8) F2(1/16) G2(1/8)

  P(1/16) Dis2(1/8) P(1/16) Fis2(1/8) P(1/16)

  D2(1/8) P(1/16) F2(1/8) P(1/16) Dis2(1/8)

  P(1/16) C2(1/8) D2(1/16) Dis2(1/8) F2(1/16)

  G2(1/8) P(1/16) C3(1/8) P(1/16) B2(1/2) P(1/4)

  C2(1/8) D2(1/16) Dis2(1/8) F2(1/16) G2(1/8) P(1/16)

  Dis2(1/8) P(1/16) Fis2(1/8) P(1/16) D2(1/8) P(1/16)

  F2(1/8) P(1/16) Dis2(1/8) P(1/16) C3(1/8) B2(1/16)

  Ais2(1/8) A2(1/16) Gis2(1/2) G2(1/8) P(1/16) C3(1/2)

• Motorola Composer

  Beethoven's 9th symphony:

  4 F2 F2 F2 C#4 D#2 D#2 D#2 C4 R2 F2 F2 F2 C#2 F#2 F#2

  F#2 F2 C#+2 C#+2 C#+2 A#4 F2 F2 F2 C2 F#2 F#2 F#2 F2

  D#+2 D#+2 D#+2

• Panasonic Composer

  Beethoven's 9th symphony:

  444** 444** 444** 1111* 4444** 4444** 4444** 111*

  0** 444** 444** 444** 1111** 4444** 4444** 4444**

  444** 11** 11** 11** 6666* 444** 444** 444** 111**

  4444** 4444** 4444** 444** 22** 22** 22**

• Sony Composer

  Beethoven's 9th symphony:

  444****444****444****111#*****444#****444#****444#****

  111*****(JD)0000444****444****444****111#****444#****

  444#****444#****444****11#****11#****11#****666#*****

  444****444****444****111****444#****444#****

  444#****444****22#****22#****22#****

18.5.1 Simple Tones

Simple Tones demonstrates how to use interactive synthetic tones. Select a sample, then click Play on the lower right.

• Short Single Tone and Long Single Tone use Manager.playTone() to play tones with different pitch.

• Short MIDI event plays a chord on the interactive MIDI device (locator "device://midi"). The shortMidiEvent() method of MIDIControl is used to trigger the notes of the chord.

• To run the MMAPI Drummer demo, click or type number keys (0-9). Each number plays a different sound.

18.5.2 Simple Player

The Simple Player application demonstrates the range of audio and video capabilities of the emulator. It includes sample files in a variety of formats and can play files from the emulator's persistent storage or from HTTP URLs.

The player portion uses a generic javax.microedition.media.Player interface. The player displays duration, media time, and controls for running the media file. If metadata is available in a file, the player enables you to view the information, such as author and title. In the case of MIDI files, if karaoke text is present in the file, it displays on the screen during play. Graphical user interface controls can be viewed on the display screen if applicable. You can access these controls by selecting one of the media samples in Simple Player, then pressing the Menu button to view and select the desired command.

Select Simple Player then click Launch. The demo includes the following media samples:

• Bong plays a short WAV file. You can adjust certain playback features, as described later in this document. The display shows the duration of the sound in minutes:seconds:tenths of a second, for example 00:17:5. This audio sample is a resource file in the MIDlet suite JAR file.

• MIDI Scale plays a sample musical scale. The display shows the title of the selected music file, the duration of the song, the elapsed time during playback, and the current tempo in beats per minute (bpm). This MIDI file is stored in the MIDlet suite JAR file.

• Simple Ring Tone plays a short sequence of Beethoven's Fifth Symphony. The display shows the title of the selected music file, the duration of the song, the elapsed time in seconds and tenths of a second during playback, and the current tempo in beats per minute (bpm). This ringtone file (.jts format) is stored in the MIDlet suite JAR file.

• WAV Music plays a brief audio file. The display shows the title of the audio file, the duration of the audio the elapsed time during playback, and the playback rate in percent. This WAV file is retrieved from an HTTP server.

• MIDI Scale plays a MIDI file that is retrieved from an HTTP server.

• The Animated GIF example shows an animated GIF that counts from 1 to 5. The file is stored in the MIDlet suite JAR file.

• Audio Capture from a default device lets you capture audio from a microphone or connected device. The sound is captured and played back on the speaker. To avoid feedback, use a headset.

• Video Capture Simulation simulates viewing input video such as might be possible on a device equipped with a camera.

• MPEG1 Video [http]. Plays an MPEG video found at http://java.sun.com/products/java-media/mma/media/test-mpeg.mpg.

• [enter URL] allows you to play back media files from arbitrary HTTP servers. Type a valid URL at the insertion point and click OK to play a file. If you want to open an HTTP directory from which to select media, be sure to add a slash to the end of the URL.

In addition, Simple Player parses ring tones in Ringing Tones text transfer language (RTTTL). See http://www.convertyourtone.com/rtttl.html for information on RTTTL.

The Simple Player includes a common set of commands that control media playback. The commands are available from the Simple Player menu, and some have associated keypad buttons. Table 18-1 describes these commands, their availability, and their keypad equivalents. The commands may or may not be available depending on the media type that Simple Player is playing.

Note that a short list of commands and the corresponding keypad buttons is available in the Simple Player application itself. Just choose the Quick Help command from the menu.