mobilemessaging/smilui/mediainc/SmilPlayerMediaFactory.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 02 Feb 2010 00:08:43 +0200
changeset 10 da93fe14e0e3
parent 0 72b543305e3a
permissions -rw-r--r--
Revision: 201003 Kit: 201005

/*
* Copyright (c) 2002-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:  
*       Factory class that creates SMIL Player media renderers
*       accoring to the MIME type of the media file.
*
*/



#ifndef SMILPLAYERMEDIAFACTORY_H
#define SMILPLAYERMEDIAFACTORY_H

//  INCLUDES
#include <smiltextbuf.h>
#include <smilmediafactoryinterface.h>
#include "SmilImageRenderer.h"
#include "SmilMediaRendererBase.h"

typedef CArrayPtrFlat<CSmilMediaRendererBase> CRendererArray;

// FORWARD DECLARATIONS
class MMediaFactoryFileInfo;
class DRMCommon;
class CDRMHelper;
class CMsgMediaResolver;

// CLASS DECLARATION

/**
* Factory class that creates SMIL Player media renderers
* accoring to the MIME type of the media file
*
* @lib smilmediarenderer.lib
* @since 2.0
*/
class CSmilPlayerMediaFactory : public CBase,
                                public MSmilMediaFactory 
    {
    public: // Constructors and destructor
        
        
        /**
        * Factory method that creates this object.
        *
        * @param    aCoeEnv      IN Control environment
        * @param    aGc          IN Graphical context used to draw
        *                           
        * @param    aFileInfo    IN Indicates whether only preview should be played. 
                                    Default is EFalse.
        *
        * @return   pointer to instance
        */
        IMPORT_C static CSmilPlayerMediaFactory* NewL( CCoeEnv& aCoeEnv,
                                                       CGraphicsContext* aGc,
                                                       MMediaFactoryFileInfo* aFileInfo );
        
        /**
        * Destructor.
        */
        virtual ~CSmilPlayerMediaFactory();

    public: // Functions from base classes
    
        /**
        * From MSmilMediaRenderer
        * See smilmediafactoryinterface.h for further information
        */
        void SetBaseUrlL( const TDesC& aBaseUrl );

        /**
        * From MSmilMediaRenderer
        * See smilmediafactoryinterface.h for further information
        */
        void RequestMediaL( const TDesC& aUrl, MSmilMedia* aMedia );

        /**
        * From MSmilMediaRenderer
        * See smilmediafactoryinterface.h for further information
        */
        void PrefetchMediaL( const TDesC& aUrl );

        /**
        * From MSmilMediaRenderer
        * See smilmediafactoryinterface.h for further information
        */
        TMediaFactoryError CreateRendererL( const TDesC& aUrl,
                                            MSmilMedia* aMedia, 
                                            MSmilMediaRenderer*& aRender );

        /**
        * From MSmilMediaRenderer
        * See smilmediafactoryinterface.h for further information
        */
        TPrefetchStatus PrefetchStatus( const TDesC& aUrl,
                                        TInt& aDown,
                                        TInt& aSize );

        /**
        * From MSmilMediaRenderer
        * See smilmediafactoryinterface.h for further information
        */
        void RendererDeleted( MSmilMediaRenderer* aRenderer );

        /**
        * From MSmilMediaRenderer
        * See smilmediafactoryinterface.h for further information
        */
        void PresentationReady();

        /**
        * From MSmilMediaRenderer
        * See smilmediafactoryinterface.h for further information
        */
        void PresentationEnd();

        /**
        * From MSmilMediaRenderer
        * See smilmediafactoryinterface.h for further information
        */
        TBool QueryContentType( const TDesC& aMimeType ) const;
        
    public: // New functions    

        /**
        * Returns all renderers in the presentation.
        *
        * @since 3.1
        * 
        * @return Renderer array
        */ 
        IMPORT_C CRendererArray* GetRenderers();

    private:
        
        /**
        * C++ default constructor.
        */
        CSmilPlayerMediaFactory();
        
        /**
        * Constructor.
        */
        CSmilPlayerMediaFactory( CCoeEnv& aCoeEnv,
                                 CGraphicsContext* aGc ,
                                 MMediaFactoryFileInfo* aFileInfo );
        
        /**
        * 2nd phase constructor
        */
        void ConstructL();
    
        /**
        * InstantiateRendererL
        */
        MSmilMediaRenderer* InstantiateRendererL( TMsgMediaType aMediaType, 
                                                  RFile& aFileHandle,
                                                  MSmilMedia* aMedia, 
                                                  TUint aCharSet );
        
        /**
        * ResolveErrorL
        */
        void ResolveErrorL( TMsgMediaType aMediaType, 
                            RFile& aFileHandle,
                            TInt aErrorCode,
                            MSmilMedia* aMedia,
                            MSmilMediaRenderer*& aRenderer ) const;
        
        /**
        * PlaybackAllowedL
        */
        TBool PlaybackAllowedL( const TDesC8& aMimeType, RFile& aFileHandle ) const;
                           
    private: //data
        
        // Control environment
        CCoeEnv& iCoeEnv;
        
        // Graphical context. Used to format all text.
        CGraphicsContext* iGc;
        
        // File info
        MMediaFactoryFileInfo* iFileInfo;

        // Base url used for resolving relative URLs.
        RSmilTextBuf iBaseUrl;
        
        // Renderer array
        CRendererArray* iRendererArray;
        
        // Flag indicating whether non-drm music playing should be allowed.
        TBool iProhibitNonDrmMusic;
        
        // DRM common
        DRMCommon* iDrmCommon;
        
        // DRM Helper
        CDRMHelper* iDrmHelper;
        
        // Contains prohibit mime types.
        HBufC* iProhibitMimeTypeBuffer;
        
        // Resolves media type for mime type.
        CMsgMediaResolver* iMediaResolver;
    };

#endif // SMILPLAYERMEDIAFACTORY_H