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-BA053D6F-5B9C-5F98-B70D-FD2323C58BDF" xml:lang="en"><title>User

    13 to User Signalling Service Tutorial</title><shortdesc>This tutorial descrbes how to use the User to User Signalling (UUS)

    14 service in a call. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

    15 

    16 

    17 <context><p>UUS is a supplementary service that allows a subscriber to send

    18 and receive a limited amount of subscriber generated User to User Information

    19 (UUI) to and from another user in association with a call to the user. Three

    20 variants on the UUS service, UUS 1 to 3, may be available. </p> </context>

    21 <steps id="GUID-C8B99561-CA7C-5561-A61C-BF1BAE8D00D4">

    22 <step id="GUID-8E262A82-6702-5E95-AC4C-02B9373FA2EA"><cmd/>

    23 <info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::GetUUSCaps()</apiname></xref> to

    24 get UUS capabilities. </info>

    25 <info>Capabilities are encapsulated in <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::TMobileCallUUSCaps</apiname></xref>. </info>

    26 </step>

    27 <step id="GUID-38BEC34B-E542-5568-BD0E-A4F932022798"><cmd/>

    28 <info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::NotifyUUSCapsChange()</apiname></xref> to

    29 get the notification of any changes in the capabilities. </info>

    30 </step>

    31 <step id="GUID-1D95D4BE-EFDD-5F5A-838D-AC9AEF9CAD22"><cmd/>

    32 <info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::ActivateUUS()</apiname></xref> to

    33 activate a UUS service. </info>

    34 </step>

    35 <step id="GUID-6BC72867-9D4B-5EEF-97F0-8FA0FADB2354"><cmd/>

    36 <info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::SendUUI()</apiname></xref> to

    37 send a UUI message for UUS2 and UUS3 service to the end user. </info>

    38 </step>

    39 <step id="GUID-EA14C543-1D94-54E4-9446-A05A9CC4A483"><cmd/>

    40 <info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::ReceiveUUI()</apiname></xref> to

    41 request the next incoming UUI message from the remote user. </info>

    42 </step>

    43 <step id="GUID-2E562879-961D-5E96-A9F4-129584D66EA6"><cmd/>

    44 <info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::HangupWithUUI()</apiname></xref> to

    45 hang up a call and send a UUS1 data message at the call release. </info>

    46 </step>

    47 <step id="GUID-3795A852-DC44-514B-983A-387F12206ABB"><cmd/>

    48 <info>Use <xref href="GUID-7B623041-5DB3-3EF6-AAF4-5AA89B519855.dita"><apiname>RMobileCall::AnswerIncomingCallWithUUI()</apiname></xref> to

    49 answer an inbound call and send UUI to the calling party. </info>

    50 </step>

    51 </steps>

    52 <postreq><p>User-To-User Signalling service settings are controlled through

    53  <xref href="GUID-AA81AFA4-6FAC-3B0D-A082-BE0AEC58CCA8.dita"><apiname>RMobilePhone</apiname></xref>.  </p></postreq>

    54 </taskbody><related-links>

    55 <link href="GUID-E2AF923A-D796-5DA9-B678-C6E2ABF7A6CC.dita"><linktext>Call Completion

    56 to Busy Subscriber Tutorial</linktext></link>

    57 </related-links></task>