mmlibs/mmfw/tsrc/mmvalidationsuite/mmvalidationsuiteagents/src/audioplayagent.cpp
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 12 Mar 2010 15:50:33 +0200
branchRCL_3
changeset 7 94dbab0a2133
parent 0 40261b775718
permissions -rw-r--r--
Revision: 201007 Kit: 201008

// 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;	
	}