Accessing +device logs

The Logging Service +API allows widgets to access mobile device logging +events such as call logs, messaging logs, and data logs. You can use the Logging +Service to create widgets that add, read, and delete logging +events. For example, you can create widgets that:

Automatically delete the records of received calls older +than a specified number of days
Create unique records of calls based on criteria such as +call duration
Provide useful information to mobile device users such as +the number of MB of data sent and received for the day

Accessing the API and supported methods

To create a service +object for the Logging Service API, use Service.Logging to +identify the service provider and IDataSource to identify +the supported interface:

+ +

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

The IDataSource interface provides the following +methods:

Add()
+ +
Use the Add() method to add an entry to the event +log; for example, to create new types of application-specific log entries.
+ +
GetList()
+ +
Use the GetList() method to retrieve event details +such as phone number or call duration from the event log.
+ +
Delete()
+ +
Use the Delete() method to delete an entry from +the event log.
+ +
RequestNotification()
+ +
Use the RequestNotification() method to request +notification of updates to the event log.
+ +
Cancel()
+ +
Use the Cancel() method to cancel an ongoing asynchronous +call. This method is valid for any asynchronous call made through the Logging +Service API.
+ +

Using the service in a widget

To access and manage logs using the Logging Service API:

Create a service +object for the API using device.getServiceObject().
+
Define the +tasks you want to perform and choose the correct methods for them.
+
Optionally, +define how you want the results filtered.
Define functions +to process the results.
Retrieve the +results.
Process the +results.

For the complete source of a sample widget that demonstrates how to +use this service, see the +full example.