Symbian3/SDK/Source/GUID-83676985-070A-5CE9-BF36-D7C56C5025F9.dita
changeset 7 51a74ef9ed63
parent 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-83676985-070A-5CE9-BF36-D7C56C5025F9.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,133 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-83676985-070A-5CE9-BF36-D7C56C5025F9" xml:lang="en"><title> Services
+Provided</title><shortdesc>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. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>The telephony API for application allows client applications to access
+information about: </p>
+<ul>
+<li id="GUID-FB929DCD-DB6F-5DAD-8DAE-7151B776E203"><p> <xref href="GUID-83676985-070A-5CE9-BF36-D7C56C5025F9.dita#GUID-83676985-070A-5CE9-BF36-D7C56C5025F9/GUID-D863BBC8-1391-5BCA-A5B8-DB23471A385B">Phone</xref>  </p> </li>
+<li id="GUID-CBA13E00-AE97-5AF5-927D-07EBD22D97E0"><p> <xref href="GUID-83676985-070A-5CE9-BF36-D7C56C5025F9.dita#GUID-83676985-070A-5CE9-BF36-D7C56C5025F9/GUID-B9CD50FF-28BF-5247-885C-710697EBA539">Call</xref>  </p> </li>
+<li id="GUID-547FF098-8F01-5553-BFE0-DB1F5D7E923C"><p> <xref href="GUID-83676985-070A-5CE9-BF36-D7C56C5025F9.dita#GUID-83676985-070A-5CE9-BF36-D7C56C5025F9/GUID-A68352BE-5980-5F66-B04B-C2FFC44FB409">Network</xref>  </p> </li>
+</ul>
+<section id="GUID-D863BBC8-1391-5BCA-A5B8-DB23471A385B"><title>Phone Information</title> <p>The
+phone information available is: </p> <p><b>Device identification </b> </p> <p>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. </p> <p><b>Subscriber identification </b> </p> <p>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. </p> <p><b>Flight
+mode status </b> </p> <p>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. </p> <p><b>Battery
+information </b> </p> <p>The client application can access the battery charge
+level and the battery status. The three states of a battery are: </p> <ul>
+<li id="GUID-2E5D8E44-0B52-57EC-9690-F4B3AD846CA0"><p>Powered </p> </li>
+<li id="GUID-04D411ED-A503-53E9-A177-1FAF28578C03"><p>No battery </p> </li>
+<li id="GUID-8A71BBC7-45B4-5204-B986-66AB24AC9E69"><p>Faulty battery </p> </li>
+</ul> <p><b>Battery charger information </b> </p> <p>The client application
+can find out if the charger is connected or not. </p> <p><b>Lock information </b> </p> <p>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. </p> </section>
+<section id="GUID-B9CD50FF-28BF-5247-885C-710697EBA539"><title>Call Information</title> <p>The
+call information available is: </p> <p><b>Call-in-progress indicator </b> </p> <p>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. </p> <p><b>Fax
+line status </b> </p> <p>Status information is available for the fax line
+and the different states include: </p> <ul>
+<li id="GUID-A8FE79DD-9651-5FBD-9CB8-7E80A8D89A3F"><p>idle </p> </li>
+<li id="GUID-B0DC6A12-8016-5EE8-A4DB-75065919F96C"><p>notify an inbound call </p> </li>
+<li id="GUID-F96EE593-E7C0-5519-B36D-BC50F8688844"><p>dialling a number </p> </li>
+<li id="GUID-84567467-1B0D-5365-82A0-3739C434B587"><p>answering an inbound
+call </p> </li>
+<li id="GUID-FA43C558-21DE-5E04-848A-10BE200EA587"><p>call on hold. </p> </li>
+</ul> <p><b>Data line status </b> </p> <p>Status information is available
+for the data line and the different states include: </p> <ul>
+<li id="GUID-AE8EFF6A-DA24-59A7-9BB1-50769EBC0F60"><p>idle </p> </li>
+<li id="GUID-E9F357E7-2420-5F04-B780-2C880D69FDC6"><p>notify an inbound call </p> </li>
+<li id="GUID-5E711492-C857-58F8-8D3D-4BF32486EAA4"><p>dialling a number </p> </li>
+<li id="GUID-EFD4A32A-9460-5403-8404-79720AB5C2E7"><p>answering an inbound
+call </p> </li>
+<li id="GUID-2783707D-D151-5F6B-81CA-07907ECFC545"><p>call on hold. </p> </li>
+</ul> <p><b>Voice call status </b> </p> <p>Status information is available
+for the voice line and the different states include: </p> <ul>
+<li id="GUID-E6E7F877-EFE7-54BD-A95C-301A88C606F7"><p>idle </p> </li>
+<li id="GUID-8C5DE194-8CE1-5E7B-B226-CD497CCE67F8"><p>notify an inbound call </p> </li>
+<li id="GUID-D671EBE6-C8A8-50B0-B223-D2DA568BB59B"><p>dialling a number </p> </li>
+<li id="GUID-34E12E0B-0417-5418-B8BC-4272F6AD2187"><p>answering an inbound
+call </p> </li>
+<li id="GUID-7D9C89BE-CF40-5386-9CCA-D3600A3653B9"><p>call on hold. </p> </li>
+</ul> <p>The client applications can get detailed voice call information such
+as: </p> <ul>
+<li id="GUID-6DD07BDD-04D5-54BA-B8B0-7928D0F70E22"><p>call status </p> </li>
+<li id="GUID-B70A7958-DFC1-52DA-B07D-3B704058489E"><p>date and time that the
+call started </p> </li>
+<li id="GUID-3D3FC0AA-1319-536B-80CA-FAEA36B517A4"><p>current duration of
+the call in seconds </p> </li>
+<li id="GUID-40890DAA-1F43-5B52-A97C-2D9134885A04"><p>dialled phone number </p> <p>This
+is only valid for outgoing calls. It includes any DTMF tones that have been
+sent. </p> </li>
+<li id="GUID-33E92A09-E559-5504-90E9-1A5098F50D3C"><p>ciphering status </p> <p>This
+is only valid on GSM and WCDMA networks </p> </li>
+<li id="GUID-A7BB8A56-1C6A-5647-B2F8-75941A181869"><p>Call ID </p> </li>
+</ul> <p><b>Remote party information </b> </p> <p>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. </p> <p>The remote party information available
+is: </p> <ul>
+<li id="GUID-C24ED61D-D2C1-5038-84E4-F4F0AD65D4C9"><p>remote identity status </p> </li>
+<li id="GUID-632BED79-5FA6-5FA5-B49B-32A9899A41F8"><p>remote party number </p> </li>
+<li id="GUID-9923B9FC-EF8D-5891-B89C-D0308444B8EA"><p>remote party name </p> </li>
+<li id="GUID-76C99712-2DF3-5B43-B247-A8EF144543D2"><p>call direction. </p> </li>
+</ul> <p><b>Dynamic call capabilities </b> </p> <p>The client application
+can get the information about call hold, call resume and all swap functions
+of the device. </p> </section>
+<section id="GUID-A68352BE-5980-5F66-B04B-C2FFC44FB409"><title>Network Information</title> <p><b>Network
+signal indicator </b> </p><p>The client applications can get the notification
+of the network signal availability. The network information available is: </p><p> <b>Signal
+strength</b> </p><p>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.</p><p><b>Registration
+status  </b></p><p>The registration status indicates the service that the
+current network provides to the phone. For example, No Service, Emergency
+Only, Busy and Roaming.  </p><p><b>Current network information  </b></p><p>The
+information available for all types of network include: </p><ul>
+<li><p>network mode </p></li>
+<li><p>mobile country code </p></li>
+<li><p>network identity  </p></li>
+<li><p>network display tag  </p></li>
+</ul> <p>The network information available for GSM and WCDMA networks include:
+ </p><ul>
+<li><p>network short name </p></li>
+<li><p>network long name </p></li>
+<li><p>access technology</p></li>
+<li><p> location area code  </p></li>
+<li><p>cell ID of the base station  </p></li>
+</ul></section>
+</conbody><related-links>
+<link href="GUID-520F620F-03CE-5C4E-9783-745D2740F648.dita"><linktext>What Supplementary
+Services are Provided</linktext></link>
+</related-links></concept>
\ No newline at end of file