/*

* 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 "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 interface acts as a high level wrapper around the media server

*     playback and recording functionalities. It is inherited by both 

*	  CVRMdaRecorder

*

*/

#ifndef __MVRMDARECORDER_H__

#define __MVRMDARECORDER_H__

// FORWARD DECLARATIONS

class CVRMemo;

class MVRObserver;

// CLASS DEFINITION

/**

* This class acts as a high level wrapper around the media server

* playback and recording functionalities.

*/

class MVRMdaRecorder 

{

	public: // new methods

		/**

		* Registers an observer for receiving update notifications.

		* @param aObserver The observer object.

		*/

		virtual void RegisterObserver( MVRObserver* aObserver ) = 0;

		/**

		* Unregisters a previously registered observer

		* @param aObserver The observer object.

		*/		

		virtual void UnregisterObserver( MVRObserver* aObserver ) = 0;

		/**

		* Registers an observer for receiving auto stop notifications.

		* @param aObserver The observer object.

		*/

		virtual void SetAutoStopObserver( MVRObserver* aObserver ) = 0;

		/**

		* Attachs this recorder to a memo file, i.e. opens it

		* and initialises media server.

		* @param aMemo Specifies the file to be attached to.

		*/

		virtual void AttachToMemoL( CVRMemo* aMemo ) = 0;

		/**

		* Creates a new memo file and attachs to it.

		* @param aMemo Specifies the file to be created.

		*/

		virtual void CreateNewMemoL( CVRMemo* aMemo ) = 0;

		/**

		* Detachs from the current memo, i.e. closes the file.

		*/

		virtual void DetachMemo() = 0;

		/**

		* Sets playback volume.

		* @param aStep Volume level in steps

		* @param aMaxSteps How many steps there are (10 usually).

		*/

		virtual void SetVolume( TInt aStep, TInt aMaxSteps )= 0;

		/**

		* Starts playback.

		* @return System wide error code

		*/

		virtual TInt PlayL() = 0;

		/**

		* Starts recording.

		* @return System wide error code

		*/

		virtual TInt RecordL() = 0;

		/**

		* Stops playback or recording.

		*/

		virtual void Stop() = 0;

		/**

		* Pauses playback or recording.

		*/

		virtual void Pause() = 0;

		/**

		* Moves the playing position forward 5 seconds.

		* @return System wide error code. KErrOverflow if the

		* position was forwarded past the end.

		*/

		virtual TInt ForwardL() = 0;

		/**

		* Moves the playing position backward 5 seconds.

		* @return System wide error code

		*/

		virtual TInt RewindL() = 0;

		/**

		* Indicates if we are in a state that can accept

		* more commands (i.e. all async calls have completed).

		* @return ETrue if it's ok to proceed calling methods.

		*/

		virtual TBool CanAcceptCommands() const = 0;

		/**

		* Set active speaker if feature is supported

		* @param aEnabled ETrue if playback should be routed to IHF

		* @return Error code returned by routing operation

		*/

		virtual TInt SetIhf( TBool aEnabled ) = 0;

		/**

		* Set the audio recorder position to a new value

		* @param aSeconds The position to set

		*/

		virtual void SetPositionL( TInt aSeconds ) = 0;

		virtual ~MVRMdaRecorder() {};

	};

#endif // __MVRMDARECORDER_H__