|
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 task |
|
11 PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd"> |
|
12 <task id="GUID-6ABEF478-F3DB-524E-A500-9431B42C6665" xml:lang="en"><title>Single |
|
13 Call Tutorial</title><shortdesc>This tutorial describes how to handle single call with the telephony |
|
14 API for applications. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> |
|
15 <context id="GUID-CF841B4F-0F62-5933-AD58-0A0593980732"><p>This state diagram |
|
16 shows how to dial or answer one call at a time. It presumes there are no other |
|
17 calls being made. </p> <fig id="GUID-5735A736-7536-507E-92CC-8A766D8B8F66"> |
|
18 <title> Single Call State Diagram </title> |
|
19 <image href="GUID-A2EFD9AD-F230-545C-8C5D-193F717B9FE2_d0e40447_href.png" placement="inline"/> |
|
20 </fig> <p>The boxes are states. The enumeration value in each box is the status |
|
21 of the voice line. <xref href="GUID-0DA6722B-0700-5612-884A-F3B7733E5252.dita">Voice |
|
22 line status</xref> describes the states and their meaning. You can also find |
|
23 the status of individual calls. The line state and the call state are the |
|
24 same in a single call. </p> <p>The arrows show events that trigger a change |
|
25 of state. In these events, a word in <b>bold</b> indicates a <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita"><apiname>CTelephony</apiname></xref> method |
|
26 that you can call. </p> </context> |
|
27 <steps id="GUID-6399570A-7FAF-5709-91B9-2168145F7F6C"> |
|
28 <step id="GUID-30E27A7D-0792-5B77-AEE5-189A681CDDA0"><cmd/> |
|
29 <info>Check the <xref href="GUID-0DA6722B-0700-5612-884A-F3B7733E5252.dita">Voice |
|
30 line status</xref> </info> |
|
31 <substeps id="GUID-12C8410C-2874-4502-B046-39EC0DC0E696"> |
|
32 <substep id="GUID-27EC866D-B7B3-4305-9996-404B51378BE5"><cmd/> |
|
33 <info>if the line is Idle(<xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-52E51C0C-8C27-311D-8B6B-223F899DB2C9"><apiname>CTelephony::EStatusIdle</apiname></xref>) no calls |
|
34 are in progress </info> |
|
35 </substep> |
|
36 <substep id="GUID-FF977DFD-6547-4FD6-B1B6-04D3F7E31ADC"><cmd/> |
|
37 <info>if the line is on hold(<xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-7F347F6A-0B02-34BC-B082-3449EA63A148"><apiname>CTelephony::EStatusHold</apiname></xref>) then |
|
38 there is another call in progress, but it is on hold and you can still dial |
|
39 or answer a second call </info> |
|
40 </substep> |
|
41 <substep id="GUID-956106AF-B740-48B8-B474-5442BE357FD6"><cmd/> |
|
42 <info>if a call is active, you must wait until it completes before you can |
|
43 dial or receive a call. To detect when this occurs, see <xref href="GUID-87CD8C58-F6B9-5D6B-9D7B-862979DE3B6F.dita">Notification |
|
44 Request Tutorial</xref> </info> |
|
45 </substep> |
|
46 </substeps> |
|
47 </step> |
|
48 <step id="GUID-27A87414-B446-5C5D-BCBE-72F543062D67"><cmd/> |
|
49 <info> <xref href="GUID-05759C1B-6731-52A1-8EC0-2570E01FC7BC.dita">Dial a call</xref> </info> |
|
50 <info>While no calls are in progress, the line status is <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-52E51C0C-8C27-311D-8B6B-223F899DB2C9"><apiname>CTelephony::EStatusIdle</apiname></xref>. |
|
51 To dial a call, use <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-E7A25EB6-B7FD-31DF-9A03-F100F93D7138"><apiname>CTelephony::DialNewCall()</apiname></xref>. </info> |
|
52 <info>If successful and the remotes party answers the call then the line status |
|
53 is <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-641B7EAB-56C6-3E9C-A53C-EE382925E1CE"><apiname>CTelephony::EStatusConnected</apiname></xref>. </info> |
|
54 </step> |
|
55 <step id="GUID-2D16FAAD-3900-5313-9C45-4E7867BF4453"><cmd/> |
|
56 <info> <xref href="GUID-D6334249-E61D-55E7-9D0E-95231DC3621F.dita">Answer a call</xref> </info> |
|
57 <info>When no calls are in progress, the line status is <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-52E51C0C-8C27-311D-8B6B-223F899DB2C9"><apiname>CTelephony::EStatusIdle</apiname></xref>. </info> |
|
58 <info>When a remote party calls your phone, the voice line status will change |
|
59 to <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-7632FB7B-0272-39CB-B71A-C3C09EEB5E88"><apiname>CTelephony::EStatusRinging</apiname></xref>. </info> |
|
60 <info>When the status is <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-7632FB7B-0272-39CB-B71A-C3C09EEB5E88"><apiname>CTelephony::EStatusRinging</apiname></xref>, use <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-6D12DBA4-8902-3649-B144-47C91F16C4B3"><apiname>CTelephony::AnswerIncomingCall()</apiname></xref> to |
|
61 answer the call. The status changes to <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-641B7EAB-56C6-3E9C-A53C-EE382925E1CE"><apiname>CTelephony::EStatusConnected</apiname></xref> and |
|
62 the phone user can talk to the remote party. </info> |
|
63 </step> |
|
64 <step id="GUID-7398BBDB-3EA9-5575-A04F-47292ADA05BD"><cmd/> |
|
65 <info> <xref href="GUID-91082AAB-DC8D-5AEA-A6C1-DD89932244FB.dita">Terminate a |
|
66 call</xref> </info> |
|
67 </step> |
|
68 <step id="GUID-85EFB23C-DE86-5614-928F-A12ADF8E799E"><cmd/> |
|
69 <info> <xref href="GUID-42B10CBF-D45A-580F-A639-E2495FF3B4F3.dita">Detect remote |
|
70 party call termination</xref> </info> |
|
71 </step> |
|
72 <step id="GUID-28C01974-AB55-5AFC-A5CD-A5054AC06A51"><cmd/> |
|
73 <info> <xref href="GUID-1907CF0B-2F4B-50F6-B676-7B7059B7FF74.dita">Hold a Call</xref> </info> |
|
74 </step> |
|
75 <step id="GUID-F3CA48F5-F03E-5CC5-BBCE-A1B3F122861C"><cmd/> |
|
76 <info> <xref href="GUID-FFBD95C6-0B12-5FD7-BA69-89BBFB97F0A1.dita">Resume a call</xref> </info> |
|
77 </step> |
|
78 <step id="GUID-809085D2-7B65-5C40-88EA-E3619158D7F6"><cmd/> |
|
79 <info> <xref href="GUID-9C5A86D2-E602-55AE-B54B-8511E70CD23D.dita">Send DTMF tones </xref> </info> |
|
80 </step> |
|
81 </steps> |
|
82 <result><p> When you successfully dial or answer a call, you will be given |
|
83 a |
|
84 <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-86D48DF2-1AA1-337A-A270-6703FF29C958"><apiname>CTelephony::TCallId</apiname></xref> the identifies the call. |
|
85 </p><p>A remote party might try to ring your phone. The voice line state will |
|
86 change to <xref href="GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A.dita#GUID-97D402C8-B4B7-385A-92B3-D3FCC0CA575A/GUID-7632FB7B-0272-39CB-B71A-C3C09EEB5E88"><apiname>CTelephony::EStatusRinging</apiname></xref>. You can ignore this |
|
87 call. You can still terminate, hold, resume and send DTMF. |
|
88 </p></result> |
|
89 </taskbody><related-links> |
|
90 <link href="GUID-130C21D7-0A39-5A54-8545-C82B2ED4398C.dita"><linktext>Simultaneous |
|
91 Call Tutorial</linktext></link> |
|
92 </related-links></task> |