--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/voicerecorder/RecViewSrc/CVRTonePlayer.h Thu Dec 17 08:46:57 2009 +0200
@@ -0,0 +1,144 @@
+/*
+* Copyright (c) 2005-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: Class that handles playback of tones in Voice Recorder application
+*
+*/
+
+
+#ifndef CVRTONEPLAYER_H
+#define CVRTONEPLAYER_H
+
+// INCLUDES
+#include <mdaaudiotoneplayer.h>
+
+// FORWARD DECLARATIONS
+class CAknKeySoundSystem;
+class CAknSoundInfo;
+
+/**
+ * Class that handles playback of tones in Voice Recorder application
+ *
+ * @lib VoiceRecorderRecView.lib
+ * @since S60 v3.0
+ */
+NONSHARABLE_CLASS( CVRTonePlayer )
+ : public CBase, public MMdaAudioToneObserver
+ {
+
+private:
+ enum TVRTonePlayerState
+ {
+ EVRToneIdle,
+ EVRTonePreparing,
+ EVRTonePlaying
+ };
+
+public:
+
+ static CVRTonePlayer* NewL();
+ virtual ~CVRTonePlayer();
+
+ /**
+ * Prepares a tone for playback. This does not guarantee
+ * that preparing is ready after completion.
+ *
+ * @since S60 v3.0
+ * @param aToneId Predefined id of the tone to be prepared
+ */
+ void PrepareToneL( TInt aToneId );
+
+ /**
+ * Non-leaving method that calls PrepareToneL and ignores all leaves
+ *
+ * @since S60 v3.0
+ * @param aToneId Predefined id of the tone to be prepared
+ */
+ void PrepareTone( TInt aToneId );
+
+ /**
+ * Starts playback of tone. Playback starts immediately if the tone
+ * specified has been already been prepared. Otherwise the tone
+ * is first prepared.
+ *
+ * @since S60 v3.0
+ * @param aToneId Predefined id of the tone to be played
+ */
+ void PlayTone( TInt aToneId );
+
+// from base class MMdaAudioToneObserver
+
+ /**
+ * From MMdaAudioToneObserver.
+ * Defines required client behaviour when an attempt to configure the
+ * audio tone player utility has completed, successfully or otherwise.
+ *
+ * @param aError KErrNone if successful. One of the system
+ * wide error codes if the attempt failed. The possible
+ * values depend on the EPOC platform.
+ */
+ void MatoPrepareComplete(TInt aError);
+
+ /**
+ * From MMdaAudioToneObserver.
+ * Defines required client behaviour when the tone playing operation has
+ * completed, successfully or otherwise.
+ *
+ * @param aError KErrNone if successful. One of the system
+ * wide error codes if the attempt failed. The possible
+ * values depend on the EPOC platform.
+ */
+ void MatoPlayComplete(TInt aError);
+
+private:
+
+ CVRTonePlayer();
+ void ConstructL();
+
+private: // data
+
+ /**
+ * Instance of the player class.
+ * Own.
+ */
+ CMdaAudioToneUtility* iPlayer;
+
+ /**
+ * Pointer to sound system utility that retrieves the sound data.
+ * Not owned.
+ */
+ CAknKeySoundSystem* iSoundSystem;
+
+ /**
+ * The id of the tone that is currently prepared
+ */
+ TInt iPreparedTone;
+
+ /**
+ * The id of the tone that is in queue
+ */
+ TInt iQueuedTone;
+
+ /**
+ * Is a tone currently in preparation
+ */
+ TVRTonePlayerState iState;
+
+ /**
+ * Used for waiting tone play comlete until continuing
+ */
+ CActiveSchedulerWait iShedulerWait;
+
+ };
+
+#endif // CVRTONEPLAYER_H