/*

* Copyright (c) 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:  CMpxVideoPlayerAppUiEngine

 *

*/

// Version : %version:  4 %

#ifndef CMPXVIDEOPLAYERAPPUIENGINE_H

#define CMPXVIDEOPLAYERAPPUIENGINE_H

#include <e32base.h>

#include <mpxplaybackutility.h>

#include <mpxviewutility.h>

#include <mpxcollectionutility.h>

#include <mpxmessage2.h>

#include <mpxcollectionplaylist.h>

#include <mediarecognizer.h>

#include <mpxplaybackobserver.h>

#include <mpxviewactivationobserver.h>

#include <mpxcollectionobserver.h>

#include <mpxcollectionuihelperobserver.h>

class CMpxVideoEmbeddedPdlHandler;

class CMPXCommonUiHelper;

class MMPXCollectionUiHelper;

class CAiwGenericParamList;

class CVideoPlaylistUtility;

class QMpxVideoPlaybackWrapper;

/**

*  Application UI class.

*

*  @lib mpxvideoplayer.exe

*  @since MpxVideoPlayer 0.1

*/

class CMpxVideoPlayerAppUiEngine : public CBase,

                                   public MMPXPlaybackObserver,

                                   public MMPXViewActivationObserver,

                                   public MMPXCollectionObserver ,

                                   public MMPXCHelperEmbeddedOpenObserver

