/*
* Copyright (c) 2007 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:    Implementation of RTP file recognizer class.*
*/




#ifndef CRTPCLIPRECOGNIZER_H
#define CRTPCLIPRECOGNIZER_H

// INCLUDES
#include <apmrec.h>
#include <etelmm.h>

// CONSTANTS
const TInt KUserIdLength( RMobilePhone::KIMSISize );
const TInt KDeviceIdLength( RMobilePhone::KPhoneSerialNumberSize );

// MACROS
// None

// DATA TYPES
// None

// FORWARD DECLARATIONS
// None

// CLASS DECLARATION

/**
*   Class to make recognisation for RTP propriatary clip.
*  
*  @lib RtpClipRecognizer.lib
*  @since Series 60 3.0
*/
class CRtpClipRecognizer : public CApaDataRecognizerType
    {

public: // Constructors and destructor

    /**
    * Static method to create instance of this recognizer. This method is called
    * by the framework. Method pointer is delivered to the framework by
    * ImplementationTable table returned by ImplementationGroupProxy.
    * @since Series 60 3.0
    * @param none.
    * @return Pointer to newly created instance of the recognizer.
    */
    static CApaDataRecognizerType* CreateRecognizerL();
    
    /**
    * C++ default constructor. Calls CApaDataRecognizerType in it's initializer
    * list to complete construction.
    */
    CRtpClipRecognizer();
    
private: // Functions from base classes

    /**
    * From CApaDataRecognizerType.
    * Method called by the framework. This method returns the amount of data
    * to be wanted for recognisation.
    * @since Series 60 3.0
    * @param none.
    * @return Preferred buffer size for recognisation.
    */
    virtual TUint PreferredBufSize();
    
    /**
    * From CApaDataRecognizerType.
    * Method to deliver supported data types by this recognizer.
    * @since Series 60 3.0
    * @param aIndex a index pointing out which data type
    *        of the supported ones is returned.
    * @return Corresponding data type of the requested index.
    */
    virtual TDataType SupportedDataTypeL( TInt aIndex ) const;

    /**
    * From CApaDataRecognizerType.
    * Overwritten method to handle recognisation.
    * @param aName the name of the data. Typically this is a file name
    *        containing the data to be recognized.
    * @param aBuffer a buffer containing PreferredBufSize() from the
    *        beginning of the file to be recognized.
    * @return none.
    */
    virtual void DoRecognizeL( const TDesC& aName,
                               const TDesC8& aBuffer );
    
private: // New methods

    /**
    * Converts bytes to integer.
    * @since Series 60 3.0
    * @param aBytes a buffer to convert.
    * @return an integer converted from bytes.
    */
    TInt GetValueL( const TDesC8& aBytes );

    /**
    * Converts bytes to integer.
    * @since Series 60 3.0
    * @param aBytes a buffer to convert.
    * @param aValue a integer converted from bytes.
    * @return none.
    */
    void GetValueL( const TDesC8& aBytes, TInt& aValue );

    /**
    * Converts bytes to integer.
    * @since Series 60 3.0
    * @param aBytes a buffer to convert.
    * @param aValue a integer converted from bytes.
    * @return a system wide error code.
    */
    TInt GetValue( const TDesC8& aBytes, TInt& aValue );

    /**
    * Converts bytes to integer.
    * @since Series 60 3.0
    * @param aBytes a buffer to convert.
    * @param aValue a integer converted from bytes.
    * @return a system wide error code.
    */
    TInt GetValue( const TDesC8& aBytes, TUint& aValue );

    /**
    * Converts bytes to 64 bit integer (TInt64).
    * @since Series 60 3.0
    * @param aBytes a buffer to convert.
    * @return a integer value converted from bytes.
    */
    TInt64 GetTInt64L( const TDesC8& aBytes );

    /**
    * Getter for RTP clip mime type info.
    * @since Series 60 3.0
    * @param aBuf on return contains the mime type.
    * @return None.
    */
    void GetMimeInfo( TDes8& aMime );

    /**
    * Reads IMEI of the phone HW.
    * @since Series 60 3.0
    * @param aBuf on return contains the IMEI.
    * @return none.
    */
    void GetImeiL( TDes& aImsi );
    
    /**
    * Reads mobile info of the phone.
    * @since Series 60 3.0
    * @param none.
    * @return none.
    */
    void GetMobilePhoneInfoL( RTelServer& aServer,
                              RMobilePhone& aPhone );

private: // Data

    TBuf8<KDeviceIdLength> iImei;
    
    };

#endif // CRTPCLIPRECOGNIZER_H

//  End of File