phoneengine/phoneservices/inc/dialservice.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 19 Mar 2010 09:28:42 +0200
changeset 21 92ab7f8d0eab
child 22 6bb1b21d2484
permissions -rw-r--r--
Revision: 201007 Kit: 201011

/*!
* 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:  Dial API to be used through Qt Highway.
*
*/

#ifndef DIALSERVICE_H
#define DIALSERVICE_H

#include <QObject>
#include <QString>
#include <xqserviceprovider.h>
#include "mpecallcontrolif.h"
#include "mpecallsettersif.h"

class DialService : public XQServiceProvider
{
    Q_OBJECT
public:
    DialService(MPECallControlIF &call, MPECallSettersIF &parameters, QObject *parent = 0);
    ~DialService();
    
public slots:
    /*!
        \fn dial(const QString& number)
        
        This method makes a cellular switched dial command to
        Phone Application. It is intended to be used via Qt Highway.
        
        Usage example:
        XQServiceRequest snd("com.nokia.services.telephony","dial(QString)");
        snd << "0501234567";        
    */
    int dial(const QString& number);
    
    /*!
        \fn dial(const QString& number)
        
        This method makes a cellular switched dial command to
        Phone Application. It is intended to be used via Qt Highway.
        Caller's name is shown according to the given Phonebook contact
        identifier.
        
        Usage example:
        XQServiceRequest snd("com.nokia.services.telephony","dial(QString,int)");
        snd << "0501234567" << 123456;        
    */
    int dial(const QString& number, int contactId);
    
    /*!
        \fn dialVideo(const QString& number)
        
        This method makes a video call dial command to
        Phone Application. It is intended to be used via Qt Highway.
        
        Usage example:
        XQServiceRequest snd("com.nokia.services.telephony","dial(QString)");
        snd << "0501234567";        
    */
    void dialVideo(const QString& number);

    /*!
        \fn dial(const QString& number)
        
        This method makes a video call dial command to
        Phone Application. It is intended to be used via Qt Highway.
        Caller's name is shown according to the given Phonebook contact
        identifier.
        
        Usage example:
        XQServiceRequest snd("com.nokia.services.telephony","dial(QString,int)");
        snd << "0501234567" << 123456;        
    */
    void dialVideo(const QString& number, int contactId);
    
    /*!
        \fn dialVoip(const QString& address)
        
        This method makes a voip call dial command to
        Phone Application. It is intended to be used via Qt Highway.
        
        Usage example:
        XQServiceRequest snd("com.nokia.services.telephony","dialVoip(QString)");
        snd << "address@domain";        
    */
    void dialVoip(const QString& address);
    
    /*!
        \fn dialVoip(const QString& address, int contactId)
        
        This method makes a voip call dial command to
        Phone Application. It is intended to be used via Qt Highway.
        Caller's name is shown according to the given Phonebook contact
        identifier.
        
        Usage example:
        XQServiceRequest snd("com.nokia.services.telephony","dialVoip(QString,int)");
        snd << "address@domain" << 123456;        
    */
    void dialVoip(const QString& address, int contactId);
    
    /*!
        \fn dialVoipService(const QString& address, int contactId)
        
        This method makes a voip call dial command to
        Phone Application. It is intended to be used via Qt Highway.
        Call is made by given service (id).
        
        Usage example:
        XQServiceRequest snd("com.nokia.services.telephony","dialVoipService(QString,int)");
        snd << "address@domain" << 123;        
    */
    void dialVoipService(const QString& address, int serviceId);
    
    /*!
        \fn dialVoipService(const QString& address, int serviceId, int contactId)
        
        This method makes a voip call dial command to
        Phone Application. It is intended to be used via Qt Highway.
        Call is made by given service (id).
        Caller's name is shown according to the given Phonebook contact
        identifier.
        
        Usage example:
        XQServiceRequest snd("com.nokia.services.telephony","dialVoipService(QString,int,int)");
        snd << "address@domain" << 123 << 12345;        
    */
    void dialVoipService(const QString& address, int serviceId, int contactId);


private:
    MPECallControlIF &m_call;
    MPECallSettersIF &m_parameters;    
};

#endif // DIALERSERVICE_H