satui/satapp/inc/satapptoneprovider.h
author hgs
Mon, 04 Oct 2010 15:57:13 +0300
changeset 51 12bc758d6a02
parent 33 8d5d7fcf9b59
permissions -rw-r--r--
201039
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
33
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
#ifndef SATAPPTONEPROVIDER_H
hgs
parents:
diff changeset
    18
#define SATAPPTONEPROVIDER_H
hgs
parents:
diff changeset
    19
hgs
parents:
diff changeset
    20
// includes
hgs
parents:
diff changeset
    21
#include <QObject>
hgs
parents:
diff changeset
    22
#include <QString>
hgs
parents:
diff changeset
    23
#include <QByteArray>
hgs
parents:
diff changeset
    24
#include <msatuiobserver.h> //for TSatUiResponse
hgs
parents:
diff changeset
    25
#include <mdaaudiotoneplayer.h> //MMdaAudioToneObserver
hgs
parents:
diff changeset
    26
#include <mdaaudiosampleplayer.h> //MMdaAudioPlayerCallback
hgs
parents:
diff changeset
    27
hgs
parents:
diff changeset
    28
// forward declarations
hgs
parents:
diff changeset
    29
class QTimer;
hgs
parents:
diff changeset
    30
class HbMessageBox;
hgs
parents:
diff changeset
    31
class CMdaAudioToneUtility;
hgs
parents:
diff changeset
    32
class CMdaAudioPlayerUtility;
hgs
parents:
diff changeset
    33
class SatAppAction;
hgs
parents:
diff changeset
    34
hgs
parents:
diff changeset
    35
hgs
parents:
diff changeset
    36
class SatAppToneProvider:
hgs
parents:
diff changeset
    37
    public QObject,
hgs
parents:
diff changeset
    38
    public MMdaAudioToneObserver,
hgs
parents:
diff changeset
    39
    public MMdaAudioPlayerCallback
