// Copyright (c) 2005-2009 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:

// Part of the MVS Agents for TechView

//

#include "audioplayagent.h"

#include <e32def.h>

#include <flogger.h>

/**

Constructs and initialises a new instance of the MVS audio player utility.

The function leaves if the MVS audio player utility object cannot be created.

No callback notification is made upon completion of NewL().

@param  aObserver

		Class to receive state change events from play agent.

@return     A pointer to the new MVS audio player utility object.

*/

EXPORT_C CMVSAudioPlayAgent* CMVSAudioPlayAgent::NewL(MMVSClientObserver& aObserver)

     {

     CMVSAudioPlayAgent* self = new(ELeave) CMVSAudioPlayAgent(aObserver);

     CleanupStack::PushL(self);

     self->ConstructL();

     CleanupStack::Pop(self);

     return self;

     }

void CMVSAudioPlayAgent::ConstructL()

     {

     iPlayer = CMdaAudioPlayerUtility::NewL(*this);

     User::LeaveIfError(iFileLogger.Connect());

     iFileLogger.CreateLog(_L("LogMVSappUi"),_L("LogFile.txt"),EFileLoggingModeAppend);

     }

EXPORT_C CMVSAudioPlayAgent::~CMVSAudioPlayAgent()

     {

     delete iPlayer;

     if(iFileLogger.Handle())

     	{

     	iFileLogger.CloseLog();

	 	iFileLogger.Close();

     	}

     }

CMVSAudioPlayAgent::CMVSAudioPlayAgent(MMVSClientObserver& aObserver):iObserver(aObserver)

     {

     iObserver.UpdateStateChange(ENotReady, KErrNone);

     }

EXPORT_C void CMVSAudioPlayAgent::OpenFileL(TDesC& aFile)

     {

     iPlayer->Close();//Close any existing clip

     iState = EAudioOpening;

     iObserver.UpdateStateChange(EAudioOpening, KErrNone);

     iPlayer->OpenFileL(aFile);

     }

EXPORT_C void CMVSAudioPlayAgent::OpenFileL(TMMSource& /*aSource*/)

     {

     }

/**

Begins playback of the initialised audio sample at the current volume

and priority levels.

Sets the current state of the system to EAudioPlaying

When playing of the audio sample is complete, successfully or

otherwise, the callback function

CMVSAudioPlayAgent::MapcPlayComplete() is called, which inturn

sets the state to EAudioOpened. 

*/

EXPORT_C void CMVSAudioPlayAgent::Play()

     {

     //must be in open or paused states 

     if((iState == EAudioOpened)||(iState == EAudioPaused)||(iState == EAudioStopped))

     	{

     	iPlayer->Play();

     	iState = EAudioPlaying;

     	iObserver.UpdateStateChange(EAudioPlaying, KErrNone);	

     	}

     }

/**

Pauses the playback of the audio clip.

and updates the current state to EAudioPaused.

*/

EXPORT_C TInt CMVSAudioPlayAgent::Pause()

     {

     if(iState == EAudioPlaying)

     	{

     	TInt err = iPlayer->Pause();

     	if ( err != KErrNone)

     		{

     		return err;

     		}

     	iState = EAudioPaused;

     	iObserver.UpdateStateChange(EAudioPaused, KErrNone);

     	}

     return KErrNone;	

     }

/**

Stops playback of the audio sample as soon as possible.

Sets the current state to EAudioStopped

If the audio sample is playing, playback is stopped as soon as

possible. If playback is already complete, nothing further happens as

a result of calling this function.  

*/

EXPORT_C void CMVSAudioPlayAgent::Stop()

	{

    if(iState == EAudioPlaying || iState == EAudioPaused)

    	{

     	iPlayer->Stop();

     	iState = EAudioStopped;

     	iObserver.UpdateStateChange(iState, KErrNone);	

     	}

    }     

/**

Added for future implimentation. Currently not supported

*/

EXPORT_C void CMVSAudioPlayAgent::Forward()

    {

    // future implementation	

    }  

/**

Added for future implimentation. Currently not supported

*/

EXPORT_C void CMVSAudioPlayAgent::Rewind()

    {

    // future implementation

    }  

/*

Initialisation completion callback for the MVS play agent

*/

void CMVSAudioPlayAgent::MapcInitComplete(TInt aError, const TTimeIntervalMicroSeconds& /*aDuration*/)

    {

    if(aError == KErrNone)

    	{

    	iState = EAudioOpened;

     	iFileLogger.Write(_L("Audio Opened ")) ;

       	}

    else

     	{

     	iState = ENotReady; //init failed so from opening to NotReady

     	iFileLogger.Write(_L("MapcInitComplete: Audio Not Ready")) ;

     	}

    iObserver.UpdateStateChange(iState, aError);

    }

