JavaScript Contacts Service API

The Contacts Service API is supported since WRT 1.1.

The Contacts Service API allows widgets to access and manage information about contacts. This information can reside in one or more contacts databases stored on a device or in the SIM card database. The API is integrated into WRT through the device object.

For an overview of the service and the API, see section Accessing and managing information about contacts.

Using the Contacts Service API

To use the Contacts Service API, your widget must first create a service object for it using the device.getServiceObject() method. Use Service.Contact to identify the service provider and IDataSource to identify the supported interface:

var so = device.getServiceObject("Service.Contact", "IDataSource");

This service object can then be used to access the services provided by the API:

Emulator support

The S60 5th Edition SDK emulator provides full support for the Contacts Service API. However, SIM-specific operations can only be run on a device.