--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mmappfw_plat/mpx_playback_common_definition_api/inc/mpxplaybackobserver.h	Thu Dec 17 08:55:47 2009 +0200
@@ -0,0 +1,135 @@
+/*
+* 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:  Playback observer
+*
+*/
+
+ 
+
+#ifndef MMPXPLAYBACKOBSERVER_H
+#define MMPXPLAYBACKOBSERVER_H
+
+#include <bamdesca.h>
+#include <mpxmessage2.h>
+#include <mpxcommand.h>
+#include<mpxplaybackframeworkdefs.h>
+
+class TMPXPlaybackMessage;
+class CMPXMedia;
+
+/**
+*  Interface for receiving events.
+*
+*  @lib mpxcommon.lib
+*/ 
+NONSHARABLE_CLASS(MMPXPlaybackObserver)
+    {
+public: 
+    /**  
+     *  Handle playback message.
+     *
+     *  @since S60 3.2.3
+     *  @param aMsg playback message
+     *  @deprecated Use method MMPXPlaybackObserver::HandlePlaybackMessage
+     *       (CMPXMessage* aMsg, TInt aErr) instead. 
+     *        Because if system error happens, e.g. KErrNoMemory, aMsg object
+     *        can not be created. 
+     *  NOTE: only one of HandlePlaybackMessage callback can be implemented.
+     */
+    virtual void HandlePlaybackMessage(const CMPXMessage& /*aMsg*/)
+         {
+         }
+    
+    /**
+    *  Handle playback message.
+    *  Note: only one of HandlePlaybackMessage callback can be implemented.
+    *  Note: change into pure virtual when all clients updated.
+    *
+    *  @since S60 3.2.3
+    *  @param aMsg playback message, ownership not transferred. 
+    *         Please check aMsg is not NULL before using it. If aErr is not 
+    *         KErrNone, plugin might still call back with more info in the aMsg.
+    *  @param aErr system error code.
+    */
+    virtual void HandlePlaybackMessage(CMPXMessage* aMsg, TInt /*aErr*/)
+        {// Note: change into pure virtual when all clients updated.
+        // Temp solution, aMsg will be a dummy object if aErr.
+        
+        // TO BE REMOVED when above HandlePlaybackMessage is removed.
+        HandlePlaybackMessage(*aMsg);
+        }
+    };
+
+/**
+*  Interface for receiving property values asynchronously.
+*
+*  @lib mpxcommon.lib
+*/
+NONSHARABLE_CLASS(MMPXPlaybackCallback)
+    {
+public:
+
+    /**
+    *  Handle playback property.
+    *
+    *  @since S60 3.2.3
+    *  @param aProperty the property
+    *  @param aValue the value of the property
+    *  @param aError error code
+    */
+    virtual void HandlePropertyL(TMPXPlaybackProperty aProperty,
+                                 TInt aValue, 
+                                 TInt aError) = 0;
+    
+    /**
+    *  Method is called continously until aComplete=ETrue, signifying that 
+    *  it is done and there will be no more callbacks.
+    *  Only new items are passed each time.
+    *
+    *  @since S60 3.2.3
+    *  @param aPlayer UID of the subplayer
+    *  @param aSubPlayers a list of sub players
+    *  @param aComplete ETrue no more sub players. EFalse more subplayer
+    *                   expected
+    *  @param aError error code
+    */
+    virtual void HandleSubPlayerNamesL(TUid aPlayer, 
+                                       const MDesCArray* aSubPlayers,
+                                       TBool aComplete,
+                                       TInt aError) = 0;
+    
+    /**
+    *  Call back of media request.
+    *
+    *  @since S60 3.2.3
+    *  @param aMedia media 
+    *  @param aError error code    
+    */
+    virtual void HandleMediaL(const CMPXMedia& aProperties,
+                              TInt aError) = 0;
+    
+    /**
+     *  Handle completion of a asynchronous command.
+     *  Note: All clients should implement this callback.
+     *
+     *  @since S60 3.2.3
+     *  @param aCommandResult result of the command, NULL if error
+     *  @param aError error code    
+     */
+    virtual void HandlePlaybackCommandComplete(CMPXCommand* /*aCommandResult*/, 
+                                               TInt /*aError*/) {}
+    
+    };
+    
+#endif // MMPXPLAYBACKOBSERVER_H