/*

* Copyright (c) 2007-2008 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:  Interface class for MPEEngineInfo of the PhoneEngine

*

*/

#ifndef MPEENGINEINFO_H

#define MPEENGINEINFO_H

//  INCLUDES

#include <pevirtualengine.h>

// CONSTANTS

// None

// FORWARD DECLARATIONS

class MPEClientInformation;

// DATA TYPES

// None

// CLASS DECLARATION

/**

*  Offers engine info interface to phone application

*

*  @lib phoneengine.lib

*  @since Series 60 4.0

*/

NONSHARABLE_CLASS( MPEEngineInfo )

    {

    public:

        /**

        * Gets active als line of the phone from TPEBasicInfo-structure

        * @return active als line of the phone

        */

        virtual const CCCECallParameters::TCCELineType& ALSLine() const = 0;

        /**

        * Gets ALS support of the phone from TPEBasicInfo-structure

        * @return ETrue if als is supported.

        */

        virtual const TBool& ALSLineSupport() const = 0;

        /**

        * Gets group ids which are active to play ring tone

        * @return contact group id

        */

        virtual const TArray< TContactItemId > AlertForGroup() const = 0;

        /**

        * Gets audio mute value

        * @return audio mute value

        */

        virtual const TBool& AudioMute() const = 0;

        /**

        * Gets audio volume value

        * @return audio volume value

        */

        virtual const TInt& AudioVolume() const = 0;

        /**

        * Gets current audio output path

        * @return audio output path

        */

        virtual const TPEAudioOutput& AudioOutput() const = 0;

        /**

        * Gets phone audio route parameters

        * @return phone audio route parameters. 

        */

        virtual const TPEPhoneAudioRouteParameters& RouteParameters() const = 0;  

        /**

        * Gets audio output path availability

        * @return audio output path availability status

        */

        virtual TBool AudioOutputAvailable( 

            const TPEAudioOutput aOutput ) const = 0;

        /**

        * Gets line information for the specified call

        * @param aCallId is the call identification number

        * @return line information for the specified call

        */

        virtual CCCECallParameters::TCCELineType CallALSLine( const TInt aCallId ) const = 0;

        /**

        * Gets phone client information of the specified call

        * @param aCallId is the call identification number

        * @return client information of the specified call

        */

        virtual const MPEClientInformation& CallClientInformation( const TInt aCallId ) const = 0;

        /**

        * Gets call direction of the specified call

        * @param aCallId is the call identification number

        * @return call direction of the specified call

        */

        virtual RMobileCall::TMobileCallDirection CallDirection( 

            const TInt aCallId ) const = 0;

        /**

        * Gets duration of the last call to go idle

        * @return call duration of the last active call

        */

        virtual const TInt& CallDuration() const = 0;

        /**

        * Gets call duration of the ongoing or last active call with specified id

        * @param aCallId is the call identification number

        * @return call duration of the ongoing or last active call

        */

        virtual TTimeIntervalSeconds CallDuration( const TInt aCallId ) const = 0;

        /**

        * Get caller image

        * @param aCallId is the call identification number.

        * @return caller image

        */

        virtual const TPtrC CallerImage( const TInt aCallId ) const = 0;

        /**

        * Get caller text

        * @param aCallId is the call identification number.

        * @return caller text

        */

        virtual const TPtrC CallerText( const TInt aCallId ) const = 0;

        /**

        * Get caller thumbnail

        * @param aCallId is the call identification number.

        * @return pointer to thumbnail data

        */

        virtual CFbsBitmap* CallerThumbnail(

            const TInt aCallId ) const = 0;

        /**

        * Get caller thumbnail status

        * @return ETrue if has thumbnail, otherwise EFalse.

        */

        virtual TBool HasCallerThumbnail( const TInt aCallId  ) const = 0;

        /**

        * Gets identification number of a call

        *

        * This value is used for determining the target for a command message

        * that requires such information

        * @return identification number of a call

        */

        virtual const TInt& CallId() const = 0;

        /**

        * Gets start time of the call

        * @param aCallTime is the start time of the call

        * @param aCallId is the call identification number

        * @return None.

        */

        virtual const TTime& CallStartTime( const TInt aCallId ) const = 0;

        /**

        * Gets call state of a specified call

        * @param aCallId is the call identification number

        * @return call state of a specified call

        */

        virtual TPEState CallState( const TInt aCallId ) const = 0;

        /**

        * Gets type of the specified call

        * @param aCallId is the call identification number.

        * @return call type of a specified call

        */

        virtual TPECallType CallType( const TInt aCallId ) const = 0;

        /**

        * Gets last set call type information

        * @return call type information

        */

        virtual const TPECallType& CallTypeCommand() const = 0;

        /**

        * Gets secure status from call info

        * @return TBool the secure status (on/off)

        */

        virtual TBool IsSecureCall( const TInt aCallId ) const = 0;

        /**

        * Gets call state of a conference call

        * @return call state

        */

        virtual TPEState ConferenceCallState() const = 0;

        /**

        * Get user group ids this contact is assigned to

        * @param aCallId is the call identification number.

        * @return array for group ids

        */

        virtual const TArray< TContactItemId > ContactGroups(

            const TInt aCallId ) const = 0;

        /**

        * Get remote contact link packet. See virtual phonebook API.

        * @param aCallId is the call identification number.

        * @return Virtual phonebook contact link packet.

        */

        virtual const TDesC8& ContactLink( const TInt aCallId ) const = 0;

        /**

        * Gets the name of data port currently on-loan.

        * Data port loaning is handled by CSPlugin and happens when a data

        * call goes into connected state. The dataport is released when VT components

        * indicate it can be released, i.e. video call hangup.

        * @return data port name

        */

        virtual const TName& DataPortName() const = 0;

        /**

        * Gets dtmf string

        * @return dtmf string

        */

        virtual const TPEDtmfString& DtmfString() const = 0;

        /**

        * Gets error code and cause values for the latest error

        * @return error code and cause values for the latest error

        */

        virtual const TPEErrorInfo& ErrorInfo() const = 0;

        /**

        * Gets key code of the last key press

        * @return key code of the last key press

        */

        virtual const TChar& KeyCode() const = 0;

        /**

        * Gets keypad volume value

        * @return keypad volume value

        */

        virtual const TInt& KeypadVolume() const = 0;

        /**

        * Gets lifetimer data

        * @return lifetime data (TDes8&)

        */

        virtual const TPELifeTimeData& LifeTimerData() const = 0;

        /**

        * Gets a logging indicator

        * @param aCallId, call identification number     

        * @return continuous logging indicator

        */

        virtual TBool LoggingIndicator( const TInt aCallId ) const = 0;

        /**

        * Get missed call indicator

        * @param aCallId, call identification number

        * @return missed call indicator

        */

        virtual TBool MissedCall( const TInt aCallId ) const = 0;

        /**

        * Gets network registration status

        * @return TNWNetworkRegistrationStatus Network registration status

        */

        virtual const TNWNetworkRegistrationStatus& NetworkRegistrationStatus() const = 0;

        /**

        * Get ringing tone

        * Returns a ringing tone defined for one of the user groups

        * if personal tone is not found

        * @param aCallId, call identification number

        * @return ringing tone file path

        */

        virtual const TPEContactFileName& PersonalRingingTone(

            const TInt aCallId ) const = 0;

        /**

        * Gets personal tone status

        * @return personal tone status

        */

        virtual const TBool& PersonalToneStatus() const = 0;

        /**

        * Gets phone identity parameters

        * @return phone identity parameters. 

        */

        virtual const TPEPhoneIdentityParameters& PhoneIdentityParameters() const = 0;

        /**

        * Gets phone number

        * @return Reference to TPEPhoneNumber, containing the phone number of the remote party.

        */

        virtual const TPEPhoneNumber& PhoneNumber() const = 0;

        /**

        * Gets phone number parsing result

        * @return ETrue if phone number is a service code

        */

        virtual const TBool& PhoneNumberIsServiceCode() const = 0;

        /**

        * Gets profile id

        * @return profile id

        */

        virtual const TInt& ProfileId() const = 0;

        /**

        * Gets profile name

        * @return profile name.  

        */

        virtual const TPEProfileName& ProfileName() const = 0;

        /**

        * Gets contact company name

        * @param aCallId, call identification number

        * @return company name

        */

        virtual const TPEContactCompany& RemoteCompanyName(

            const TInt aCallId ) const = 0;

        /**

        * Gets remote party identity 

        * @param aCallId is the Call identification number

        * @return remote party identity

        */

        virtual RMobileCall::TMobileCallRemoteIdentityStatus RemoteIdentity ( 

            const TInt aCallId ) const = 0;

        /**

        * Gets contact name

        * Depending on user selected language may be in order:

        * first + last name OR last + first name

        * @param aCallId, call identification number

        * @return contact name

        */

        virtual const TPEContactName& RemoteName( const TInt aCallId ) const = 0;

        /**

        * Gets remote end phone number

        * @param aCallId, call identification number

        * @return phone number

        */

        virtual const TPEPhoneNumber& RemotePhoneNumber(

            const TInt aCallId ) const = 0;

        /**

        * Gets remote end phone number type

        * @param aCallId, call identification number

        * @return phone number type

        */

        virtual const TPEPhoneNumberIdType& RemotePhoneNumberType(

            const TInt aCallId ) const = 0;

        /**

        * Gets text to speech text for this contact. Used in

        * text to speech ringing tone.

        * @param aCallId, call identification number

        * @return descriptor, ownership passed.

        */

        virtual const TPtrC RemoteTextToSpeechText(

            const TInt aCallId ) const = 0;

        /**

        * Gets remote predefined dtmf strings

        * @param aCallId, call identification number

        * @return reference to string array

        */

        virtual const CDesCArray&  RemotePredefinedDtmfStrings(

            const TInt aCallId ) const = 0;                 

        /**

        * Gets ringing type

        * @return ringing type

        */

        virtual const TProfileRingingType& RingingType() const = 0; 

        /**

        * Gets ringing tone name

        * @param aCallId, call identification number 

        * @return name of the current ringing tone

        */

        virtual const TPEContactFileName& RingingTone( const TInt& aCallId ) const = 0;

        /**

        * Gets current ringing volume

        * @return the current ringing volume

        */

        virtual const TInt& RingingVolume() const = 0;       

        /**

        * Gets text-to-speech preference setting value

        * @return text-to-speech status (EFalse/ETrue)

        */

        virtual const TBool& TextToSpeech() const = 0;

        /**

        * Gets VoiceMailBoxNumber for Line 1 information from TPEBasicInfo-structure

        * @return line 1 VoiceMailBoxNumber information

        */

        virtual const TPEPhoneNumber& VoiceMailBoxNumberLine1() const = 0;

        /**

        * Gets VoiceMailBoxNumber for Line 2 information from TPEBasicInfo-structure

        * @return line 2 VoiceMailBoxNumber information

        */

        virtual const TPEPhoneNumber& VoiceMailBoxNumberLine2() const = 0;

        /**

        * Sets audio mute command to TPEBasicInfo-structure

        * @param aAudioMute is audio mute

        * @return None.

        */

        virtual void SetAudioMuteCommand( const TInt& aAudioMute ) = 0;

        /**

        * Sets audio output command to TPEBasicInfo-structure

        * @param aOutput is audio output path

        * @param aShowNote is audio note value

        * @return None.

        */

        virtual void SetAudioOutputCommand( 

            const TPEAudioOutput& aOutput,

            const TBool aShowNote  ) = 0;

        /**

        * Sets audio volume command to TPEBasicInfo-structure

        * @param aAudioVolume is audio volume

        * @return None.

        */

        virtual void SetAudioVolumeCommand( const TInt& aAudioVolume ) = 0;

        /**

        * Sets CallId value to TPECallCommandInfo-structure

        * @param aCallId is the call id number.

        * @return None.

        */

        virtual void SetCallId( const TInt& aCallId ) = 0;

        /**

        * Sets call type information for following command message

        * Used for specifying the call type of the next attempted call

        * @param aCallType is the call type of the next attempted call

        */

        virtual void SetCallTypeCommand( const TPECallType& aCallType ) =  0;

        /**

        * Sets dtmf string value to TPEBasicInfo-structure

        * @param aDtmfString is the dtmf string to be sent. 

        * @return None.

        */

        virtual void SetDtmfStringCommand( const TPEDtmfString& aDtmfString ) = 0;

        /**

        * Sets key code value to TPEBasicInfo-structure

        * @param aKeyCode is the key code value.

        * @return None.

        */

        virtual void SetKeyCode( const TChar& aKeyCode ) = 0; 

        /**

        * Sets phone number to TPECallCommandInfo-structure

        * @param aPhoneNumber is the phone number

        * @return None.

        */

        virtual void SetPhoneNumber( const TPEPhoneNumber& aPhoneNumber ) = 0;

        /**

        * Gets two digit support status value

        * @return two digit support status (EFalse/ETrue)

        */

        virtual const TBool& TwoDigitSupportStatus() const = 0;

        /**

        * Returns the service-id used for the command.

        * @return TUint32 ServiceId

        */

        virtual TUint32 ServiceIdCommand() const = 0;

        /**

        * SetServiceIdCommand

        * @return None

        */

        virtual void SetServiceIdCommand( TUint32 aServiceId ) = 0;

        /**

        * Gets ServiceId

        * @return ServiceId

        */

        virtual TUint32 ServiceId( const TInt aCallId ) const = 0;

        /**

        * Gets active forwarding information from TPEBasicInfo-structure

        * @return deflect information

        */

        virtual const TPEActiveForwardInfo& ActiveForwardingInfo() const = 0;

        /**

        * Gets barring information from TPEBasicInfo-structure

        * @return barring information

        */

        virtual const TPEBarringInfo& BarringInfo() const = 0;

        /**

        * Gets conference value from TPECallInfo-structure

        * @param aCallId is the call identification number

        * @return call conference value

        */

        virtual TInt CallConference( const TInt aCallId ) const = 0;

        /**

        * Gets call control caps from the TPECallInfo-structure

        * @param aCallId is the call identification number

        * @return call control capabilities