/*

Play back completion callback for the MVS play agent

*/

void CMVSAudioPlayAgent::MapcPlayComplete(TInt aError)

	{

	if(aError == KErrNone)

		{

		iState = EAudioOpened;

		iFileLogger.Write(_L("MapcPlayComplete:Audio Opened Play Complete")) ;

		}

	iObserver.UpdateStateChange(iState, aError);

	}

void CMVSAudioPlayAgent::MarncResourceAvailable(TUid /*aNotificationEventId*/, const TDesC8& /*aNotificationData*/)

	{

	}

/**

Returns the current playback volume

@param aVolume

       A volume value between 0 and the value returned by MaxVolume().

@return One of the global error codes.

*/

EXPORT_C TInt CMVSAudioPlayAgent::GetVolume(TInt& aVolume) 

    {

    return iPlayer->GetVolume(aVolume);

    }

/**

Returns an integer representing the maximum volume.

This is the maximum value which can be passed to

CMdaAudioPlayerUtility::SetVolume(). This value is platform 

independent, but is always greater than or equal to one.

The function raises a CMdaAudioPlayerUtility 1 panic if the 

audio player utility is not initialised.

@return The maximum volume setting.

*/

EXPORT_C TInt CMVSAudioPlayAgent::MaxVolume() 

    {

    return iPlayer->MaxVolume();

    }

/**

Returns the duration of the audio sample.

The function raises a CMdaAudioPlayerUtility 1 panic if the audio

player utility is not initialised.

@return The duration in microseconds.

*/  

EXPORT_C TTimeIntervalMicroSeconds CMVSAudioPlayAgent::Duration() 

    {

    return iPlayer->Duration();

    }

/**

Changes the current playback volume to a specified value.

The volume can be changed before or during playback and is effective

immediately. The volume can be set to any value between zero (mute) and 

the maximum permissible volume (determined using MaxVolume()).Also the 

period over which the volume level is to rise smoothly from nothing to

the normal volume level,is given by the ramp up time.

The function raises a CMdaAudioPlayerUtility 1 panic if

the audio player utility is not initialised.

@param  aVolume

        The volume setting. This can be any value from zero to

        the value returned by a call to

        CMVSAudioPlayAgent::MaxVolume().

        Setting a zero value mutes the sound. Setting the

        maximum value results in the loudest possible sound.

@param  aRampDuration

        The period over which the volume is to rise. A zero

        value causes the audio sample to be played at the

        normal level for the full duration of the playback. A

        value which is longer than the duration of the audio

        sample means that the sample never reaches its normal

        volume level.

*/

EXPORT_C void CMVSAudioPlayAgent::SetVolume(TInt aVolume, TTimeIntervalMicroSeconds aRamp)

    {

    iPlayer->SetVolume(aVolume);

    iPlayer->SetVolumeRamp(aRamp);

    }

/**

Returns the current playback position in microseconds from the start of the clip.

@param   aPosition

         The current time position in microseconds from the start of the clip to the current

         play position.

@return the current playback position in microseconds.

*/    

EXPORT_C TTimeIntervalMicroSeconds CMVSAudioPlayAgent::GetPosition(TTimeIntervalMicroSeconds& aPosition) 

    {

    return iPlayer->GetPosition(aPosition);

    }

/**

Sets the current playback position in microseconds from the start of the clip.

@param  aPosition

        The position to move to in microseconds from the start of the clip.

*/

EXPORT_C void CMVSAudioPlayAgent::SetPosition(TTimeIntervalMicroSeconds aPosition)

    {

    iPlayer->SetPosition(aPosition);

    }

/**

Returns the current playback balance.

@param  aBalance

        A value between KMMFBalanceMaxLeft

        and KMMFBalanceMaxRight.

@return An error code indicating if the function call was successful. KErrNone on success, otherwise

        another of the system-wide error codes.

*/

EXPORT_C TInt CMVSAudioPlayAgent::GetBalance(TInt& aBalance) 

    {

    return iPlayer->GetBalance(aBalance);

    }

/**

Sets the current playback balance.

@param  aBalance

        A value between KMMFBalanceMaxLeft

        and KMMFBalanceMaxRight. The default value is

        KMMFBalanceCenter.

@return "TInt" An error code indicating if the function call was successful. KErrNone on success, otherwise

        another of the system-wide error codes.

*/

