phoneengine/phoneservices/inc/dialservice.h
changeset 21 92ab7f8d0eab
child 22 6bb1b21d2484
equal deleted inserted replaced
4:c84cf270c54f 21:92ab7f8d0eab
       
     1 /*!
       
     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). 
       
     3 * All rights reserved.
       
     4 * This component and the accompanying materials are made available
       
     5 * under the terms of "Eclipse Public License v1.0"
       
     6 * which accompanies this distribution, and is available
       
     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     8 *
       
     9 * Initial Contributors:
       
    10 * Nokia Corporation - initial contribution.
       
    11 *
       
    12 * Contributors:
       
    13 *
       
    14 * Description:  Dial API to be used through Qt Highway.
       
    15 *
       
    16 */
       
    17 
       
    18 #ifndef DIALSERVICE_H
       
    19 #define DIALSERVICE_H
       
    20 
       
    21 #include <QObject>
       
    22 #include <QString>
       
    23 #include <xqserviceprovider.h>
       
    24 #include "mpecallcontrolif.h"
       
    25 #include "mpecallsettersif.h"
       
    26 
       
    27 class DialService : public XQServiceProvider
       
    28 {
       
    29     Q_OBJECT
       
    30 public:
       
    31     DialService(MPECallControlIF &call, MPECallSettersIF &parameters, QObject *parent = 0);
       
    32     ~DialService();
       
    33     
       
    34 public slots:
       
    35     /*!
       
    36         \fn dial(const QString& number)
       
    37         
       
    38         This method makes a cellular switched dial command to
       
    39         Phone Application. It is intended to be used via Qt Highway.
       
    40         
       
    41         Usage example:
       
    42         XQServiceRequest snd("com.nokia.services.telephony","dial(QString)");
       
    43         snd << "0501234567";        
       
    44     */
       
    45     int dial(const QString& number);
       
    46     
       
    47     /*!
       
    48         \fn dial(const QString& number)
       
    49         
       
    50         This method makes a cellular switched dial command to
       
    51         Phone Application. It is intended to be used via Qt Highway.
       
    52         Caller's name is shown according to the given Phonebook contact
       
    53         identifier.
       
    54         
       
    55         Usage example:
       
    56         XQServiceRequest snd("com.nokia.services.telephony","dial(QString,int)");
       
    57         snd << "0501234567" << 123456;        
       
    58     */
       
    59     int dial(const QString& number, int contactId);
       
    60     
       
    61     /*!
       
    62         \fn dialVideo(const QString& number)
       
    63         
       
    64         This method makes a video call dial command to
       
    65         Phone Application. It is intended to be used via Qt Highway.
       
    66         
       
    67         Usage example:
       
    68         XQServiceRequest snd("com.nokia.services.telephony","dial(QString)");
       
    69         snd << "0501234567";        
       
    70     */
       
    71     void dialVideo(const QString& number);
       
    72 
       
    73     /*!
       
    74         \fn dial(const QString& number)
       
    75         
       
    76         This method makes a video call dial command to
       
    77         Phone Application. It is intended to be used via Qt Highway.
       
    78         Caller's name is shown according to the given Phonebook contact
       
    79         identifier.
       
    80         
       
    81         Usage example:
       
    82         XQServiceRequest snd("com.nokia.services.telephony","dial(QString,int)");
       
    83         snd << "0501234567" << 123456;        
       
    84     */
       
    85     void dialVideo(const QString& number, int contactId);
       
    86     
       
    87     /*!
       
    88         \fn dialVoip(const QString& address)
       
    89         
       
    90         This method makes a voip call dial command to
       
    91         Phone Application. It is intended to be used via Qt Highway.
       
    92         
       
    93         Usage example:
       
    94         XQServiceRequest snd("com.nokia.services.telephony","dialVoip(QString)");
       
    95         snd << "address@domain";        
       
    96     */
       
    97     void dialVoip(const QString& address);
       
    98     
       
    99     /*!
       
   100         \fn dialVoip(const QString& address, int contactId)
       
   101         
       
   102         This method makes a voip call dial command to
       
   103         Phone Application. It is intended to be used via Qt Highway.
       
   104         Caller's name is shown according to the given Phonebook contact
       
   105         identifier.
       
   106         
       
   107         Usage example:
       
   108         XQServiceRequest snd("com.nokia.services.telephony","dialVoip(QString,int)");
       
   109         snd << "address@domain" << 123456;        
       
   110     */
       
   111     void dialVoip(const QString& address, int contactId);
       
   112     
       
   113     /*!
       
   114         \fn dialVoipService(const QString& address, int contactId)
       
   115         
       
   116         This method makes a voip call dial command to
       
   117         Phone Application. It is intended to be used via Qt Highway.
       
   118         Call is made by given service (id).
       
   119         
       
   120         Usage example:
       
   121         XQServiceRequest snd("com.nokia.services.telephony","dialVoipService(QString,int)");
       
   122         snd << "address@domain" << 123;        
       
   123     */
       
   124     void dialVoipService(const QString& address, int serviceId);
       
   125     
       
   126     /*!
       
   127         \fn dialVoipService(const QString& address, int serviceId, int contactId)
       
   128         
       
   129         This method makes a voip call dial command to
       
   130         Phone Application. It is intended to be used via Qt Highway.
       
   131         Call is made by given service (id).
       
   132         Caller's name is shown according to the given Phonebook contact
       
   133         identifier.
       
   134         
       
   135         Usage example:
       
   136         XQServiceRequest snd("com.nokia.services.telephony","dialVoipService(QString,int,int)");
       
   137         snd << "address@domain" << 123 << 12345;        
       
   138     */
       
   139     void dialVoipService(const QString& address, int serviceId, int contactId);
       
   140 
       
   141 
       
   142 private:
       
   143     MPECallControlIF &m_call;
       
   144     MPECallSettersIF &m_parameters;    
       
   145 };
       
   146 
       
   147 #endif // DIALERSERVICE_H