filedetails/filedetailsdialog/inc/MediaPlayerDrmHelper.h
author hgs
Thu, 01 Apr 2010 23:22:15 +0300
changeset 34 bbb98528c666
parent 0 96612d01cf9f
permissions -rw-r--r--
201009

/*
* Copyright (c) 2004 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:   DRM helper for Media files.*
*/



#ifndef MEDIAPLAYERDRMHELPER_H
#define MEDIAPLAYERDRMHELPER_H

// INCLUDES
#include <e32std.h>
#include <MPFileDetails.h>  

// FORWARD DECLARATIONS
class CDRMHelper;
class CDRMHelperRightsConstraints;
class MDesCArray;
class CCoeEnv;
class CMPFileDetails;
namespace DRM
{
class CDrmUtility;	
class CDrmUiHandling;
}

// CONSTANTS
const TInt KMediaPlayerRightsAboutToExpire = -40000;

// CLASS DECLARATION

/**
*  DRM helper for Media files.
*
*  @lib MPFileDetailsDialog.lib
*  @since 3.2
*/
NONSHARABLE_CLASS( CMediaPlayerDrmHelper ) : public CBase
    {
    public:  // Constructors and destructor

        /**
        * Two-phased constructor called by CMPVideoPlayerUIController class
        * @param aDrmHelper Pointer to CDRMHelper class. Ownership is not transferred.
        */
        static CMediaPlayerDrmHelper* NewL(CDRMHelper* aDrmHelper, CMPVideoPlayerUIController* aUIController);

        /**
        * Two-phased constructor called by CMPFileDetailsDialog class or MediaPlayerUtility class
        * @param aDrmHelper Pointer to CDRMHelper class. Ownership is not transferred.
        */
        static CMediaPlayerDrmHelper* NewL(CDRMHelper* aDrmHelper );

        /**
        * Destructor.
        */
        virtual ~CMediaPlayerDrmHelper();

    public: // New functions

        /**
        * Loads usage rights information for a particular media file using
        * CDRMHelper. The loaded constraint is DRMCommon::EPlay.
        * @since 3.2
        * @param aFileName File path, which usage rights info is loaded.
        */
        void LoadDrmUsageRightsInfoL(const TDesC& aFileName);

        /**
        * Loads usage rights information for a particular media file using
        * CDRMHelper. The loaded constraint is DRMCommon::EPlay.
        * @since 3.2
        * @param aFile File handle, which usage rights info is loaded.
        */
        void LoadDrmUsageRightsInfoL(
#ifdef SYMBIAN_ENABLE_64_BIT_FILE_SERVER_API
                                     RFile64& aFile);
#else
                                     RFile& aFile);
#endif // SYMBIAN_ENABLE_64_BIT_FILE_SERVER_API

        /**
        * Gets usage rigths status.
        * @since 3.2
        * @param aStatus:
        *           EMediaPlayerDrmFull:        Full rights
        *           EMediaPlayerDrmMissing:     Rights missing
        *           EMediaPlayerDrmRestricted:  Restricted rights
        *           EMediaPlayerDrmExpired:     Expired rights (could be also future rights)
        *           EMediaPlayerDrmPreview:     Preview rights
        */
        void GetDrmUsageRightsStatus(TMediaPlayerRightsStatus& aStatus);

        /**
        * Gets start time of time based rights.
        * @since 3.2
        * @param aStartTime Start time.
        * @return Error code:
        *           KErrNone:       Start time returned.
        *           KErrNotFound:   Object doesn't have time based rights.
        *           KErrNotReady:   Usage rights info not loaded.
        */
        TInt GetDrmStartTime(TTime& aStartTime);

        /**
        * Get pointer to DRMHelper object (as given in constructor).
        * @since 3.2
        * @return Pointer to DRMHelper. Ownership not transferred.
        */
        CDRMHelper* DrmHelper(); 

        /**
        * Creates a file handle to the file passed in the aName parameter.
        * @param aHandle      Handle to a file
        * @param aName        Name of the file
        * @param aFileMode    Mode to open file handle in
        */
        static void CreateFileHandleLC(
#ifdef SYMBIAN_ENABLE_64_BIT_FILE_SERVER_API
                                       RFile64& aHandle, 
#else
                                       RFile& aHandle, 
#endif // SYMBIAN_ENABLE_64_BIT_FILE_SERVER_API
                                       const TDesC& aName, 
									   TUint aFileMode);

    private: // Private contructors

        /**
        * C++ default constructor.
        */
        CMediaPlayerDrmHelper(CDRMHelper* aDrmHelper, CMPVideoPlayerUIController* aUIController);

        /**
        * C++ default constructor.
        */
        CMediaPlayerDrmHelper(CDRMHelper* aDrmHelper );

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

    private:    // Data

        CDRMHelper* iDrmHelper;
        HBufC* iFileName;
        CDRMHelperRightsConstraints* iRightsConstraints;
        CCoeEnv* iEnv;
        DRM::CDrmUtility* iDrmUtility;  // not owned
        DRM::CDrmUiHandling* iDrmUiHandling;
        TBool iOMAProtected; // ETrue if protected content is OMA, EFalse if it is WMDRM

        TBool iProtected;
        TBool iExpired;
        TBool iDrmSendingAllowed;
        HBufC8* iInfoUrl;
        HBufC8* iPreviewUri;
    };

#endif      // MEDIAPLAYERDRMHELPER_H

// End of File