Application and BlackBerry device integration



additional PIM list support

The following PIM list features are now available:

  • You can access a PIM list by its UID by invoking BlackBerryPIM.openPIMList() in the net.rim.blackberry.api.pdap package. You might want to reference a PIM list by its UID instead of its name because a UID does not change.
  • You can access multiple contact lists on the BlackBerry® device by using the PIM class in the javax.microedition.pim package.
  • You can work with wireless synchronization and the size of a contact list by using new methods available in the BlackBerryPIMList class.

advanced multimedia supplements

The Advanced Multimedia Supplements of JSR 234 for just the camera and video enhancements are now supported and accessed through javax.microedition.amms. The Advanced Multimedia Supplements add many new controls for advanced camera and video features.

automatic download of email attachments

You can manage attachments to incoming and outgoing email messages on a BlackBerry device by using the APIs in the net.rim.blackberry.api.mail package. For example, when messages are received on the BlackBerry device, you can automatically download attachments to email messages in the background.

BlackBerry extension to JSR 179

You can access location information about a BlackBerry device by using the BlackBerry extension to JSR 179 that is available in the net.rim.device.api.gps package. You can use the BlackBerry extension to JSR 179 on BlackBerry devices that run BlackBerry® Device Software version 5.0 or later.

The JSR179 Extension provides the following extensions to JSR179:

  • BlackBerryCriteria class
  • BlackBerryLocation class
  • BlackBerryLocationProvider class

The BlackBerryCriteria class extends the Criteria class and permits you to specify the following information:

  • initial GPS mode
  • failover GPS mode, if applicable
  • GPS mode to use after your application obtains a GPS fix
  • specify whether GPS satellite information before and after a GPS is required

The BlackBerryLocation class extends the Location class and permits you to retrieve the following information:

  • GPS satellite information (for example, the number of GPS satellites, the average signal quality, and details about the GPS satellites)
  • data source that obtains the GPS fix
  • GPS mode that provides the GPS location information
  • Get the GPS failure reason, if any

The BlackBerryLocationProvider class extends the LocationProvider class and permits you to perform the following actions:

  • process a GPS location request from a BlackBerryCriteria object
  • pause and resume a location listener
  • retrieve the GPS provider type (for example, an internal GPS receiver or a Bluetooth® enabled GPS receiver)
  • get GPS feedback (other than a GPS fix). Feedback includes satellite information before a GPS fix, indication that a failover mode has occurred and also indication when the implementation is using a different GPS mode after the first mode has successfully produced a fix.

For more information about the BlackBerry extension to JSR 179, visit to read the BlackBerry Java Application Location-Based Services Development Guide.

biometric recognition and authentication

You can store, manage, and retrieve fingerprint and biometric information on a BlackBerry device by using the Biometric API available in the net.rim.device.api.biometrics package and methods available in the SmartCard and SmartCardSession classes. For example, you can extract fingerprint information from a smart card to match against a scanned fingerprint.

enhanced media key events

You can have your application listen for events that are triggered when media keys are pressed by using the MediaActionHandler class in the package. You can use the MediaKeyListener class to receive all key events when the application is in the foreground, and receive unhandled global keys when the application is in the background. For example, you can allow a user to control media playback using certain keys while another application is in the foreground.

You can assign media key events to keys on a BlackBerry device for actions such as increasing the volume, decreasing the volume, and moving forward and back through audio and video files by using the Keypad class in the net.rim.device.api.ui package.

landmark information retrieval using geocoding and reverse geocoding

You can retrieve landmark information by invoking Locator.geocode() and Locator.reverseGeocode() in the net.rim.device.api.lbs package. For example, you can search for known landmark information by using a street address, city, or postal code. You can use reverse geocoding to find an approximate address based on latitudinal and longitudinal coordinates.

linking contacts

You can link a contact in your application with a contact in the contacts application on the BlackBerry device by using the classes and interfaces in the net.rim.blackberry.api.pdap.contactlinking package. For example, you can allow users to link a contact in your CRM application with a contact in the contacts application on the BlackBerry device.

MEID retrieval

You can retrieve the MEID number for BlackBerry devices that operate on a CDMA network using the CDMAInfo.getHexMEID() and CDMAInfo.getDecimalMEID() methods available in the net.rim.device.api.system. package.

multi-line phone support

You can create an application that interacts with the phone lines available (for example, a cellular line and a work line) on a BlackBerry device by using the Phone and MultiLineListener classes in the package. For example, you can create an application that determines the types of phone lines available on a BlackBerry device and starts outgoing calls using a specific phone line.

The new Multi-line API provides the following features:

  • retrieve the phone numbers and labels, IDs, and WAFs of available lines
  • determine whether a phone line is a cellular line or a work line
  • invoke the phone application using a source line and destination number

multiple contact list support

You can now access individual contact lists available on a BlackBerry device by using the PIM class in the javax.microedition.pim package.

phone screen content

You can listen for incoming or outgoing calls and display information about incoming and outgoing calls on the phone screen by using the PhoneScreen class in the package. For example, when a contact on a BlackBerry device calls a user, you can display specific information about the contact on the phone screen on the BlackBerry device.

Further enhancements have been made to the and classes.

random file access

You can read data from and write data to a file at any location within the file using the Random File Access API. A new Seekable interface is provided in the package.

support for reading contact names in Japanese

You can now access the Japanese reading of the NAME_GIVEN and NAME_FAMILY elements of the NAME and ORG fields by using the net.rim.blackberry.api.pdap.BlackBerryContact interface. You can access this information by using the NAME_GIVEN_YOMI and NAME_FAMILY_YOMI indices of the NAMEString array field's value, and the new ORG_YOMI field.

touch event injection

On BlackBerry devices with touch screens, you can inject touch events, such as swipes and taps, by using the EventInjector.TouchEvent class. For example, you can use touch event injection to automate the testing of your application or provide a way for peripherals to interact with a BlackBerry device.

user authentication modules

You can create a module that you can use to authenticate users by using the net.rim.device.api.userauthenticator package. For example, you can create a module that authenticates a user to the BlackBerry device by using a smart card or biometric reader.

video capture and play

You can embed a viewfinder, record video clips, and play captured video by using JSR 135. When your BlackBerry device application records to a file, the Player records in 3GP format. When your application records to an OutputStream, the Player records in a proprietary streaming video format.

You can retrieve and control a video viewfinder, and record the video shown in the viewfinder by using the VideoControl and RecordControl controls. The Player records to a file specified by a file locator or to an OutputStream. A new Player must be created to display the recorded video.

SQLite® support

BlackBerry devices that run BlackBerry Device Software version 5.0 or later have the SQLite library integrated into the operating system and virtual machine. You can develop applications that use the integrated SQLite database using the SQLite API. You can use the SQLite API to store application data. Like the Persistent Store API or the MIDP RMS API, the SQLite API enables you to store data persistently to an eMMC or a microSD card. The SQLite API provides the option to store data in an encrypted format using the same mechanisms as the Persistent Store APIs.

Was this information helpful? Send us your comments.