1 /*

     2 * Copyright (c) 2007 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:  Video player observer interface.

    15 *

    16 */

    17 

    18 

    19 #ifndef M_BUBBLEVIDEOPLAYEROBSERVER_H

    20 #define M_BUBBLEVIDEOPLAYEROBSERVER_H

    21 

    22 /**

    23  *  Video player observer interface.

    24  *

    25  *

    26  *  @lib BubbleManager

    27  *  @since S60 v3.2

    28  */

    29 class MBubbleVideoPlayerObserver  

    30     {

    31     public:

    32         // Enumerates different failure events.

    33         //

    34         enum TBubbleVideoPlayerErrorEvent

    35             {

    36             EVideoPlayerInitializingFailure, // Failure during initialization

    37             EVideoPlayerPlayingFailure // Failure during playback

    38             };

    39         

    40         /**

    41         * This method is called when playing error occurs.

    42         *

    43         * @since S60 v3.2

    44         * @param aEvent Error event.

    45         * @param aError Error code.

    46         */

    47         virtual void HandleVideoPlayerError( 

    48             TBubbleVideoPlayerErrorEvent aEvent,

    49             TInt aError ) = 0;

    50 

    51         /**

    52         * This method is called when player initialization is complete.

    53         *

    54         * @since S60 v3.2

    55         */

    56         virtual void HandleVideoPlayerInitComplete() = 0;

    57 

    58         /**

    59         * This method is called when video clip has played to end.

    60         *

    61         * @since S60 v3.2

    62         */

    63         virtual void HandleVideoPlayerPlayingComplete() = 0;

    64         

    65         /**

    66         * This method is called when player knows exact blitting

    67         * area, the screen area that will be covered by video image.

    68         * Observer may relayout the container window accordingly.

    69         *

    70         * @since S60 v3.2

    71         * @param aBlitRect Blit rectangle relative to screen.

    72         */

    73         virtual void HandleVideoPlayerBlittingAreaDefined( 

    74             const TRect& aBlitRect ) = 0;

    75     };

    76 

    77 #endif // M_BUBBLEVIDEOPLAYEROBSERVER_H

    78 

    79 // End of File