diff -r 61bc0f252b2b -r bac7acad7cb3 camerauis/cameraapp/generic/inc/CamSoundPlayer.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/camerauis/cameraapp/generic/inc/CamSoundPlayer.h Wed Sep 01 12:30:54 2010 +0100 @@ -0,0 +1,186 @@ +/* +* Copyright (c) 2007 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: Handles the playing of sounds and tones for the Camera App* +*/ + + + +#ifndef CAMSOUNDPLAYER_H +#define CAMSOUNDPLAYER_H + +// INCLUDES +#include +#include "Cam.hrh" // For TCamSoundId + +// CONSTANTS + +// MACROS + +// DATA TYPES + +// FUNCTION PROTOTYPES + +// FORWARD DECLARATIONS +class CAknKeySoundSystem; + +// CLASS DECLARATION + + +/** +* Observer class for getting notified when sound playback completes. +*/ +class MCamSoundPlayerObserver + { + public: + /** + * CCamSoundPlayer has finished sound playback + * and callback was requested (aEnableCallback was true + * in CCamSoundPlayer::PlaySound()). + * @since 2.8 + */ + virtual void PlaySoundComplete() = 0; + }; + +/** +* This class is used to play sounds and tones for the Camera app +* +* @since 2.8 +*/ +class CCamSoundPlayer : public CBase, + public MMdaAudioPlayerCallback + { + public: // Constructors and destructor + + /** + * Two-phased constructor. + * @param aObs Observer to be informed when sound playback is complete. + */ + static CCamSoundPlayer* NewL( MCamSoundPlayerObserver* aObs ); + + /** + * Destructor. + */ + virtual ~CCamSoundPlayer(); + + public: // New functions + + /** + * Initialises the sound player. + * @since 2.8 + */ + void InitialiseL(); + + /** + * Starts procedure to play the specified sound + * @since 2.8 + * @param aSound The sound to play + * @param aEnableCallback Whether to call back when play complete + */ + void PlaySound( TCamSoundId aSound, TBool aEnableCallback ); + + + /** + * Called to disable certain key press clicks + * @since 2.8 + */ + void DisableSelectionKeySoundL(); + + /** + * Called to enable certain key press clicks + * @since 2.8 + */ + void EnableSelectionKeySound(); + + /** + * Called to disable all key sounds, usually when video recording + * is active + * @since 2.8 + */ + void DisableAllKeySoundsL(); + + /** + * Called to enable all key sounds, usually when video recording + * is has stopped + * @since 2.8 + */ + void EnableAllKeySounds(); + + + public: // Functions from base classes + /** + * From MMdaAudioPlayerCallback. + * @since 2.8 + */ + void MapcInitComplete( TInt aError, + const TTimeIntervalMicroSeconds& aDuration ); + + /** + * From MMdaAudioPlayerCallback. + * @since 2.8 + */ + void MapcPlayComplete( TInt aError ); + + private: + + /** + * C++ default constructor. + * @since 2.8 + * @param aObs Observer to be informed when sound playback is complete. + */ + CCamSoundPlayer( MCamSoundPlayerObserver* aObs ); + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL(); + + /** + * Starts procedure to play audio (WAV) files. Internal function + * @since 2.8 + * @param aFile The file to open + * @param aEnableCallback Whether to call back when play complete + */ + void StartPlaySound( const TDesC& aFile, const TBool aEnableCallback ); + + public: // Data + + // Audio player utility for WAV sounds (eg Video Recording) + CMdaAudioPlayerUtility* iAudioPlayer; + + // Key sound system for Self-timer sound and camera shutter. + CAknKeySoundSystem* iKeySoundSystem; + + // Observer to notify when playback completes + MCamSoundPlayerObserver* iObserver; + + // Whether file open is still in progress + TBool iOpenFileInProgress; + + // Whether a callback for current sound has been requested + TBool iEnableCallback; + + // Whether this class has been initialised yet + TBool iInitialised; + + // Whether selection keys have been silenced + TBool iSelectionKeySilent; + + // Whether all keys have been silenced + TBool iAllKeysSilent; + + }; + +#endif // CAMSOUNDPLAYER_H + +// End of File