Using the Mobile Media API | Sun Microsystems J2ME specification

CHAPTER 8

Using the Mobile Media API

The Mobile Media API (MMAPI) provides a standard API for rendering and capturing time-based media, like audio or video. The API was designed to be flexible with respect to the media formats, protocols, and features supported by various devices.

8.1Supported Formats and Protocols

The emulator’s MMAPI implementation supports the following media types:

TABLE 6 Supported MMAPI media formats

MIME Type	Description

audio/midi	MIDI files
audio/sp-midi	Scalable Polyphony MIDI
audio/x-tone-seq	MIDP 2.0 tone sequence
audio/x-wav	WAV PCM sampled audio
image/gif	GIF 89a (animated GIF)
video/mpeg	MPEG video
video/vnd.sun.rgb565	Video capture

65

Image 77

Sun Microsystems J2ME manual Using the Mobile Media API, Supported Formats and Protocols, Supported Mmapi media formats

Contents

User’s Guide Please Recycle Contents Using the Emulator Security and MIDlet Signing Using the PIM and FileConnection APIs Command Line Reference 103 Index Related Documentation PrefaceWho Should Use This Book How This Book Is Organized Preface We Welcome Your Comments Accessing Documentation OnlineTypographic Conventions Quick Start Introduction KToolbar window Tools in the Toolkit Supported Technology Toolkit FeaturesSupported JCP APIs in the J2ME Wireless Toolkit Mmapi About Projects Developing MIDlet Suites Creating a new project Edit Source Code Simple Development Cycle Build Messages about building 3 Run List of project MIDlets Package Full Development Cycle Emulator AMS welcome screen Install URL prompt Application menu, again Launching the installed application Using an Obfuscator Obfuscate.script.name scriptfile Deploying Applications on a Web Server Using a Debugger From the command line, run Selecting APIs Working With Projects Project settings window Changing MIDlet Suite Attributes Editing MIDlet suite attributes List of MIDlets in a project Manipulating MIDlets Project push registry settings Using the Push Registry Project directory structure Using Third-Party LibrariesProject Directory Structure Third-Party Libraries for All Projects Configuring KToolbarThird-Party Libraries for One Project Working with Revision Control Systems Setting the Application DirectorySetting the javac Encoding Property 28 J2ME Wireless Toolkit User’s Guide October Emulator skins Using the EmulatorEmulator Skins Using the Emulator DefaultColorPhone emulator skin Keyboard shortcuts Setting Emulator PreferencesNetwork Proxies Heap Size Storage and Cleaning Choose Edit Preferences... and click on the Performance tab Adjusting Emulator Performance Adjusting the emulator’s performance Pausing and Resuming Running the Emulator Solo Using Third Party Emulators Emulators 38 J2ME Wireless Toolkit User’s Guide October Monitoring Applications Using the Profiler Turning on the profiler Execution Time and Number of Calls Call Graph Saving and Loading Profiler Information Using the Memory Monitor You’ll see a table with the following columns Saving and Loading Memory Monitor Information Using the Network Monitor Network monitor Filtering Messages Saving and Loading Network Monitor Information Network monitor filter settingsSorting Messages Clearing the Message Tree 48 J2ME Wireless Toolkit User’s Guide October Permissions Security and MIDlet Signing MIDlet suite permissions Protection Domains Signing a MIDlet Suite Creating a New Key Pair Managing Keys Creating a new key pair Getting Real Keys Removing a Key Pair Managing CertificatesImporting an Existing Key Pair Certificate manager Importing Certificates Removing Certificates Setting Emulator Phone Numbers Using the Wireless Messaging API Simulating an Unreliable Network Setting WMA preferences Sending a Text SMS Message Sending Messages With the WMA Console Sending a text message Sending a Binary SMS Message Sending a binary message Sending Text or Binary CBS Messages Sending CBS messages Sending MMS Messages Adding recipients for an MMS message Receiving Messages in the WMA Console Using the Network Monitor with WMA Supported Mmapi media formats Using the Mobile Media APISupported Formats and Protocols Well-Behaved MIDlets Using MediaControlSkinMedia Capture JSR 184 Overview Immediate ModeWorking With Mobile 3D Graphics Trading Quality for Speed Retained Mode Creating Mobile 3D Graphics Content 70 J2ME Wireless Toolkit User’s Guide October FileConnection API Using the PIM and FileConnection APIs Managing filesystem roots PIM API Obex Over Infrared Using the Bluetooth and Obex APIsBluetooth Simulation Environment Obex Preferences Setting Obex and Bluetooth Preferences Bluetooth System Properties Bluetooth Discovery TimeoutBluetooth BCC Properties BCC properties 76 J2ME Wireless Toolkit User’s Guide October Web services stub generator Using Web Services 78 J2ME Wireless Toolkit User’s Guide October Overview Application Demonstrations Application demonstrations \WTK22\apps\WMADemo\src\example\sms\SMSSend.java KToolbar General Instructions Opening a demonstration application project BluetoothDemo Running the Bluetooth Demo server Life3D Demo3D Controls for Life3D PogoRoo Bouncing kangaroo Retainedmode Mmademo JSR172Demo Simple Player Simple Tones Player commands Video PausingAudioTest Descriptions of MMAPI-specific MIDlet attributes ObexDemoAttributes for mmademo Waiting for an Obex connection Prompting to accept a connection Browsing Files PDAPDemo Contents of the root1 directory Choosing a list type PIM API To actually save the list item, choose Commit from the menu Saving an item WMADemo Sending a text message Push registry springs to life Addressing an MMS message WMADemo receives the image Development Cycle Command Line ReferencePrerequisites Preverify options files directories Jar cfm MyApp.jar MANIFEST.MF -C classes . -C res Run=storagename storagenumber Remove=storagename storagenumber all Debugging Emulator Preferences Properties List Toolkit component commandsLaunching Toolkit GUI Components Monitor Enable memory monitor Changing the Emulator’s Default Protection Domain Using Security Features Signing MIDlet Suites Managing Certificates Options Using the Stub GeneratorOptions for the wscompile Command Example Command Supported Features -f for wscompile Internationalization Locale Setting Character Encodings Emulated Locale Java Compiler Encoding Setting Font Support in the Default Emulator 118 J2ME Wireless Toolkit User’s Guide October Index Ktools.properties, 27 ktools.properties ﬁle Index 122 J2ME Wireless Toolkit User’s Guide October