1 /*

     2 * Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  

    15 *

    16 */

    17 

    18 

    19 #ifndef MMCERTPOBSERVER_H

    20 #define MMCERTPOBSERVER_H

    21 

    22 // INCLUDES

    23 #include <e32std.h>  

    24 

    25 // FORWARD DECLARATIONS

    26 class CMceMediaStream;

    27 class CMceRtpSource;

    28 

    29 // CLASS DECLARATION

    30 

    31 /**

    32 *  An interface to be implemented by users of MCE if they wish to receive

    33 *  events from CMceRtpSource.

    34 *

    35 *  This observer is set using CMceManager::SetRtpObserver function.

    36 *

    37 *  @lib mceclient.lib

    38 */

    39 class MMceRtpObserver

    40 	{

    41 	public: 

    42         /**

    43         * Callback function to indicate that an RTCP sender report

    44 		* has been received.

    45         * @param aSession the session that has changed

    46         * @param aStream the stream that has changed

    47         */

    48         virtual void SRReceived(

    49 				    CMceSession& aSession,

    50 					CMceMediaStream& aStream) = 0;

    51 

    52         /**

    53         * Callback function to indicate that an RTCP receiver report

    54 		* has been received.

    55         * @param aSession the session that has changed

    56         * @param aStream the stream that has changed

    57         */

    58         virtual void RRReceived(

    59 				    CMceSession& aSession,

    60 					CMceMediaStream& aStream) = 0;

    61 		

    62         /**

    63         * Callback function to indicate inactivity timer timeout

    64 		* has occurred. Timer is disabled after the timeout.

    65         * @param aStream, the session that has changed.

    66         * @param aSource, the source that the timeout occurred.

    67         */

    68         virtual void InactivityTimeout(

    69 					CMceMediaStream& aStream,

    70 					CMceRtpSource& aSource) = 0;    

    71 

    72         /**

    73         * Callback function to indicate that spesified CMceRtpSource has

    74         * received RTP from a new synchronization source (SSRC).

    75         * @param aStream the stream that new SSRC was added to

    76         * @param aSource the source that new SSRC was added to

    77         * @param aSsrc added SSRC identifier

    78         */			

    79         virtual void SsrcAdded(

    80                         CMceMediaStream& aStream,

    81                         CMceRtpSource& aSource,

    82                         TUint aSsrc ) = 0;       

    83 	    

    84         /**

    85         * Callback function to indicate that spesified CMceRtpSource has

    86         * received RTP BYE message from a spesified synchronization 

    87         * source (SSRC).

    88         * @param aStream the stream that SSRC was removed from

    89         * @param aSource the source that SSRC was removed from

    90         * @param aSsrc removed SSRC identifier

    91         */	

    92         virtual void SsrcRemoved(

    93                         CMceMediaStream& aStream,

    94                         CMceRtpSource& aSource,

    95                         TUint aSsrc ) = 0;   

    96 	};

    97 

    98 #endif