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 MUSHENGSESSIONOBSERVER_H

    20 #define MUSHENGSESSIONOBSERVER_H

    21 

    22 

    23 #include <e32std.h>

    24 

    25 // CLASS DECLARATION

    26 

    27 /**

    28 * An interface to be implemented by users of Multimedia Sharing Engine if 

    29 * they wish to receive events from session and streaming state changes.

    30 *

    31 * @lib museng.lib

    32 * @since S60 v3.2

    33 */

    34 class MMusEngSessionObserver

    35     {

    36 

    37     public:

    38 

    39         /**

    40         * Indicates that incoming or outgoing session has been established.

    41         *

    42         * @since S60 v3.2

    43         */

    44         virtual void SessionEstablished() = 0;

    45 

    46         /**

    47         * Indicates that session has been terminated.

    48         * After this function call session object must deleted.

    49         * Function is synchronous, use active object which actives

    50         * delete.

    51         *

    52         * @since S60 v3.2

    53         */

    54         virtual void SessionTerminated() = 0;

    55 

    56         /**

    57         * Current session has lost network connection.

    58         *

    59         * @since S60 v3.2

    60         */

    61         virtual void SessionConnectionLost() = 0; 

    62 

    63         /**

    64         * Undefined exception has occurred. Session is useless and must be

    65         * deleted. Function is synchronous, use active object which actives

    66         * delete.

    67         *

    68         * @since S60 v3.2

    69         */

    70         virtual void SessionFailed() = 0;

    71 

    72         /**

    73         * Current stream state is changed to idle meaning that

    74         * we are not sending or receiving RTP.

    75         *

    76         * @since S60 v3.2

    77         */

    78         virtual void StreamIdle() = 0;

    79 

    80         /**

    81         * Current session state is changed to idle.

    82         *

    83         * @since S60 v3.2

    84         */

    85         virtual void StreamStreaming() = 0;        

    86 

    87         /**

    88         * Update time information of this session

    89         *

    90         * @since S60 v3.2

    91         */

    92         virtual void SessionTimeChanged( const TTimeIntervalSeconds& aSeconds ) = 0;

    93         

    94         /**

    95         * RTCP inactivity timeout has occurred.

    96         *

    97         * @since S60 v3.2

    98         */

    99         virtual void InactivityTimeout() = 0;

   100     };

   101 

   102 #endif