--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/mmserv/radioutility/radio_utility/src/RadioPlayerUtilityBody.h Tue Feb 02 01:08:46 2010 +0200
@@ -0,0 +1,200 @@
+/*
+* Copyright (c) 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: Implementation header of the Radio Player Utility API
+*
+*
+*/
+
+
+#ifndef C_RADIOPLAYERUTILITYBODY_H
+#define C_RADIOPLAYERUTILITYBODY_H
+
+#include <RadioPlayerUtility.h>
+#include <mcustominterface.h>
+
+class RRadioSession;
+
+/**
+ * This class encapsulates the implementation body of CRadioPlayerUtility interface.
+ *
+ * @lib Radio_Utility.lib
+ * @since S60 3.2
+ */
+class CRadioPlayerUtility::CBody : public CBase,
+ public MCustomInterface
+ {
+
+public:
+
+ static CBody* NewL( RRadioSession& aRadioSession, MRadioPlayerObserver& aObserver );
+
+ ~CBody();
+
+ /**
+ * Retrieve the current state of the player.
+ * If the radio is already playing, client should simply retrieve current settings such
+ * as volume, etc.
+ *
+ * @since S60 3.2
+ * @return Radio player state.
+ */
+ void PlayerState( TPlayerState& aPlayerState ) const;
+
+ /**
+ * Close the radio player and free all memory allocated. Any ongoing playing activity will
+ * be stopped if no other clients need it.
+ *
+ * @since S60 3.2
+ */
+ void Close();
+
+ /**
+ * Asynchronous request to start playing the radio.
+ *
+ * User must be ready to receive callback method MrpoStateChange.
+ * If radio plays successfully, the user will receive callback method MrpoStateChange with
+ * ERadioPlayerPlaying and KErrNone. If a problem is encountered, user will receive
+ * callback MrpoStateChange with ERadioPlayerIdle with an error code.
+ *
+ * @since S60 3.2
+ * @see MRadioPlayerObserver::MrpoStateChange
+ */
+ void Play();
+
+ /**
+ * Asynchronous request to stop the radio.
+ *
+ * This will stop radio for all client applications playing the radio. If the application
+ * wishes to terminate without disrupting the radio playback (in case of multiple
+ * active applications running), the application should terminate without issuing Stop.
+ * User must be ready to receive callback method MrpoStateChange.
+ *
+ * @since S60 3.2
+ * @see MRadioPlayerObserver::MrpoStateChange
+ */
+ void Stop();
+
+ /**
+ * Get the maximum volume supported by the device. Volume range from 0 to max.
+ * Setting volume to zero will mute the speakers.
+ *
+ * @since S60 3.2
+ * @param aMaxVolume On return contains the maximum volume supported.
+ * @return A standard system error code.
+ */
+ TInt GetMaxVolume( TInt& aMaxVolume ) const;
+
+ /**
+ * Set the volume to the specified level. This can be any value from zero to max returned
+ * by GetMaxVolume.
+ *
+ * @since S60 3.2
+ * @param aVolume The volume level to set.
+ * @return A standard system error code.
+ */
+ TInt SetVolume( TInt aVolume );
+
+ /**
+ * Get the current volume.
+ *
+ * @since S60 3.2
+ * @param aVolume On return contains the current volume.
+ * @return A standard system error code.
+ */
+ TInt GetVolume( TInt& aVolume ) const;
+
+ /**
+ * Set a volume ramp. Must be called before Play.
+ * @param aRampInterval
+ * The time interval over which the volume should be increased from zero to
+ * the current volume setting.
+ *
+ * @since S60 3.2
+ * @return A standard system error code.
+ */
+ TInt SetVolumeRamp( const TTimeIntervalMicroSeconds& aRampInterval );
+
+ /**
+ * Mutes or unmutes radio playback.
+ *
+ * @param aMute ETrue to mute the audio, EFalse to unmute it.
+ * @since S60 3.2
+ * @return A standard system error code.
+ */
+ TInt Mute( TBool aMute );
+
+ /**
+ * Find out if the audio is muted or not.
+ *
+ * @since S60 3.2
+ * @return ETrue if audio is muted.
+ */
+ TBool IsMute();
+
+ /**
+ * Set the speaker balance for playing.
+ *
+ * @since S60 3.2
+ * @param aLeftPercentage
+ * Left speaker volume percentage. This can be any value from zero to 100.
+ * Setting a zero value mutes the sound on left speaker.
+ * @param aRightPercentage
+ * Right speaker volume percentage. This can be any value from zero to 100.
+ * Setting a zero value mutes the sound on right speaker.
+ * @return A standard system error code.
+ */
+ TInt SetBalance( TInt aLeftPercentage, TInt aRightPercentage );
+
+ /**
+ * Get the speaker balance set for playing.
+ *
+ * @since S60 3.2
+ * @param aLeftPercentage
+ * On return contains left speaker volume perecentage. This can be any value
+ * from zero to 100. Zero value means left speaker is muted.
+ * @param aRightPercentage
+ * On return contains right speaker volume perecentage. This can be any value
+ * from zero to 100. Zero value means right speaker is muted.
+ * @return A standard system error code.
+ */
+ TInt GetBalance( TInt& aLeftPercentage, TInt& aRightPercentage ) const;
+
+ /**
+ * Retrieves a custom interface to the device. (Used by Audio Enhancement)
+ *
+ * @since S60 3.2
+ * @param aInterfaceId The interface UID, defined with the custom interface.
+ * @return A pointer to the interface implementation, or NULL if the device does not
+ * implement the interface requested. The return value must be cast to the correct
+ * type by the user.
+ */
+ TAny* CustomInterface( TUid InterfaceId );
+
+
+private:
+
+ void ConstructL();
+ CBody();
+
+private: // data
+
+ // The radio server session
+ RRadioSession* iRadioSession; // not own
+ // Player utility observer
+ MRadioPlayerObserver* iRadioPlayerUtilityClient; // not own
+ };
+
+#endif // C_RADIOPLAYERUTILITY_H
+
+// End of File