Overview  Package  Class  Tree  Deprecated  Index  Help 
 PREV   NEXT FRAMES    NO FRAMES    

Nokia UI API

Overview

See:
          Description

Packages
com.nokia.mid.media Nokia-specific com.nokia.mid.media extension classes.
com.nokia.mid.ui  
com.nokia.mid.ui.frameanimator The FrameAnimator API calculates motion interpolation for kinetic scrolling and linear animations.
com.nokia.mid.ui.gestures The Series 40 Touch and Type UI phones support a number of platform defined gestures.
com.nokia.mid.ui.locale Contains classes and interfaces for retrieving locale information stored on the device.
com.nokia.mid.ui.multipointtouch The Series 40 Touch UI phones support MultipointTouch events.
com.nokia.mid.ui.orientation Orientation API

 

Overview

A major use of Java in mobile devices would be entertainment, more specifically games. Games often need low-level access to device HW like keys and display. MIDP was designed to be HW-independent, so there is no support for this kind of low-level access. Here we will define a few MIDP implementation aspects and API extensions that enhance the developer's capability of delivering good games for Nokia devices. Some of these features may also be useful in other application domains. The following features are supported:
  1. Low level access to image pixel data
  2. Transparency support
  3. Full screen drawing
  4. Sound
  5. Vibration and device lights control
  6. Tactile feedback
  7. Getting fonts
  8. Soft notifications
  9. Events from joystick-type navigation mechanism
  10. Audio output (new)
  11. Clipboard (new)
  12. Text editor for Canvas and CustomItem (new)
Currently, Nokia UI API has two packages that contain classes and interfaces for providing the above features: com.nokia.mid.ui and com.nokia.mid.sound.

MIDP 2.0 introduced some features, which before existed only in Nokia UI API. Hence, MIDP APIs should be used instead of Nokia UI APIs if a corresponding feature is available. More specifically those Nokia UI API methods that have deprecation tags should not be used in devices supporting MIDP version 2.0 or higher.

System properties for Nokia UI API version and optional features

The system properties defined in this section MUST be made available to the application using java.lang.System.getProperty.

System property Explanation
com.nokia.mid.ui.version The system property for indicating the version of Nokia UI API. The property value is a string containing dot separated digits, for example 1.2, that indicates the version number of the implemented API version.
com.nokia.mid.ui.softnotification The system property for indicating whether managing soft notifications is supported. The method call java.lang.System.getProperty("com.nokia.mid.ui.softnotification") will return "true" if this feature is available in the device.
com.nokia.mid.ui.customfontsize The system property for indicating whether custom font height setting is supported. Returns "true" if this feature is available in the device.
com.nokia.mid.ui.tactilefeedback The system property for indicating whether tactile feedback is supported. Returns "true" if this feature is available in the device.
com.nokia.mid.ui.screensaverprevention The system property for indicating whether screen saver prevention is supported. Returns "true" if this feature is available in the device.

 Overview  Package  Class  Tree  Deprecated  Index  Help 
 PREV   NEXT FRAMES    NO FRAMES    
Copyright © 2012 Nokia Corporation. All rights reserved.

Nokia is registered trademark of Nokia Corporation. Java and all Java-based marks are trademarks or registered trademarks of Oracle Corporation. Other product and company names mentioned herein may be trademarks or trade names of their respective owners. This document is confidential information of Nokia Corporation.

Disclaimer
The information in this document is provided "as is," with no warranties whatsoever, including any warranty of merchantability, fitness for any particular purpose, or any warranty otherwise arising out of any proposal, specification, or sample. Furthermore, information provided in this document is preliminary, and may be changed substantially prior to final release.

Nokia Corporation disclaims all liability, including liability for infringement of any proprietary rights, relating to this document and implementation of any information presented in this document.

Nokia Corporation retains the right to make changes to this document at any time, without notice.

License
Subject to above disclaimer, a license is hereby granted to use this documentation solely under existing Limited License Agreement and non-disclosure agreement between the companies for the agreed application development for Series 40 Nokia phones. No other licenses e.g. to any intellectual property rights are granted herein. Any use of the screen shots of this documentation, including any icons thereof, is subject to Nokia's prior written approval.