diff -r c84cf270c54f -r 92ab7f8d0eab phoneengine/phoneservices/inc/dtmfservice.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/phoneengine/phoneservices/inc/dtmfservice.h Fri Mar 19 09:28:42 2010 +0200 @@ -0,0 +1,77 @@ +/*! +* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "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: +* +* Description: DTMF API to be used through Qt Highway. +* +*/ + +#ifndef DTMFSERVICE_H +#define DTMFSERVICE_H + +#include +#include +#include +#include "mpecallcontrolif.h" +#include "mpecallsettersif.h" + +class DTMFService : public XQServiceProvider +{ + Q_OBJECT +public: + DTMFService(MPECallControlIF &call, MPECallSettersIF ¶meters, QObject *parent = 0); + ~DTMFService(); + +public slots: + /*! + \fn recognizeKeySequence(const QString& keySequence) + + Client can use this method to execute key sequence recognition. + Key sequence may contain for example product codes etc. that + may cause lower layers to do any specific things. + + If sequence isn't recognized this method doesn't do anything. + If sequence is recognized then task related to the code is executed. + + Usage example: + XQServiceRequest snd("com.nokia.services.telephony","executeKeySequence(QString)"); + snd << "*#0000#"; + */ + void executeKeySequence(const QString& keySequence); + + /*! + \fn playDTMFTone(const QChar& keyToPlay) + + This method plays DTMF tone matching given character. + If character doesn't match any supported DTMF tone + it is ignored. + + Usage example: + XQServiceRequest snd("com.nokia.services.telephony","playDTMFTone(QChar)"); + snd << "5"; + */ + void playDTMFTone(const QChar& keyToPlay); + + /*! + \fn stopDTMFPlay() + + This method stops playing DTMF tone if it is currently played. + */ + void stopDTMFPlay(); + + +private: + MPECallControlIF &m_call; + MPECallSettersIF &m_parameters; +}; + +#endif // DTMFSERVICE_H