Vibe and Backlight API | Motorola C370, C550, C450 specification

9 Vibe and Backlight

Vibe and Backlight API

The Vibe and Backlight API allows J2ME applications access to vibrator, backlight, and keypad control. This access gives a MIDlet the ability to turn on/off these features based on the application’s needs. The MIDlet will use the Vibe and Backlight API to enhance the activity being performed by the application. Examples of these enhancements are the following:

•When in a driving game application, the vibrator is turned on during a crash scenario.

•An alarm clock application will have access to turn the vibrator on and off.

•A stock ticker application turns the backlight on/off when a specified stock hits a target price.

In future releases of the Vibe and Backlight API, keypad and backlight control must function separately. Currently, these functions are dependant on the hardware implementation and which additional drivers are needed to control the keypad and lights separately from the display’s backlight.

Native constraints must be in place to protect the battery life of the product. A time-out feature will be created to limit the duration of the vibrator and backlight features. This time-out will protect against a corrupt MIDlet or unattended MIDlet. These native constraints will be flexible to the operator.

Image 62

Motorola C370, C550, C450 technical manual Vibe and Backlight API

Contents

Technical Manual Table of Contents Lcdui JAD Attributes Audience IntroductionPurpose Disclaimer References Date Name Reason Revision HistoryDefinitions, Abbreviations, Acronyms Acronym Description Document Overview Introduction J2ME Introduction Java 2 Platform, Micro Edition J2ME Motorola J2ME Platform Resources Available File & RMS Description DisplayNetworking Java VM Introduction to Development Developing and Packaging J2ME ApplicationsGuide to Development in J2ME Page Downloading Applications OTA ProcedureInstallation Program and Data space notes Exiting Applications Java Application Installer/De-Installer JaidStarting Applications Downloading MIDlets Error ChecksLaunching Web Session for Http Download XML Screen Renderings BombMan is back, now on your Taichi series of handsets Taichi handset New Games Application Management MIDlet Lifecycle MIDlet Suite Installation MIDlet Suite De-installation MIDlet Suite Updating DestroyApp Method Caller Purpose StartApp or the pauseApp Using startApp Java System MIDlet Control of MIDlet State TransitionsPage Network API Network Connections Class Descriptions IOException when it detects a time-out condition URL Format Implementation Notes TCP SocketsUDP Sockets Network API Lcdui Description Lcdui Class Hierarchy Gaming API and SoundFunctional Description BackgroundMusic Methods Using BackgroundMusicBackgroundMusic Class Gaming API containing a sound API GameScreen Class GameScreen Fields GameScreen Methods Public int getKeyStates Information, disabling key events can improve performance Using GameScreen GameScreen ImageUtil Methods ImageUtil ClassImageUtil Fields Using ImageUtil RgbData PalleteImage Methods PalleteImage ClassPalleteImage Constructor Using PalleteImage Public void setTransparentIndexint index throws Using Static and Animated Tiles PlayField Class PlayField Constructor Using SpritesDefining View Windows 2N+1 2N + PlayField Methods Public void addSpriteSprite s throwsPage Public boolean collidesWithAnyTileSprite s throws Using PlayField PlayField Sprite Class Using SoundEffectSoundEffect Class SoundEffect Methods Sprite Constructor Animation FramesSprite Drawing Sprite Methods Page Public final void drawGraphics g throws Sprites Using SpriteFileFormatNotSupportedException FileFormatNotSupportedException Constructors Java Gaming Sound APIMax Midi Extension Support Java Gaming Sound API Vibe and Backlight Vibe and Backlight API Overview Creating a Message Sending a Message Permissions JAD Attributes JAD Attributes Mandatory attributes for manifest files MIDlet-Name Code Examples Record Management SystemClass Description RecordStore Tips Caveats Phonebook Access Phonebook Access API Phonebook Access API Permissions Sample of code to create object of PhoneBookRecord class Simmemory Sample of code for calling of ‘getMaxEmailLength ’ method Sample of code for calling of ‘isPrimaryint speedNo’ method Sample of code for calling of ‘getNumberCategories’ method Sample of code for calling of ‘setCategoryView’ method Sample of code for calling of ‘getUsedRecords’ method Int index = ReceivedRecord.getRecord1 ITAP Intelligent Keypad Text Entry API Appendix a Key Mapping Key Mapping for the C370, C450, and C550 Center Select END Appendix B Memory Management Calculation Available Memory Online FAQ Appendix C Appendix D Spec Sheets C370, C450, and C550 Spec Sheets References Purchase Motorola Developer Information ToolsDocumentation Motorola Developer Information Tools Motorola, Inc