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

//

#include <mmf/server/sounddevice.h>

#include "SoundDeviceBody.h"

/*

 *

 *	Default Constructor.

 *

 *

 */

CMMFDevSound::CMMFDevSound()

	{

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Destructor.

 *

 *	Deletes all objects and releases all resource owned by this

 *	instance.

 *

 */

EXPORT_C CMMFDevSound::~CMMFDevSound()

	{

	delete iBody;

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Constructs, and returns a pointer to, a new CMMFDevSound object.

 *

 *	Leaves on failure.

 *

 */

EXPORT_C CMMFDevSound* CMMFDevSound::NewL()

	{

	CMMFDevSound* self = new (ELeave) CMMFDevSound;

	CleanupStack::PushL(self);

	self->ConstructL();

	CleanupStack::Pop();

	return self;

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Second phase constructor.

 *

 */

void CMMFDevSound::ConstructL()

	{

	iBody = CBody::NewL();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Initializes CMMFDevSound object to play and record PCM16 raw audio data

 *	with sampling rate of 8 KHz.

 *

 *	On completion of Initialization, calls InitializeComplete() on

 *	aDevSoundObserver.

 *

 *	Leaves on failure.

 *

 *	@param	"aDevSoundObserver"

 *			A reference to DevSound Observer instance.

 *

 *	@param	"aMode"

 *			Mode for which this object will be used.

 *

 */

EXPORT_C void CMMFDevSound::InitializeL(MDevSoundObserver& aDevSoundObserver, TMMFState aMode)

	{

	iBody->InitializeL(aDevSoundObserver,aMode);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Initializes DevSound object for the mode aMode for processing audio data

 *	with hardware device aHWDev.

 *

 *	On completion of Initialization, the observer will be notified via call back

 *	InitializeComplete().

 *

 *	Leaves on failure.

 *

 *	@param	"aDevSoundObserver"

 *			A reference to DevSound Observer instance.

 *

 *	@param	"aHWDev"

 *			CMMFHwDevice implementation identifier.

 *

 *	@param	"aMode"

 *			Mode for which this object will be used.

 *

 */

EXPORT_C void CMMFDevSound::InitializeL(MDevSoundObserver& aDevSoundObserver, TUid aHWDev, TMMFState aMode)

	{

	iBody->InitializeL(aDevSoundObserver, aHWDev, aMode);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Initializes DevSound object for the mode aMode for processing audio data

 *	with hardware device supporting FourCC aDesiredFourCC.

 *

 *	On completion of Initialization, the observer will be notified via call back

 *	InitializeComplete().

 *

 *	Leaves on failure.

 *

 *	@param	"aDevSoundObserver"

 *			A reference to DevSound Observer instance.

 *

 *	@param	"aDesiredFourCC"

 *			CMMFHwDevice implementation FourCC.

 *

 *	@param	"aMode"

 *			Mode for which this object will be used.

 *

 */

EXPORT_C void CMMFDevSound::InitializeL(MDevSoundObserver& aDevSoundObserver, 

										  TFourCC aDesiredFourCC, TMMFState aMode)

	{

	iBody->InitializeL(aDevSoundObserver, aDesiredFourCC, aMode);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns the supported Audio settings.

 *

 *	@return	"TMMFCapabilities"

 *			Device settings.

 *

 */

EXPORT_C TMMFCapabilities CMMFDevSound::Capabilities()

	{

	return iBody->Capabilities();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns the current audio settings.

 *

 *	@return	"TMMFCapabilities"

 *			Device settings.

 *

 */

EXPORT_C TMMFCapabilities CMMFDevSound::Config() const

	{

	return iBody->Config();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Configure CMMFDevSound object for the settings in aConfig.

 *

 *	Use this to set sampling rate, Encoding and Mono/Stereo.

 *

 *	@param	"aConfig"

 *			Attribute values to which CMMFDevSound object will be configured to.

 *

 */

EXPORT_C void CMMFDevSound::SetConfigL(const TMMFCapabilities& aConfig)

	{

	iBody->SetConfigL(aConfig);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns an integer representing the maximum volume.

 *

 *	This is the maximum value which can be passed to CMMFDevSound::SetVolume.

 *

 *	@return	"TInt"

 *			The maximum volume. This value is platform dependent but is always

 *			greater than or equal to one.

 *

 */

EXPORT_C TInt CMMFDevSound::MaxVolume()

	{

	return iBody->MaxVolume();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns an integer representing the current volume.

 *

 *	@return	"TInt"

 *			The current volume level.

 *

 */

EXPORT_C TInt CMMFDevSound::Volume()

	{

	return iBody->Volume();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Changes the current playback volume to a specified value.

 *

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

 *	immediately.

 *

 *	@param	"aVolume"

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

 *			returned by a call to CMMFDevSound::MaxVolume(). If the

 *			volume is not within this range, the volume is automatically set to

 *			minimum or maximum value based on the value that is being passed.

 *			Setting a zero value mutes the sound. Setting the maximum value

 *			results in the loudest possible sound.

 *

 */

EXPORT_C void CMMFDevSound::SetVolume(TInt aVolume)

	{

	iBody->SetVolume(aVolume);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns an integer representing the maximum gain.

 *

 *	This is the maximum value which can be passed to CMMFDevSound::SetGain.

 *

 *	@return	"TInt"

 *			The maximum gain. This value is platform dependent but is always

 *			greater than or equal to one.

 *

 */

EXPORT_C TInt CMMFDevSound::MaxGain()

	{

	return iBody->MaxGain();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns an integer representing the current gain.

 *

 *	@return	"TInt"

 *			The current gain level.

 *

 */

EXPORT_C TInt CMMFDevSound::Gain()

	{

	return iBody->Gain();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Changes the current recording gain to a specified value.

 *

 *	The gain can be changed before or during recording and is effective

 *	immediately.

 *

 *	@param	"TInt aGain"

 *			The gain setting. This can be any value from zero to the value

 *			returned by a call to CMMFDevSound::MaxGain(). If the

 *			volume is not within this range, the gain is automatically set to

 *			minimum or maximum value based on the value that is being passed.

 *			Setting a zero value mutes the sound. Setting the maximum value

 *			results in the loudest possible sound.

 *

 */

EXPORT_C void CMMFDevSound::SetGain(TInt aGain)

	{

	iBody->SetGain(aGain);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns the speaker balance set for playing.

 *

 *	Leaves on failure.

 *

 *	@param	"aLeftPrecentage"

 *			On return contains the left speaker volume percentage.

 *

 *	@param	"aRightPercentage"

 *			On return contains the right speaker volume percentage.

 *

 */

EXPORT_C void CMMFDevSound::GetPlayBalanceL(TInt& aLeftPercentage, TInt& aRightPercentage)

	{

	iBody->GetPlayBalanceL(aLeftPercentage, aRightPercentage);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Sets the speaker balance for playing.

 *

 *	The speaker balance can be changed before or during playback and is

 *	effective immediately.

 *

 *	@param	"aLeftPercentage"

 *			On return contains left speaker volume perecentage. This can be any

 *			value from zero to 100. Setting a zero value mutes the sound on left

 *			speaker.

 *

 *	@param	"aRightPercentage"

 *			On return contains right speaker volume perecentage. This can be any

 *			value from zero to 100. Setting a zero value mutes the sound on

 *			right speaker.

 *

 */

EXPORT_C void CMMFDevSound::SetPlayBalanceL(TInt aLeftPercentage, TInt aRightPercentage)

	{

	iBody->SetPlayBalanceL(aLeftPercentage, aRightPercentage);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns the microphone gain balance set for recording.

 *

 *	Leaves on failure.

 *

 *	@param	"aLeftPercentage"

 *			On return contains the left microphone gain percentage.

 *

 *	@param	"aRightPercentage"

 *			On return contains the right microphone gain percentage.

 *

 */

EXPORT_C void CMMFDevSound::GetRecordBalanceL(TInt& aLeftPercentage, TInt& aRightPercentage)

	{

	iBody->GetRecordBalanceL(aLeftPercentage, aRightPercentage);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Sets the microphone gain balance for recording.

 *

 *	The microphone gain balance can be changed before or during recording and

 *	is effective immediately.

 *

 *	@param	"aLeftPercentage"

 *			Left microphone gain precentage. This can be any value from zero to

 *			100. Setting a zero value mutes the gain on left microphone.

 *

 *	@param	"aRightPercentage"

 *			Right microphone gain precentage. This can be any value from zero to

 *			100. Setting a zero value mutes the gain on right microphone.

 *

 */

EXPORT_C void CMMFDevSound::SetRecordBalanceL(TInt aLeftPercentage, TInt aRightPercentage)

	{

	iBody->SetRecordBalanceL(aLeftPercentage, aRightPercentage);

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Initializes audio device and start play process. This method queries and

 *	acquires the audio policy before initializing audio device. If there was an

 *	error during policy initialization, PlayError() method will be called on

 *	the observer with error code KErrAccessDenied, otherwise BufferToBeFilled()

 *	method will be called with a buffer reference. After reading data into the

 *	buffer reference passed, the client should call PlayData() to play data.

 *

 *	The amount of data that can be played is specified in

 *	CMMFBuffer::RequestSize(). Any data that is read into buffer beyond this

 *	size will be ignored.

 *

 *	Leaves on failure.

 *

 */

EXPORT_C void CMMFDevSound::PlayInitL()

	{

	iBody->PlayInitL();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Initializes audio device and start record process. This method queries and

 *	acquires the audio policy before initializing audio device. If there was an

 *	error during policy initialization, RecordError() method will be called on

 *	the observer with error code KErrAccessDenied, otherwise BufferToBeEmptied()

 *	method will be called with a buffer reference. This buffer contains recorded

 *	or encoded data. After processing data in the buffer reference passed, the

 *	client should call RecordData() to continue recording process.

 *

 *	The amount of data that is available is specified in

 *	CMMFBuffer::RequestSize().

 *

 *	Leaves on failure.

 *

 */

EXPORT_C void CMMFDevSound::RecordInitL()

	{

	iBody->RecordInitL();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Plays data in the buffer at the current volume. The client should fill

 *	the buffer with audio data before calling this method. The Observer gets

 *	reference to buffer along with callback BufferToBeFilled(). When playing of

 *	the audio sample is complete, successfully or otherwise, the method

 *	PlayError() on observer is called.

 *

 */

EXPORT_C void CMMFDevSound::PlayData()

	{

	iBody->PlayData();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Contine the process of recording. Once the buffer is filled with recorded

 *	data, the Observer gets reference to buffer along with callback

 *	BufferToBeEmptied(). After processing the buffer (copying over to a

 *	different buffer or writing to file) the client should call this

 *	method to continue recording process.

 *

 */

EXPORT_C void CMMFDevSound::RecordData()

	{

	iBody->RecordData();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Stops the ongoing operation (Play, Record, TonePlay, Convert)

 *

 */

EXPORT_C void CMMFDevSound::Stop()

	{

	iBody->Stop();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Temporarily Stops the ongoing operation (Play, Record, TonePlay, Convert)

 *

 */

EXPORT_C void CMMFDevSound::Pause()

	{

	iBody->Pause();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns the sample recorded so far.

 *

 *	@return "TInt"

 *			Returns the samples recorded.

 *

 */

EXPORT_C TInt CMMFDevSound::SamplesRecorded()

	{ 

	return iBody->SamplesRecorded();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Returns the sample played so far.

 *

 *	@return "TInt"

 *			Returns the samples recorded.

 *

 */

EXPORT_C TInt CMMFDevSound::SamplesPlayed()

	{ 

	return iBody->SamplesPlayed();

	}

/*

 *  -doxygen comments moved to header-

 *

 *	Initializes audio device and start playing tone. Tone is played with

 *	frequency and for duration specified.

 *

 *	Leaves on failure.

 *

 *	@param	"aFrequency"

 *			Frequency at with the tone will be played.

 *

 *	@param	"aDuration"

 *			The period over which the tone will be played. A zero value causes

 *			the no tone to be played (Verify this with test app).

 *

 */

EXPORT_C void CMMFDevSound::PlayToneL(TInt aFrequency, const TTimeIntervalMicroSeconds& aDuration)

	{

	iBody->PlayToneL(aFrequency, aDuration);

	}

/*

 *  -doxygen comments moved to header-