phonesrv_plat/converged_call_engine_api/inc/mcceconferencecall.h
branchRCL_3
changeset 20 987c9837762f
parent 19 7d48bed6ce0c
equal deleted inserted replaced
19:7d48bed6ce0c 20:987c9837762f
    54     * be referenced anymore from PE and CCE must not call observer after this call!
    54     * be referenced anymore from PE and CCE must not call observer after this call!
    55     * @since S60 3.2
    55     * @since S60 3.2
    56     */
    56     */
    57     virtual TInt Release() = 0;
    57     virtual TInt Release() = 0;
    58 
    58 
    59     /**
    59 	/**
    60     * Adds new call to conference call.
    60 	* Adds new call to conference call.
    61     * @since S60 3.2
    61 	* @since S60 3.2
    62     * @param aCall Call to be added to conference.
    62 	* @param aCall Call to be added to conference.
    63     * @return none 
    63 	* @return none 
    64     * @leave In case of an error system wide error code
    64 	* @leave In case of an error system wide error code
    65     * @leave KErrAlreadyExists call is already part of conference.
    65 	* @leave KErrAlreadyExists call is already part of conference.
    66     * @leave KErrNotReady In case conference is not on hold or idle.
    66 	* @leave KErrNotReady In case conference is not on hold or idle.
    67     * @pre Conference call state is MCCEConferenceCallObserver::ECCEConferenceHold or 
    67 	* @pre Conference call state is MCCEConferenceCallObserver::ECCEConferenceHold or 
    68     * MCCEConferenceCallObserver::ECCEConferenceIdle. 
    68 	* MCCEConferenceCallObserver::ECCEConferenceIdle. 
    69     * @post Added call is notified calling MCCEConferenceCallObserver::CallEventOccurred.
    69 	* @post Added call is notified calling MCCEConferenceCallObserver::CallEventOccurred.
    70     * @post If conference becomes active regarding its internal plug-in based logic state is 
    70 	* @post If conference becomes active regarding its internal plug-in based logic state is 
    71     * MCCEConferenceCallObserver::ECCEConferenceActive.
    71 	* MCCEConferenceCallObserver::ECCEConferenceActive.
    72     */
    72 	*/
    73     virtual void AddCallL( MCCECall& aCall ) = 0;
    73     virtual void AddCallL( MCCECall& aCall ) = 0;
    74      
    74      
    75     /**
    75 	/**
    76     * Removes call from conference call. 
    76 	* Removes call from conference call. 
    77     * @since S60 3.2
    77 	* @since S60 3.2
    78     * @param aCall Call to be removed from conference
    78 	* @param aCall Call to be removed from conference
    79     * @return none
    79 	* @return none
    80     * @leave In case of an error system wide error code
    80 	* @leave In case of an error system wide error code
    81     * @leave KErrNotFound call was not part of conference
    81 	* @leave KErrNotFound call was not part of conference
    82     * @leave KErrNotReady In case conference is not connected 
    82 	* @leave KErrNotReady In case conference is not connected 
    83     * (MCCEConferenceCallObserver::ECCEConferenceActive) state.
    83 	* (MCCEConferenceCallObserver::ECCEConferenceActive) state.
    84     * @pre Conference call state is MCCEConferenceCallObserver::ECCEConferenceActive or 
    84 	* @pre Conference call state is MCCEConferenceCallObserver::ECCEConferenceActive or 
    85     * MCCEConferenceCallObserver::ECCEConferenceIdle. 
    85 	* MCCEConferenceCallObserver::ECCEConferenceIdle. 
    86     * @post Removed call is notified calling MCCEConferenceCallObserver::CallEventOccurred.
    86 	* @post Removed call is notified calling MCCEConferenceCallObserver::CallEventOccurred.
    87     * @post If conference becomes idle regarding its internal plug-in based logic state is 
    87 	* @post If conference becomes idle regarding its internal plug-in based logic state is 
    88     * MCCEConferenceCallObserver::ECCEConferenceIdle. 
    88 	* MCCEConferenceCallObserver::ECCEConferenceIdle. 
    89     * 
    89 	* 
    90     */
    90 	*/
    91     virtual void RemoveCallL( MCCECall& aCall ) = 0;
    91 	virtual void RemoveCallL( MCCECall& aCall ) = 0;
    92 
    92 
    93     /**
    93     /**
    94     * Returns call count of the conference call. 
    94     * Returns call count of the conference call. 
    95     *
    95     *
    96     * @since S60 3.2
    96     * @since S60 3.2
   134     */
   134     */
   135     virtual TInt Swap() = 0;
   135     virtual TInt Swap() = 0;
   136      
   136      
   137     /**
   137     /**
   138     * Private call with one call from conference call.
   138     * Private call with one call from conference call.
   139     * @since S60 3.2
   139 	* @since S60 3.2
   140     * @param aCall
   140 	* @param aCall
   141     * @return none
   141     * @return none
   142     * @leave In case of an error system wide error code
   142 	* @leave In case of an error system wide error code
   143     * @leave KErrNotFound call was not part of conference
   143 	* @leave KErrNotFound call was not part of conference
   144     * @post After successful actions conference call state is MCCEConferenceCallObserver::ECCEConferenceHold 
   144 	* @post After successful actions conference call state is MCCEConferenceCallObserver::ECCEConferenceHold 
   145     * (if idle state will not be applied as call count decreases) and private call will become active one. 
   145 	* (if idle state will not be applied as call count decreases) and private call will become active one. 
   146     */
   146 	*/
   147     virtual void GoOneToOneL( MCCECall& aCall ) = 0;
   147 	virtual void GoOneToOneL( MCCECall& aCall ) = 0;
   148 
   148 
   149     /**
   149     /**
   150     * Gets conference participants
   150     * Gets conference participants
   151     * @since S60 3.2
   151     * @since S60 3.2
   152     * @param aCallArray Reference to call array
   152     * @param aCallArray Reference to call array
   163     * @param aObserver  Reference to observer interface implementation.
   163     * @param aObserver  Reference to observer interface implementation.
   164     * @return none
   164     * @return none
   165     */
   165     */
   166     virtual void SetObserver( const MCCEConferenceCallObserver& aObserver ) = 0;
   166     virtual void SetObserver( const MCCEConferenceCallObserver& aObserver ) = 0;
   167 
   167 
   168     /**
   168 	/**
   169     * Returns duration of a conference call. 
   169 	* Returns duration of a conference call. 
   170     * CCE will count duration from connected state to idle state.
   170 	* CCE will count duration from connected state to idle state.
   171     *
   171 	*
   172     * @since S60 v3.2
   172 	* @since S60 v3.2
   173     * @param none
   173 	* @param none
   174     * @return On return contains the call duration in seconds.
   174 	* @return On return contains the call duration in seconds.
   175     */
   175 	*/
   176     virtual TTimeIntervalSeconds CallDuration() const = 0;
   176 	virtual TTimeIntervalSeconds CallDuration() const = 0;
   177     };
   177     };
   178 
   178 
   179 
   179 
   180 #endif // MCCECONFERENCECALL
   180 #endif // MCCECONFERENCECALL
   181 
   181