Symbian
Symbian OS Library

FAQ-1034 What is the CMdaAudioToneUtility DualTone API?

[Index][spacer] [Previous] [Next]



 

Classification: C++ Category: Multimedia
Created: 04/19/2004 Modified: 05/17/2004
Number: FAQ-1034
Platform: Symbian OS v7.0s

Question:
I have heard references to a DualTone API which allows me to play two user-defined tone frequencies but cannot find any documentation for it. What is this API?

Answer:
The DualTone API was a late addition to Symbian OS v7.0s and will only be available in phones running v8.0 or later builds of v7.0s (excluding the Nokia 6600). The API is defined in MdaAudioTonePlayer.h and is used in the same way as the other tone APIs.

    In order to prepare a tone of two user defined frequencies the following method is used:

    IMPORT_C void PrepareToPlayDualTone(TInt aFrequencyOne, TInt aFrequencyTwo, const TTimeIntervalMicroSeconds& aDuration);

    The two frequencies are supplied in Hertz and the required duration of the tone is supplied in micro seconds. Once the tone has been prepared it can be played and stopped in the same manner as with the other tone types i.e. Play() and CancelPlay() etc.