{

    public:        // Constructors and destructor

        static CMpxVideoPlayerAppUiEngine* NewL( QMpxVideoPlaybackWrapper* aWrapper );

        /**

        * Destructor.

        */

        virtual ~CMpxVideoPlayerAppUiEngine();

    public:

        /*

         *  Retrieve the playback utility pointer

         */

        inline MMPXPlaybackUtility* PlaybackUtility();

        /**

         * Opens the specified file in response to a corresponding message.

         *

         * @param aFile File to be opened.

         * @param aParams aiw generic parameters for the file

         */

        void OpenFileL( RFile& aFile, const CAiwGenericParamList* aParams );

        /**

         * Opens the specified file in response to a corresponding message.

         *

         * @param aFile File to be opened.

         */

        void OpenFileL( const TDesC& aFileName );

        /**

         * Opens the specified mpx media object.

         *

         * @param aMedia Media to be opened.

         */

        void OpenMediaL( const CMPXMedia& aMedia );

        /**

         * Handle playback message

         *

         * @param aMessage playback message

         */

        void DoHandlePlaybackMessageL( const CMPXMessage& aMessage );

        /**

         * Handle Player Changed Playback Message

         */

        void HandlePlaybackPlayerChangedL();

        /**

         * Sets mpx components ready for application shutdown

         */

        void PrepareCloseMpxL();

        /**

         * Sets AppUiEngine in stand alone "mode"

         */

        void StartStandAloneL();

        /**

         * Handle media properties.

         */

        void DoHandelCollectionMediaL( const CMPXMedia& aMedia );

        /**

         * Steps one level up in collection path

         */

        void StepBackCollectionPathL();

        /**

         * Initialize the playback engine with a collection path

         * @param aPath The collection path to create the playlist from

         */

        void InitPlaybackEngineL( CMPXCollectionPath& aPath );

        /**

         * Process activation message.

         * @param aMsg reference to activation message

         */

        void ProcessActivationMessageL( const TDesC8 &aMsg );

        /*

         * Handle embedded playback message

         * @param aMessageUid message identification uid

         * @param aMessageParameters  aiw generic parameters

         */

        TBool HandleMessageL( TUid aMessageUid,

                              const TDesC8& aMessageParameters );

        /**

         * From MMPXPlaybackObserver

         * Handle playback message

         *

         * @since 3.1

         * @param aMessage playback message

         * @param aErr system error code.

         */

        void HandlePlaybackMessage( CMPXMessage* aMessage, TInt aError );

        /**

         * From MMPXViewActivationObserver

         * Handle view activation.

         *

         * @since 3.1

         * @param aCurrentViewType Current view type Uid.

         * @param aPreviousViewType Previous view type Uid.

         */

        void HandleViewActivation( const TUid& aCurrentViewType, const TUid& aPreviousViewType );

        /**

         *  From MPXCollectionObserver

         *  @since S60 3.2.3

         *  @param aMessage collection 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

         */

        void HandleCollectionMessage( CMPXMessage* aMsg, TInt /*aErr*/ );

        /**

         * From MMPXCollectionObserver

         * Handle media properties.

         *

         * @since 3.1

         * @param aMedia  media properties.

         * @param aError Error code.

         */

        void HandleCollectionMediaL( const CMPXMedia& aMedia, TInt aError );

         /**

         * From MMPXCollectionObserver

         * Handles the collection entries being opened.

         *

         * @since 3.1

         * @param aEntries Collection entries opened.

         * @param aIndex Focused entry.

         * @param aComplete ETrue no more entries. EFalse more entries

         *                  expected.

         * @param aError Error code.

         */

        void HandleOpenL( const CMPXMedia& aEntries,

                          TInt aIndex,

                          TBool aComplete,

                          TInt aError );

        /**

         * From MMPXCollectionObserver

         * Handles the item being opened.

         *

         * @since 3.1

         * @param aPlaylist Collection playlist, owner ship is transfered.

         * @param aError Error code.

         */

        void HandleOpenL( const CMPXCollectionPlaylist& aPlaylist, TInt aError);

        // from base class MMPXCHelperEmbeddedOpenObserver

            /**

            * From MMPXCHelperEmbeddedOpenObserver

            * Handles errors from opening in embedded mode

            *

            * @since 3.1

            * @param aErr Error code

            * @param aCategory Type of item to be opened.

            */

        void HandleEmbeddedOpenL( TInt aErr, TMPXGeneralCategory aCategory  );

        void CreateEmbeddedPdlPlaybackUtilityMemberVariablesL();

        /*

         * Handles the "back" button.

         */

        void HandleSoftKeyBackL();

        /*

         *  Processes shell commands.

         *  @param aCommand

         *  @param aDocumentName

         *  @param aTail

         *  @return  ETrue if document name exists

         */

        TBool ProcessCommandParametersL( TApaCommand aCommand,

                                         TFileName& aDocumentName,

                                         const TDesC8& aTail );

        /*

         *  Provides the static function for the callback to exit the application

         *  Called by CIdle iIdle

         *  @since 9.2

         *  @param aPtr Pointer to callback class

         *  @return KErrNone

         */

        static TInt ExitApplicationL( TAny* aPtr );

        /*

         *  Late initializatoin of members that can be delayed 

         *  to help improve startup time

         *  @since 10.1

         */        

        void LateInitL();

    private:

        /**

         * Constructor

         */

        CMpxVideoPlayerAppUiEngine( QMpxVideoPlaybackWrapper* aWrapper );

        /**

         * By default Symbian 2nd phase constructor is private.

         */

        void ConstructL();

        void HandleMultiLinksFileL( const TDesC& aFileName,

                                    CMediaRecognizer::TMediaType aMediaType );

        void HandleMultiLinksFileL( RFile& aFile,

                                    CMediaRecognizer::TMediaType aMediaType );

        void DoHandleMultiLinksFileL( CVideoPlaylistUtility* aPlaylistUtil,

                                      TBool aSingleLink,

                                      TBool aLocalFile );

        /**

         *  Handles the Url descriptor

         *

         *  @param aUrl - the ulr to be handled

         */

        void HandleUrlDesL(const TDesC& aUrl);

        TPtrC GetLinkLC( const TDesC& aFileName,

                         CMediaRecognizer::TMediaType aMediaType,

                         TBool aUseFileHandle = EFalse );

        TInt HandleAiwGenericParamListL( const CAiwGenericParamList* aParams );

        /**

        * Handle collection message

        *

        * @param aMessage collection message

        */

       void DoHandleCollectionMessageL( CMPXMessage* aMessage );

       void CreatePlaybackUtilityMemberVariablesL();

       void CreateCollectionUtilityMemberVariablesL();

       void CreateRemoteControlListenerL();

       /*

        *  Activates an active object to exit the application

        *  @since 5.0

        */

       void ActivateExitActiveObject();

       /*

        *  Called to stop and exit the application

        *  @since 9.2

        *  @return void

        */

       virtual void DoExitApplicationL();

	   /*

	   * used to send media info to plugin

	   */

       void UpdatePbPluginMediaL();

       void ActivateVideoPlaybackView();

    private:       // data

        //

        //  Owned Utilities

        //

        MMPXPlaybackUtility*     iPlaybackUtility;

        //Do we need this?  MMPXViewUtility*         iViewUtility;

        MMPXCollectionUtility*   iCollectionUtility;

        MMPXCollectionUiHelper*  iCollectionUiHelper;  // own

        TUid iVideoCollectionId;

        CIdle*                        iExitAo;

        CMediaRecognizer*             iRecognizer;       // own

        CMpxVideoEmbeddedPdlHandler*  iPdlHandler;       // own

        TInt                     iAccessPointId;

        TBool                    iMultilinkPlaylist;

        TBool                    iSeekable;

        TBool                    iUpdateSeekInfo;

        QMpxVideoPlaybackWrapper* iPlaybackWrapper;

};

//

//  Inline methods

//

inline

MMPXPlaybackUtility* CMpxVideoPlayerAppUiEngine::PlaybackUtility()

{

    return iPlaybackUtility;

}

#endif             // CMPXVIDEOPLAYERAPPUIENGINE_H