diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/ataudioeventapi.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/epoc32/include/ataudioeventapi.h Tue Mar 16 16:12:26 2010 +0000 @@ -0,0 +1,118 @@ +/* +* Copyright (c) 2002-2006 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members +* which accompanies this distribution, and is available +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Client side application interface. +* +*/ + + +#ifndef __ATAUDIOEVENTAPI_H__ +#define __ATAUDIOEVENTAPI_H__ + +// INCLUDES +#include +#include +#include "ataudioeventconstants.hrh" // TAudioThemeEvent, TATError + +class RATSoundServerSession; +class MATEventCompleteObserver; +class CATMessageHelper; + +/** +* Implements client side API for Audio Theme sound server. +* +* @lib ATSoundServerClient.lib +* @since Series 60 release 3.0 +*/ +class CATAudioEventAPI : public CBase + { +public: + + /** + * Two-phased constructor. + * @since 3.0 + * @param aClient reference to client object + * @return A pointer to the created object + */ + IMPORT_C static CATAudioEventAPI* NewL(MATEventCompleteObserver& aClient); + + /** + * Two-phased constructor. Leaves pointer to object to cleanup stack. + * @since 3.0 + * @param aClient reference to client object + * @return A pointer to the created object + */ + IMPORT_C static CATAudioEventAPI* NewLC(MATEventCompleteObserver& aClient); + + /** + * Destructor + */ + ~CATAudioEventAPI(); + + /** + * Send event to the server. UI Settings uses demoplay as true, so + * that server will play "profile" events as well. + * @since 3.0 + * @param aEvent event number + * aDemoPlay ETrue if called from UI settings application, EFalse from observer + * and keysoundserver + */ + virtual void SendAudioEventL(TAudioThemeEvent aEvent, TBool aDemoPlay); + + /** + * Stop playing of earlier sent playing request. + * @since 3.0 + * @param aEvent event number + */ + virtual void StopAudio(TAudioThemeEvent aEvent); + + /** + * This methods is called by message helper when sent messages completes. + * Client will be called for completion in this method as well. + * @since 3.0 + * @param aError error code + * @param aHelper messagehelper that received completion from the server. + */ + void MessageComplete(TInt aError, CATMessageHelper* aHelper); + +private: + + /** + * C++ default constructor. + * @since 3.0 + * @param aClient reference to client object + */ + CATAudioEventAPI(MATEventCompleteObserver& aClient); + + /** + * Symbian 2nd phase constructor. + */ + void ConstructL(); + +private: // Data + + // Session to AT sound server + RATSoundServerSession* iSession; // Owned + + // Reference to client + MATEventCompleteObserver& iClient; + + // Array for message helpers + RPointerArray iMessageHelperArray; + + }; + + +#endif // __ATAUDIOEVENTAPI_H__ + +// End of File