Using MediaControlSkin, Media Capture | Sun Microsystems J2ME

8.2Using MediaControlSkin

The J2ME Wireless Toolkit comes with an emulator skin, MediaControlSkin, that is focused on multimedia playback and control. The skin includes buttons with symbols representing play, stop, volume up and volume down, and other commands. To see the usefulness of MediaControlSkin, try it out with the mmademo demonstration application.

8.3Media Capture

The J2ME Wireless Toolkit emulator supports audio and video capture. Audio capture is supported by using the capture capabilities of the system upon which the emulator runs.

Video capture is supported by simulating a camera input.

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

8.4Well-Behaved MIDlets

MIDlets have a life cycle that is defined in the MIDP specification. MIDlets can be paused by events such as incoming phone calls. A well-behaved MIDlet releases important device resources when it is paused and reallocates or restarts those resources when the MIDlet is resumed. In the MMAPI arena, any Players that are rendering content should be stopped when a MIDlet is paused.

The J2ME Wireless Toolkit will print a message to the console if you pause a MIDlet and it does not stop its running Players. You can test this feature yourself using the PausingVideoTest MIDlet in the mmademo demonstration application. See Appendix for details.

The warning message is printed once only for each running emulator.

66 J2ME Wireless Toolkit User’s Guide • October 2004

Image 78

Sun Microsystems J2ME manual Using MediaControlSkin, Media Capture, Well-Behaved MIDlets

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