EXPORT_C TInt CMVSAudioPlayAgent::SetBalance(TInt aBalance)

    {

    return iPlayer->SetBalance(aBalance);

    }

/**

Sets the number of times the audio sample is to be repeated during the

playback operation.

A period of silence can follow each playing of the sample. The audio

sample can be repeated indefinitely.

@param  aNoRepeats

        The number of times the audio sample, together with

        the trailing silence, is to be repeated. If this is

        set to KMdaRepeatForever, then the audio

        sample, together with the trailing silence, is

        repeated indefinitely or until Stop() is

        called. If this is set to zero, then the audio sample

        is not repeated.

@param  aDelay

        The time interval of the training silence.

*/

EXPORT_C void CMVSAudioPlayAgent::SetRepeats(TInt aNoRepeats, TTimeIntervalMicroSeconds aDelay)

    {

    iPlayer->SetRepeats(aNoRepeats, aDelay);

    }

/**

Set the current playback window

@param	aStart

		Start time of playback window relative to start of file

@param	aEnd

		End time of playback window relative to start of file

@return "TInt" One of the global error codes

*/

EXPORT_C TInt CMVSAudioPlayAgent::SetPlayWindow(TTimeIntervalMicroSeconds aStart, TTimeIntervalMicroSeconds aEnd)

    {

    return iPlayer->SetPlayWindow(aStart,aEnd);

    }

/**

Clear the current playback window

@return "TInt" One of the global error codes

*/   

EXPORT_C TInt CMVSAudioPlayAgent::ClearPlayWindow()

    {

    return iPlayer->ClearPlayWindow();

    }     

/**

Sets the priority for playback. This is used to arbitrate between multiple

objects trying to access a single sound device.

@param  aPriority

        The priority level to apply, EMdaPriorityMin client can be interrupted by any

        other client, EMdaPriorityNormal client can only be interrupted by a client 

        with a higher priority or EMdaPriorityMax client cannot be interrupted by other 

        clients.

@param  aPreference

        The quality/time preferences to apply.

@return An error code indicating if the function call was successful. KErrNone on success, otherwise

        another of the system-wide error codes.

*/

EXPORT_C TInt CMVSAudioPlayAgent::SetPriority(TInt aPriority, TMdaPriorityPreference aPreference)

    {

    return iPlayer->SetPriority(aPriority,aPreference);

    }

/**

Closes the current audio clip (allowing another clip to be opened)

Sets the current state to ENotReady

*/  

EXPORT_C void CMVSAudioPlayAgent::Reset()

    {

    iPlayer->Close();

    iState = ENotReady;

    iObserver.UpdateStateChange(ENotReady, KErrNone);

    }

EXPORT_C void CMVSAudioPlayAgent::SetAutoPauseResume(TBool /*aEnable*/)

    {

    }

/**

Returns an array containing the MetaDataEntry for the given audio clip

@param  aMetaArray

        The meta data Array

@leave	Leaves with KErrNotFound if the meta data entry does not exist or

		KErrNotSupported if the controller does not support meta data 

		information for this format. Other errors indicate more general system

		failure.

*/

EXPORT_C void CMVSAudioPlayAgent::GetMetaArrayL(RPointerArray<CMMFMetaDataEntry>& aMetaArray)

	{

	//Reset the meta array

    aMetaArray.Reset();

	//Find how many elements there are to obtain

	TInt noMetaEntries = 0;

    TInt err = iPlayer->GetNumberOfMetaDataEntries(noMetaEntries);

    if(err == KErrNone)

	    {

	    //Add the elements, one at a time.

	    for(TInt counter = 0; counter < noMetaEntries; ++counter)

	         {

	         aMetaArray.Append(iPlayer->GetMetaDataEntryL(counter));

	         }	

	    }

	User::LeaveIfError(err);	

	}

/**

Returns the bit rate of the audio clip.

@param  aBitRate

        Bit rate of the audio clip.

@return One of the global error codes.

*/

EXPORT_C TInt CMVSAudioPlayAgent::GetBitRate(TUint& aBitRate)

	{

	return iPlayer->GetBitRate(aBitRate);

	}

/**

Returns the controller implementation information associated with the current controller.

@return The controller implementation structure

*/

EXPORT_C const CMMFControllerImplementationInformation& CMVSAudioPlayAgent::GetControllerInfoL()

	{

	return iPlayer->ControllerImplementationInformationL();	

	}

/**

Returns the current state of the CMVSAudioPlayAgent.

@return The current state, iState.

*/

EXPORT_C TMVSState CMVSAudioPlayAgent::GetState()

	{

	return iState;	

	}