1 /*

     2 * Copyright (c) 2009 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 #ifndef MLCSESSIONOBSERVER_H

    19 #define MLCSESSIONOBSERVER_H

    20 

    21 // INCLUDES

    22 #include <e32std.h>

    23 

    24 // FORWARD DECLARATIONS

    25 class MLcSession;

    26 class MLcVideoPlayer;

    27 

    28 // CLASS DECLARATION

    29 /**

    30 * A callback for a Live Comms session related events. 

    31 */

    32 class MLcSessionObserver

    33     {

    34     public:

    35 

    36         /**

    37         * The state of the session has changed.

    38         * The new state can be obtained from the session.

    39         * @param aSession the session

    40         */

    41         virtual void StateChanged( MLcSession& aSession ) = 0;

    42     

    43         /**

    44         * The state of the player has changed.

    45         * The new state can be obtained from the player.

    46         * @param aPlayer the player

    47         */

    48         virtual void StateChanged( MLcVideoPlayer& aPlayer ) = 0;

    49     

    50         /**

    51         * The session has been updated.

    52         * For example a new player has been added.

    53         * @param aSession the updated session

    54         */

    55         virtual void Updated( MLcSession& aSession ) = 0;

    56 

    57         /**

    58         * The session has been updated.

    59         * For example a new control has been added or 

    60         * an existing control has been updated.

    61         * @param aPlayer the updated player

    62         */

    63         virtual void Updated( MLcVideoPlayer& aPlayer ) = 0;

    64     

    65         /**

    66         * The session has failed.

    67         * @param aSession the failed session

    68         * @param aError the reason for the failure 

    69         */

    70     	virtual void Failed( 

    71             MLcSession& aSession,

    72             TInt aError ) = 0;

    73     

    74     	/**

    75     	* The player has failed.

    76     	* @param aPlayer the failed player

    77     	* @param aError the reason for the failure 

    78     	*/

    79         virtual void Failed( 

    80             MLcVideoPlayer& aPlayer, 

    81             TInt aError ) = 0;

    82     

    83         /**

    84         * The session duration time has changed.

    85         * @param aSession the session

    86         * @param aSeconds the current session duration.

    87         */

    88         virtual void SessionTimeChanged( 

    89             MLcSession& aSession,

    90             const TTimeIntervalSeconds& aSeconds ) = 0;

    91     };   

    92     

    93 #endif // MLCSESSIONOBSERVER_H

    94 

    95 // end of file