inc/mpengine.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 11 Jun 2010 13:36:36 +0300
changeset 32 c163ef0b758d
parent 29 8192e5b5c935
child 37 eb79a7c355bf
permissions -rw-r--r--
Revision: 201021 Kit: 2010123

/*
* 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: Music Player engine.
*
*/

#ifndef MPENGINE_H
#define MPENGINE_H

#include <QObject>
#include "mpmpxcollectionviewdefs.h"
#include "mpmpxcommondefs.h"
#include "mpcommondefs.h"


class QStringList;
class QTranslator;
class HbPopup;
class MpMpxHarvesterFrameworkWrapper;
class MpMediaKeyHandler;
class MpMpxCollectionFrameworkWrapper;
class MpMpxPlaybackFrameworkWrapper;
class MpMpxDetailsFrameworkWrapper;
class MpMpxCollectionData;
class MpPlaybackData;
class MpSongData;
class XQSharableFile;
class MpEngineFactory;
class MpAudioEffectsFrameworkWrapper;
class MpEqualizerFrameworkWrapper;
class MpProgressDialogHandler;

#if defined(BUILD_MPENGINE_LIB)
#define MPENGINE_EXPORT Q_DECL_EXPORT
#else
#define MPENGINE_EXPORT Q_DECL_IMPORT
#endif


class MPENGINE_EXPORT MpEngine : public QObject
{
    Q_OBJECT
    Q_PROPERTY(int activePreset READ activePreset)

    friend class MpEngineFactory;

public:
    enum EngineMode{
        StandAlone,
        Fetch,
        Embedded,
        MediaBrowsing
    };
    
private:

    enum UsbBlockingState {
        USB_NotConnected,          // Not connected
        USB_Connected,             // Connected in MTP mode but not synchronizing
        USB_Synchronizing          // Connected in MassStorage mode or MTP mode and synchronizing
    };

private:
    explicit MpEngine();

public:

    virtual ~MpEngine();

    // Harvester related
    bool verifyUsbBlocking( bool showMessage = false );
    void checkForSystemEvents();
    
    // Collection related
    void openCollection( TCollectionContext context );
    void openCollectionItem( int index );
    void back();
    void findPlaylists( QStringList &playlists );
    void createPlaylist( QString &playlistName, QList<int> &selection, MpMpxCollectionData* collectionData = 0  );
    void saveToPlaylist( int playlistIndex, QList<int> &selection );
    void saveToCurrentPlaylist( QList<int> &selection, MpMpxCollectionData *collectionData );    
    void renamePlaylist( QString &newName, int index );
    void renamePlaylist( QString &newName );
    void deleteSongs( QList<int> &selection );

    void previewItem( int index );
    void openIsolatedCollection( TCollectionContext context );
    void releaseIsolatedCollection();

    void findAlbumSongs( int index );
    void playAlbumSongs( int albumIndex, int songIndex, MpMpxCollectionData* collectionData = 0 );

    MpMpxCollectionData *collectionData();
    
    // Playback related
    
    MpPlaybackData *playbackData();
    
    void shuffleAll();

    
    // Details related
    MpSongData *songData();
    void retrieveSong();
    
    // Audio Effects related
    int balance();
    bool loudness();
    
    // Equalizer related
    void applyPreset( int presetIndex );
    void disableEqualizer();
    int activePreset();
    QStringList presetNames();

signals:
    
    // Harvester related
    void libraryAboutToUpdate();
    void libraryUpdated();
    void usbBlocked( bool blocked );
    
    // Collection related
    void collectionPlaylistOpened();
    void playlistSaved( bool success );
    void songsDeleted( bool success );
    void playlistsRenamed( bool success );
    
    void isolatedCollectionOpened( MpMpxCollectionData* collectionData );
    
    void containerContentsChanged();
    
    // Equalizer related
    void equalizerReady();

public slots:

    // Harvester related
    void refreshLibrary();
    void handleScanStarted();
    void handleScanEnded( int count, int error );
    void handleDiskEvent( MpxDiskEvents event );
    void handleUsbEvent( MpxUsbEvents event );
    void handleOutstandingNoteClosing();
    
    // Collection related
    void reopenCollection();
    void reorderPlaylist( int playlistId, int songId, int originalOrdinal, int newOrdinal );
    void handleDeleteStarted();
    void handleDeleteEnded();

    // Playback related
    void playEmbedded( QString aFilename );
    void playEmbedded( const XQSharableFile&  file );
    void playPause();
    void stop();
    void skipForward();
    void startSeekForward();
    void stopSeeking();
    void skipBackward();
    void startSeekBackward();
    void setPosition( int position );
    void setShuffle( bool mode );
    void setRepeat( bool mode );
    
    // Audio Effects related
    void setBalance( int balance );
    void setLoudness( bool mode );
    
    // Equalizer related
    void handleEqualizerReady();
	
private:
    
    void initialize( TUid hostUid, EngineMode mode);

    // Harvester related
    void handleUsbMassStorageStartEvent();
    void handleUsbMassStorageEndEvent();
    void handleUsbMtpStartEvent();
    void handleUsbMtpEndEvent();
    void handleUsbMtpNotActive();

    void changeUsbBlockingState( UsbBlockingState state );
    void launchBlockingNote();
    void setOutstandingPopup( HbPopup *popup );
	
private:

    Q_DISABLE_COPY( MpEngine )

    // Harvesting related
    MpMpxHarvesterFrameworkWrapper       *mMpxHarvesterWrapper;  // Own
    MpMediaKeyHandler                    *mMediaKeyHandler;      // Own
    HbPopup                              *mUsbOutstandingNote;   // Own
    
    // Collection related
    MpMpxCollectionFrameworkWrapper      *mMpxCollectionWrapper; //Own

    // Playback related
    MpMpxPlaybackFrameworkWrapper        *mMpxPlaybackWrapper; //Own
    
    // Details related
    MpMpxDetailsFrameworkWrapper         *mMpxDetailsWrapper;  // Own
    
    // Audio Effects related
    MpAudioEffectsFrameworkWrapper       *mAudioEffectsWrapper; // Own
    
    // Equalizer related
    MpEqualizerFrameworkWrapper          *mEqualizerWrapper; // Own
    int                                  mCurrentPresetIndex;
        
    // General
    QTranslator                          *mMpTranslator;         // Own
    UsbBlockingState                     mUsbBlockingState;
    UsbBlockingState                     mPreviousUsbState;    
    TUid                                 mHostUid;
    MpProgressDialogHandler              *mProgressDialogHandler;  // Own
    
};

#endif // MPENGINE_H