<?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 task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task xml:lang="en" id="GUID-14BAAB7C-35CD-5A43-B362-79F88C7712DE"><title>Playing Tones</title><shortdesc>This document describes how to play various types of tones and how to pause and resume a tone. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody><prereq id="GUID-4551AE94-5BD1-5698-977D-14F410097137"><p>Before you start playing a tone, you must: </p> <ol id="GUID-DB7D349C-093B-5BE9-B731-160229C453F0"><li id="GUID-A22C52EF-68B8-5A02-9106-3F36D38438A3"><p>Construct a new instance of DevSound using the <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-088CC167-C46D-3A2B-BE00-D7AEB98254AE"><apiname>CMMFDevSound::NewL()</apiname></xref> function. </p> </li> <li id="GUID-0543907D-3EF5-55C0-8FB7-3AFF755B724F"><p>Initialize DevSound using the <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-CBBB4A4E-0705-37E2-9832-A55861ACF299"><apiname>CMMFDevSound::InitializeL()</apiname></xref> function. </p> <p>This function requires that you specify the DevSound observer class to handle callbacks. Once initialization has completed, successfully or otherwise, DevSound calls the <xref href="GUID-D0F3F385-68C9-331D-865F-DA36589BE9FD.dita#GUID-D0F3F385-68C9-331D-865F-DA36589BE9FD/GUID-089CF9C1-92EF-3F40-8669-A5EF5C064AD4"><apiname>MDevSoundObserver::InitializeComplete()</apiname></xref> function. </p> </li> <li id="GUID-2782B303-BDE7-5F9C-9989-6D46AE123332"><p>Configure DevSound according to the tone you select to play. </p> <p> <b>Note:</b> The configuration differs according to the tone played. </p> </li> </ol> </prereq> <context id="GUID-CAE51F18-C77B-59E9-8138-7A06CA8E444F"><p>The tone is a simple ring tone. You can play tones by calling the following functions: </p> <ul><li id="GUID-73B1F7B2-B630-537F-9351-87075731F071"><p> <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-0849016F-D457-3521-A53A-85023D8561B8"><apiname>CMMFDevSound::PlayToneL(TInt,const

                TTimeIntervalMicroSeconds &amp;)</apiname></xref> plays a single tone. </p> </li> <li id="GUID-E05EB3EE-ADAD-5F34-A5E8-3C336BF2FDBF"><p> <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-D2C197B2-BB55-3B46-8F4D-FEDEE846B166"><apiname>CMMFDevSound::PlayDualToneL(TInt,TInt,const

                TTimeIntervalMicroSeconds &amp;)</apiname></xref> plays a dual tone. </p> </li> <li id="GUID-DBF5A55C-07AB-5A9E-A784-D1C3C254E2AD"><p> <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-B7D94866-D31C-3537-856C-441495940354"><apiname>CMMFDevSound::PlayDTMFStringL(const TDesC &amp;) plays a

                DTMF (Dual and Multi-Frequency)</apiname></xref> tone. </p> </li> <li id="GUID-31735F6E-1D36-5FDF-9529-3C8ACFBBCDEF"><p> <xref href="GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD.dita#GUID-B3E9B015-1413-35A6-A316-D1C01C1001AD/GUID-2B48CD01-DBD9-3669-8F79-0812FA03B0D3"><apiname>CMMFDevSound::PlayToneSequenceL(const TDesC8

                &amp;)</apiname></xref> plays a sequence of tones. </p> </li> </ul> </context> <steps id="GUID-8F9CB81A-3BBF-54AB-8F9C-89AEFD4DDE0D"><step id="GUID-6BA1553A-4C68-5609-8B83-F858D7F7AD31"><cmd/><info><xref href="GUID-A748041F-5925-54F8-AA21-C1CE8E0473AA.dita">Playing a Tone</xref>   </info> </step> <step id="GUID-ADB09852-5E7E-5302-A524-93DDC07500B5"><cmd/><info><xref href="GUID-3AB05112-0580-5FD2-AD61-5721090062F8.dita">Playing a DTMF Tone</xref>   </info> </step> <step id="GUID-95BB7981-F0A5-510C-BEA5-EDED50C95258"><cmd/><info><xref href="GUID-12A754EE-7D90-56C8-BDA7-3293F34BE456.dita">Playing a Tone Sequence</xref>   </info> </step> <step id="GUID-1B30569A-B6C8-5CA8-8F3A-A19155E81B53"><cmd/><info><xref href="GUID-93EF4862-2395-5ED7-8446-A7FDA60535B1.dita">Playing a Fixed Tone Sequence</xref>   </info> </step> <step id="GUID-44CA5AE2-4DBD-5EF7-B66A-8804322423C8"><cmd/><info><xref href="GUID-DD8BFFF1-15C7-59B0-A107-C5CC90DBF4CC.dita">Pausing and Resuming a Tone</xref>   </info> </step> </steps> </taskbody><related-links><link href="GUID-53A5AC8D-8A43-505F-A0B6-9E34F3CF23BE.dita"><linktext>Playing Audio Tutorial</linktext> </link> <link href="GUID-3FC6342D-D09C-5C7F-8E03-3DA7B29D2CC8.dita"><linktext>Recording Audio

                Tutorial</linktext> </link> </related-links></task>