phoneengine/callhandling/inc/cpesinglecallobserver.h
changeset 21 92ab7f8d0eab
parent 0 5f000ab63145
child 51 f39ed5e045e0
child 62 5266b1f337bd
equal deleted inserted replaced
4:c84cf270c54f 21:92ab7f8d0eab
    50 */
    50 */
    51 class CPESingleCallObserver
    51 class CPESingleCallObserver
    52         : public CPECall, 
    52         : public CPECall, 
    53           public MCCECallObserver
    53           public MCCECallObserver
    54     {
    54     {
    55 	protected: //Constructors and descructor
    55     protected: //Constructors and descructor
    56 	    /**
    56         /**
    57 	    * C++ default constructor.
    57         * C++ default constructor.
    58 	    */
    58         */
    59 	    CPESingleCallObserver( MPEMessageSender& aOwner );
    59         CPESingleCallObserver( MPEMessageSender& aOwner );
    60 
    60 
    61 	    /**
    61         /**
    62 	    * Destructor.
    62         * Destructor.
    63 	    */
    63         */
    64 	    virtual ~CPESingleCallObserver();
    64         virtual ~CPESingleCallObserver();
    65 
    65 
    66 	public:    // from MCCECallObserver
    66     public:    // from MCCECallObserver
    67 	
    67     
    68 	    /**
    68         /**
    69         * Call errors are notified using this interface. 
    69         * Call errors are notified using this interface. 
    70         *
    70         *
    71         * @since S60 v3.2
    71         * @since S60 v3.2
    72         * @param aError Occurred error as integer,
    72         * @param aError Occurred error as integer,
    73         * return none
    73         * return none
    74         */
    74         */
    75     	IMPORT_C void ErrorOccurred( const TCCPError aError );
    75         IMPORT_C void ErrorOccurred( const TCCPError aError );
    76 	    
    76         
    77 	    /**
    77         /**
    78 	    * Call state notificfation. 
    78         * Call state notificfation. 
    79 	    * TODO: The observer need to verify the correctness of given state.
    79         * TODO: The observer need to verify the correctness of given state.
    80 	    * CCE will do at least basic call state change checking but also the client 
    80         * CCE will do at least basic call state change checking but also the client 
    81 	    * needs to verify the correctness.
    81         * needs to verify the correctness.
    82 	    *
    82         *
    83 	    * @since S60 v3.2
    83         * @since S60 v3.2
    84 	    * @param aState New state of the call
    84         * @param aState New state of the call
    85 	    * return none
    85         * return none
    86 	    */
    86         */
    87         IMPORT_C void CallStateChanged( const CCPCall::TCallState aState );
    87         IMPORT_C void CallStateChanged( const CCPCall::TCallState aState );
    88 
    88 
    89         /**
    89         /**
    90         * The state of the call has changed with inband tone, meaning network is not playing 
    90         * The state of the call has changed with inband tone, meaning network is not playing 
    91         * the tone relating to the state.
    91         * the tone relating to the state.
    93         * @param aState Call state.
    93         * @param aState Call state.
    94         * @return none
    94         * @return none
    95         */
    95         */
    96         IMPORT_C void CallStateChangedWithInband( const CCPCall::TCallState aState );
    96         IMPORT_C void CallStateChangedWithInband( const CCPCall::TCallState aState );
    97 
    97 
    98 	    /**
    98         /**
    99 	    * An event for the call has occurred. 
    99         * An event for the call has occurred. 
   100 	    * TODO: the observer need to verify event correcness.
   100         * TODO: the observer need to verify event correcness.
   101 	    *
   101         *
   102 	    * @since S60 v3.2
   102         * @since S60 v3.2
   103 	    * @param aEvent Occurred call event
   103         * @param aEvent Occurred call event
   104 	    * return none
   104         * return none
   105 	    */
   105         */
   106         IMPORT_C void CallEventOccurred( const MCCECallObserver::TCCECallEvent aEvent );
   106         IMPORT_C void CallEventOccurred( const MCCECallObserver::TCCECallEvent aEvent );
   107 	    
   107         
   108 	    /**
   108         /**
   109 	    * Notifies observer the change in call duration.
   109         * Notifies observer the change in call duration.
   110 	    *
   110         *
   111 	    * @since S60 v3.2
   111         * @since S60 v3.2
   112 	    * @param aDuration Duration of the call in seconds
   112         * @param aDuration Duration of the call in seconds
   113 	    * return none
   113         * return none
   114 	    */
   114         */
   115         IMPORT_C void CallDurationChanged( const TTimeIntervalSeconds aDuration );
   115         IMPORT_C void CallDurationChanged( const TTimeIntervalSeconds aDuration );
   116 	    
   116         
   117 	    /**
   117         /**
   118 	    * Notifies observer about the changes in call control caps.
   118         * Notifies observer about the changes in call control caps.
   119 	    *
   119         *
   120 	    * @since S60 v3.2
   120         * @since S60 v3.2
   121 	    * @param aCaps Contains updated call control capability flags
   121         * @param aCaps Contains updated call control capability flags
   122 	    * return none
   122         * return none
   123 	    */
   123         */
   124         IMPORT_C void CallCapsChanged( const MCCECallObserver::TCCECallControlCaps aCaps );
   124         IMPORT_C void CallCapsChanged( const MCCECallObserver::TCCECallControlCaps aCaps );
   125 	    
   125         
   126 	    /**
   126         /**
   127 	    * Notifies observer about transfer made by remote end
   127         * Notifies observer about transfer made by remote end
   128 	    *
   128         *
   129 	    * @since S60 v3.2
   129         * @since S60 v3.2
   130 	    * @param aAttended ETrue: if transfer type is attended, EFalse: type is unattended
   130         * @param aAttended ETrue: if transfer type is attended, EFalse: type is unattended
   131 	    * @param aDestination Address where the call is to be transferred. Given as received in CCE 
   131         * @param aDestination Address where the call is to be transferred. Given as received in CCE 
   132 	    * observer needs to verify the address, e.g. it can be KNullDesC.
   132         * observer needs to verify the address, e.g. it can be KNullDesC.
   133 	    * TODO anonymous transfer target - quess cannot be occurring? 
   133         * TODO anonymous transfer target - quess cannot be occurring? 
   134 	    * A-B -> B-C, C has requested anonymity in network???
   134         * A-B -> B-C, C has requested anonymity in network???
   135 	    */
   135         */
   136         IMPORT_C void HandleTransfer( const TBool aAttended, 
   136         IMPORT_C void HandleTransfer( const TBool aAttended, 
   137 	                                  const TDesC& aDestination );
   137                                       const TDesC& aDestination );
   138        
   138        
   139     public:    //New functions 
   139     public:    //New functions 
   140 	                 
   140                      
   141         /**
   141         /**
   142         * Returns call duration time
   142         * Returns call duration time
   143         * @param aDuration the duration value of the call
   143         * @param aDuration the duration value of the call
   144         */    
   144         */    
   145         void GetCallDuration( TTimeIntervalSeconds& aDuration );
   145         void GetCallDuration( TTimeIntervalSeconds& aDuration );