wvuing/wvaudiomanager/Inc/CCAAudioManager.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 26 Jan 2010 11:50:09 +0200
changeset 2 7b3b89e6be20
parent 0 094583676ce7
permissions -rw-r--r--
Revision: 201001 Kit: 201004

/*
* Copyright (c) 2003-2005 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:  This class gives interface for playing IM message alert
 *
*/



#ifndef CCAAUDIOMANAGER_H
#define CCAAUDIOMANAGER_H

//  INCLUDES
#include "MCANotifierKeyObserver.h"
#include <apgcli.h>
#include <mdaaudiosampleplayer.h>
#include <MdaAudioTonePlayer.h>
#include <bldvariant.hrh>

#include <centralrepository.h>
#include <CenRepNotifyHandler.h>
#include <barsc.h>
#include <Profile.hrh>
#include <e32base.h>

#include "MCAAudioInterface.h"

// FORWARD DECLARATIONS
class CFLDRingingTonePlayer;
class MProfileEngine;
class MCAAudioManagerObserver;
class MCANotifierInterface;
class MProfile;
class CHWRMVibra;
#include "MCAAudioInterface.h"

// FORWARD DECLARATIONS
class CIMPSPresenceConnectionUi;
class CIMPSSAPSettings;
class CIMPSSAPSettingsStore;

// CLASS DECLARATION

/**
 *  This class gives interface to play
 *  simple sounds
 *
 *  @lib chat.app
 *  @since 1.2
 */
