/*

* 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