hgs
parents:
diff changeset
    40
{
hgs
parents:
diff changeset
    41
    Q_OBJECT
hgs
parents:
diff changeset
    42
hgs
parents:
diff changeset
    43
public:
hgs
parents:
diff changeset
    44
hgs
parents:
diff changeset
    45
    SatAppToneProvider(QObject *parent = 0);
hgs
parents:
diff changeset
    46
    virtual ~SatAppToneProvider();
hgs
parents:
diff changeset
    47
hgs
parents:
diff changeset
    48
public slots:
hgs
parents:
diff changeset
    49
hgs
parents:
diff changeset
    50
    void playTone(SatAppAction& action);
hgs
parents:
diff changeset
    51
    
hgs
parents:
diff changeset
    52
    void clearScreen();
hgs
parents:
diff changeset
    53
hgs
parents:
diff changeset
    54
private:
hgs
parents:
diff changeset
    55
hgs
parents:
diff changeset
    56
    enum State {Idle,PlayStandardTone,PlayUserSelectedTone};
hgs
parents:
diff changeset
    57
hgs
parents:
diff changeset
    58
    State recognizeTone(
hgs
parents:
diff changeset
    59
        int tone,
hgs
parents:
diff changeset
    60
        QByteArray& sequence,
hgs
parents:
diff changeset
    61
        int& duration);
hgs
parents:
diff changeset
    62
    QByteArray charArrayToByteArray(
hgs
parents:
diff changeset
    63
        const char tone[],
hgs
parents:
diff changeset
    64
        int size);
hgs
parents:
diff changeset
    65
    void playStandardTone(
hgs
parents:
diff changeset
    66
        const QString& text,
hgs
parents:
diff changeset
    67
        const QByteArray& sequence,
hgs
parents:
diff changeset
    68
        int duration);
hgs
parents:
diff changeset
    69
    void playUserSelectedTone(
hgs
parents:
diff changeset
    70
        const QString& text,
hgs
parents:
diff changeset
    71
        int tone,
hgs
parents:
diff changeset
    72
        int duration);
hgs
parents:
diff changeset
    73
hgs
parents:
diff changeset
    74
public slots:
hgs
parents:
diff changeset
    75
    /**
hgs
parents:
diff changeset
    76
     * Resets the UI state within the tone provider,
hgs
parents:
diff changeset
    77
     * commits pending server requests if any
hgs
parents:
diff changeset
    78
     */
hgs
parents:
diff changeset
    79
    void resetState();
hgs
parents:
diff changeset
    80
hgs
parents:
diff changeset
    81
private slots:
hgs
parents:
diff changeset
    82
hgs
parents:
diff changeset
    83
    void stopPlayTone();
hgs
parents:
diff changeset
    84
hgs
parents:
diff changeset
    85
// ****************************************************************************
hgs
parents:
diff changeset
    86
// * ************************************************************************ *
hgs
parents:
diff changeset
    87
// * *                          SYMBIAN PART                                * *
hgs
parents:
diff changeset
    88
// * ************************************************************************ *
hgs
parents:
diff changeset
    89
// ****************************************************************************
hgs
parents:
diff changeset
    90
hgs
parents:
diff changeset
    91
private:
hgs
parents:
diff changeset
    92
hgs
parents:
diff changeset
    93
    void SymbianPrepareAudioToneUtilityL(const TDesC8& sequence);
hgs
parents:
diff changeset
    94
    void SymbianStopAudioToneUtility();
hgs
parents:
diff changeset
    95
    void SymbianPrepareAudioPlayerL(int tone, int duration);
hgs
parents:
diff changeset
    96
    void SymbianStopAudioPlayer();
hgs
parents:
diff changeset
    97
    void GetProfileParamsL(
hgs
parents:
diff changeset
    98
        int tone=ESatToneNotSet, TDes* toneName=NULL );
hgs
parents:
diff changeset
    99
hgs
parents:
diff changeset
   100
public: // from MMdaAudioToneObserver
hgs
parents:
diff changeset
   101
hgs
parents:
diff changeset
   102
    void MatoPrepareComplete( TInt aError );
hgs
parents:
diff changeset
   103
    void MatoPlayComplete( TInt aError );
hgs
parents:
diff changeset
   104
hgs
parents:
diff changeset
   105
public: //from MMdaAudioPlayerCallback
hgs
parents:
diff changeset
   106
hgs
parents:
diff changeset
   107
    void MapcInitComplete( TInt aError,
hgs
parents:
diff changeset
   108
        const TTimeIntervalMicroSeconds& aDuration );
hgs
parents:
diff changeset
   109
    void MapcPlayComplete( TInt aError );
hgs
parents:
diff changeset
   110
hgs
parents:
diff changeset
   111
hgs
parents:
diff changeset
   112
private: // Data
hgs
parents:
diff changeset
   113
hgs
parents:
diff changeset
   114
    State mState;
hgs
parents:
diff changeset
   115
    SatAppAction* mCurrentAction;
hgs
parents:
diff changeset
   116
hgs
parents:
diff changeset
   117
    bool mWarningAndPlayTones;
hgs
parents:
diff changeset
   118
    int mVolume;
hgs
parents:
diff changeset
   119
    CMdaAudioToneUtility *mPlayer;
hgs
parents:
diff changeset
   120
    TSatUiResponse mPlayToneError;
hgs
parents:
diff changeset
   121
    QTimer *mTimer;
hgs
parents:
diff changeset
   122
    HbMessageBox *mPermanentNote;
hgs
parents:
diff changeset
   123
    CMdaAudioPlayerUtility *mAudioPlayer;
hgs
parents:
diff changeset
   124
hgs
parents:
diff changeset
   125
    // for unit testing
hgs
parents:
diff changeset
   126
    friend class ToneProviderTest;
hgs
parents:
diff changeset
   127
};
hgs
parents:
diff changeset
   128
hgs
parents:
diff changeset
   129
#endif //SATAPPTONEPROVIDER_H