diff -r 000000000000 -r bde4ae8d615e os/mm/mm_plat/global_audio_settings_api/inc/MGlobalAudioSettingsObserver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/os/mm/mm_plat/global_audio_settings_api/inc/MGlobalAudioSettingsObserver.h Fri Jun 15 03:10:57 2012 +0200 @@ -0,0 +1,74 @@ +/* +* Copyright (c) 2004 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 file contains definitions of GlobalAudioSettings observer. +* +*/ + + + +#ifndef MGLOBALAUDIOSETTINGSOBSERVER_H +#define MGLOBALAUDIOSETTINGSOBSERVER_H + +// CONSTANTS + +// CLASS DECLARATION + +/** + * An interface to Global Audio Settings observer callback functions. + * + * This serves as the method of communication between the client and the + * CGlobalAudioSettings object. + * + * The class is a mixin and is intended to be inherited by the client class + * that is interested in observing the global audio settings. The functions + * encapsulated by this class are called when events occur which causes device + * audio settings to be changed that affects the overall audio behavior. + * + * @lib GlobalAudioSettings.lib + * @since 3.2 + */ +class MAudioSettingsObserver + { +public: + enum TGASEventId + { + EGASWarningTones, + EGASMessageTones, + EGASSilentProfile, + EGASVibra, + EGASMessageToneName, + EGASEmailToneName, + EGASRingingType, + EGASVideoCallToneName, + EGASRingingTone1Name, + EGASRingingTone2Name, + EGASKeyPadVolume, + EGASSilenceMode + }; + +public: + /** + * Invoked by the Global Audio Settings object when audio setting has changed. + * + * @since 3.2 + * @param CGlobalAudioSettings& A reference to Global Audio Settings object + * which invoked the callback. + * @param aSetting Specific id of the audio setting that changed. + */ + virtual void SettingsChanged(CGlobalAudioSettings& aGlobalAudioSettings, TGASEventId aSetting) = 0; + }; + +#endif // MGLOBALAUDIOSETTINGSOBSERVER_H + +// End of File