This section provides details on the information that an application can access about basic services. The basic services are phone, network and call information that are accessed by the applications.
The telephony API for application allows client applications to access information about:
The phone information available is:
Device identification
The device identity provides the details about the manufacturer, device model and the serial number. The serial number is the International Mobile Equipment Identity (IMEI) which is a unique 15-digit serial number. The serial number is unique to the device and not the subscriber.
Subscriber identification
A string of up to 15 characters that identifies the subscriber. It is the information of the Subscriber Identity Module (SIM) card on the GSM networks and WCDMA networks or the Removable User Identity Module (R-UIM) on the CDMA networks.
Flight mode status
The phone can be put into a state with the network related operations disabled. This state is known as the flight mode. You cannot make or receive calls when the flight mode is enabled. The client applications cannot access the information about call, line and other supplementary services.
Battery information
The client application can access the battery charge level and the battery status. The three states of a battery are:
Battery charger information
The client application can find out if the charger is connected or not.
Lock information
The phones allow the users to lock them to prevent unauthorised access. A code must be entered to unlock the phone. The client applications can access the lock information. This information does not concern the keypad locks, nor the lock that the networks use to prevent a phone from being used on other networks. A phone can have up to two locks. The client applications must specify the lock to access their information.
The call information available is:
Call-in-progress indicator
The client applications can retrieve information about when a call is in progress and the type of call. The calls can be data, voice or fax calls. The client applications can also get the information about the status of a call.
Fax line status
Status information is available for the fax line and the different states include:
Data line status
Status information is available for the data line and the different states include:
Voice call status
Status information is available for the voice line and the different states include:
The client applications can get detailed voice call information such as:
call status
date and time that the call started
current duration of the call in seconds
dialled phone number
This is only valid for outgoing calls. It includes any DTMF tones that have been sent.
ciphering status
This is only valid on GSM and WCDMA networks
Call ID
Remote party information
The client applications can retrieve the information of the remote party when details are available. The information is available for the voice line. It is not available for the fax or data lines. When the voice line is making more than one call, for example one call is active and another is on hold, then you can read this information for individual calls. You do not need to have dialled or answered the call in order to read this information. However, the remote party may not allow you to know this information.
The remote party information available is:
Dynamic call capabilities
The client application can get the information about call hold, call resume and all swap functions of the device.
Network signal indicator
The client applications can get the notification of the network signal availability. The network information available is:
Signal strength
Signal strength is measured in dBm. For example, "-51" is a signal strength of -51dBm. A value of zero indicates that the signal strength cannot be measured. The signal bars represent number of bars to display to the user. A value of '-1' indicates that the number of bars is not available.
Registration status
The registration status indicates the service that the current network provides to the phone. For example, No Service, Emergency Only, Busy and Roaming.
Current network information
The information available for all types of network include:
network mode
mobile country code
network identity
network display tag
The network information available for GSM and WCDMA networks include:
network short name
network long name
access technology
location area code
cell ID of the base station
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.