class CCAAudioManager
            : public CBase,
            public MMdaAudioPlayerCallback,
            public MCANotifierKeyObserver,
            public MMdaAudioToneObserver,
            public MCenRepNotifyHandlerCallback,
            public MCAAudioInterface
    {
    protected:  // Enumerations

        enum TAudioPlayerStatus
            {
            EAudioPlayerNotCreated,
            EAudioPlayerInitializing,
            EAudioPlayerReady,
            EAudioPlayerPlaying,
            EAudioPlayerInitialized
            };

    public:  // Constructors and destructor

        /**
         * Two-phased constructor.
         * @param aConnUi - Connection UI
         * @param aIMLauncherInvoked ETrue if invoked from IMLauncher.
         */
        IMPORT_C static CCAAudioManager* NewL( CIMPSPresenceConnectionUi& aConnUi,
                                               TBool aIMLauncherInvoked = EFalse );

        /**
         * Destructor.
         */
        virtual ~CCAAudioManager();

    public: // New functions

        /**
         * Starts playing the tone that has been set
         * @since 1.2
         */
        IMPORT_C void PlayL();

        /**
         * Stops playing
         * @since 1.2
         */
        IMPORT_C void Stop();

        /**
        * Set the volume level on which the sound is played
        * If this method is not called, player uses the setting
        * in active profile.
        * @since 2.6
        * @param aVolume The volume level
        */
        IMPORT_C void SetVolume( TInt aVolume );

        /**
        * Sets the ringing type
        * If this method is not called, player uses the setting
        * in active profile.
        * @since 2.6
        * @param aRingingType The ringing type (see enum TProfileRingingType)
        */
        IMPORT_C void SetRingingType( TProfileRingingType aRingingType );

        /**
        * Sets vibrating alert on or off.
        * If this method is not called, player uses the
        * setting in active profile.
        * @since 2.6
        * @param aVibra True: Vibra is on. False: Vibra is off.
        */
        IMPORT_C void SetVibra( TBool aVibra );

        /**
         * Adds observer, which is informed when playing is completed
         * @since 2.6
         * @param aObserver observing object
         */
        IMPORT_C void AddObserverL( const MCAAudioManagerObserver* aObserver );

        /**
         * Removes observer
         * @since 2.6
         * @param aObserver observing object
         */
        IMPORT_C void RemoveObserver( const MCAAudioManagerObserver* aObserver );

    private: // constructors

        /**
         * C++ default constructor.
         * @see CCAAudioManager::NewL
         */
        CCAAudioManager( CIMPSPresenceConnectionUi& aConnUi,
                         TBool aIMLauncherInvoked );

        /**
         * By default Symbian 2nd phase constructor is private.
         */
        void ConstructL();

    private:
        /**
         * Does the actual sound playing
         * @since 2.1
         */
        void DoPlayL();

        /**
         * Starts playing the sound sequence
         * @since 2.6
         * @param aSequence The sequence to be processed
         */
        void ProcessDesSequence( const TDesC8& aSequence );

        /**
         * Starts playing default IM alert sound
         */
        void ProcessDefaultAlertSound();

        /**
         * Starts playing the sound file
         * @since 2.6
         * @param aFileName The file to be processed
         */
        void ProcessFileL( const TDesC& aFileName );

        /** When audioplayer is ready, set its ringing type
         * @since 2.6
         * @param aRingingType The ringing type (see enum TRingingTypes)
         */
        void DoSetRingingType( TInt aRingingType );

        /**
        * Converts volume from 1 to 10 to audio driver understandable value.
        * @since 2.6
        * @param aVolume Volume level to be converted.
        * @return Returns converted volume level
        */
        TInt ConvertVolume( TInt aVolume );

        /**
         * Informs observers when playing is completed
         * @since 2.6
         */
        void NotifyObservers();

        /**
         * Passess error to current activescheluder if
         * error = KErrNoMemory or KErrDiskFull
         */
        void HandleError( TInt aError );

        /**
         * Gets tone file name from SAP settings
         * @param aToneFileName After the call this will
         *                       contain the tone file name
         */
        void GetToneFileNameL( TDes& aToneFileName );

        /**
         * Gets the default audio file name
         * @param aSoundFileName After the call this will
         *                       contain the default file name
         */
        void DefaultSoundFile( TDes& aSoundFileName );


        /**
        * Gets editable stored SAP
        */
        CIMPSSAPSettings* StoredSAPLC();

        /**
         * Gets current SAP
         */
        CIMPSSAPSettings* CurrentSAPLC();


    private:    // Methods derived from MMdaAudioPlayerCallback

        /**
        * Derived from MMdaAudioPlayerCallback
        * This method is called when the audio player initialisation is ready
        * @see MMdaAudioPlayerCallback
        */
        void MapcInitComplete( TInt aError,
                               const TTimeIntervalMicroSeconds& aDuration );

        /**
        * Derived from MMdaAudioPlayerCallback
        * This method is called when the audio player has finished playing
        * @see MMdaAudioPlayerCallback
        */
        void MapcPlayComplete( TInt aError );

    private:    // Methods derived from MMdaAudioToneObserver

        /**
         * Derived from MMdaAudioToneObserver
         * This method is called when the tone player initialisation is ready
         * @see MMdaAudioToneObserver
         */
        virtual void MatoPrepareComplete( TInt aError );

        /**
        * Derived from MMdaAudioToneObserver
        * This method is called when the tone player has finished playing
        * @see MMdaAudioToneObserver
        */
        virtual void MatoPlayComplete( TInt aError );

    private:    // Methods derived from MCANotifierKeyObserver

        /**
        * Derived from MCANotifierKeyObserver
        * Receive a notification from publish and subscribe keys
        */
        void HandleKeyChange( TUpdatedKey& aUpdatedValues );

    private:    // Methods derived from MCenRepNotifyHandlerCallback
        /**
        * Derived from MCenRepNotifyHandlerCallback
        * Receive a notification from central repository server
        */
        void HandleNotifyInt( TUint32 aId, TInt aNewValue );

    private:     // Data


        // Doesn't own. Profile API  if silent then there is no sounds
        MProfileEngine* iProfileApi;

        // Used to play other audio files than ringing tones. Owned.
        CMdaAudioPlayerUtility* iAudioPlayer;
        TAudioPlayerStatus iAudioPlayerStatus;

        // Used to play ringing tones. Owned
        CMdaAudioToneUtility* iTonePlayer;
        TAudioPlayerStatus iTonePlayerStatus;

        // Used for follow if user stops audio playing,
        // also for profile changes in volume level and vibrating alert
        CCenRepNotifyHandler* iRingingVolumeNotifyHandler;
        CCenRepNotifyHandler* iRingingTypeNotifyHandler;
        CCenRepNotifyHandler* iVibraNotifyHandler;

        CRepository* iProfilesRepository;
        CRepository* iVibraRepository;

        // Used to follow tone quit key
        MCANotifierInterface* iNotifierAPI;

        // ringing settings
        TInt iRingingVolume;
        TInt iRingingType;
        TBool iVibra;

        // Used when checking audio file type
        RApaLsSession iApaSession;

        // Audiomanager observers
        RPointerArray<MCAAudioManagerObserver> iObservers;

        // Used to keep track if current sound is default sound.
        TBool iIsPlayingDefaultIMSound;

        // Tone file name
        HBufC* iToneFileName;

        // File session for file operations
        RFs iFs;

        // currently active profile (ownership transferred)
        MProfile* iActiveProfile;

        // owned, vibra API
        CHWRMVibra* iVibrator;

        // ETrue if Always Online is active, invoked from IM Launcher
        TBool iIMLauncherInvoked;

        // Beep once ringing tone
        HBufC* iBeepRingingTone;

        // owns. Access to central repository
        CRepository* iCenRep;

        // Doesnt Own. Connection UI
        CIMPSPresenceConnectionUi& iConnUI;

        // Owns, sapsettingstore interface
        CIMPSSAPSettingsStore* iSapSettings;


        // ETrue if IMPSCUI Session Id should be preserved upon exit
        TBool iPreserveSessionIdInExit;

    };

#endif      // CCAAUDIOMANAGER_H

// End of File