|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-6BD861E5-7F33-513D-8B35-CFA47E3E82F3" xml:lang="en"><title>Architecture</title><shortdesc>This section describes the architectural relationships of the telephony |
|
13 API for applications. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>The telephony API for applications provides access to the basic telephony |
|
15 functionality for applications. The telephony API for applications is a subset |
|
16 of the multimode telephony API that provides a rich set of telephony applications |
|
17 to the handset manufacturers. </p> |
|
18 <section id="GUID-7EDF535A-3E6D-4092-B036-2A01C52098DA"><title>Overview</title> <p>The API is implemented as static linked |
|
19 library <filepath>etel3rdparty.dll</filepath>. The library must be linked |
|
20 in the client applications to access the telephony functions. The client applications |
|
21 access the functions with the <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony</apiname></xref> class. </p> <fig id="GUID-E83AD33D-9520-57F1-AEDB-6142D67267AB"> |
|
22 <title> Telephony API for Applications - Block Diagram |
|
23 </title> |
|
24 <image href="GUID-736F9C4B-7C70-5927-A9C9-21A127C431AF_d0e33692_href.png" placement="inline"/> |
|
25 </fig> </section> |
|
26 <section id="GUID-88403933-3F71-4BA1-911B-D984A25A7258"><title>Description</title> <p>The <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony</apiname></xref> class |
|
27 provides a limited set of telephony functions to client applications. The <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony</apiname></xref> is built on top of the core, multimode |
|
28 and packet data telephony APIs. The <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony</apiname></xref> class |
|
29 provides client applications with the functions to : </p> <ul> |
|
30 <li id="GUID-22A18771-C1E9-57A7-B221-C6D621E1410E"><p>dial a call </p> </li> |
|
31 <li id="GUID-DC0239F0-06D4-5B4B-A830-E6C62DF5A8CB"><p>answer a call </p> </li> |
|
32 <li id="GUID-A42C48C2-82B8-594F-BB69-170AAF9B2EA1"><p>get the capabilities |
|
33 of the line, the call and the network </p> </li> |
|
34 <li id="GUID-38EC4FDC-825C-5513-9C5E-EF5C9F27EBEB"><p>get information about |
|
35 the basic and supplementary services of the network </p> </li> |
|
36 </ul> <p>The <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony</apiname></xref> class translates |
|
37 the client API request into the internal commands and forwards them to the |
|
38 telephony server. The telephony server forwards the command requests to the |
|
39 telephony server plug-in (TSY). The TSY is developed and customised by the |
|
40 handset manufacturers. The telephony functions available to client applications |
|
41 depend on the functions implemented in the TSY. </p> </section> |
|
42 <section id="GUID-EDB80144-9C59-4C78-948F-A158F3FD0033"><title>Platform security</title> <p>The DLL for the telephony API |
|
43 for applications, <i>etel3rdparty.dll </i> is protected with the <codeph>ALL |
|
44 -TCB </codeph> capability. According to the Symbian <xref href="GUID-4BFEDD79-9502-526A-BA7B-97550A6F0601.dita">Platform |
|
45 security</xref> model the client applications must have the minimum capability |
|
46 of <codeph>ALL -TCB</codeph> to use the DLL. </p> </section> |
|
47 </conbody></concept> |