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 MUSENGCLIPSESSIONOBSERVER_H

    20 #define MUSENGCLIPSESSIONOBSERVER_H

    21 

    22 // INCLUDES

    23 #include <e32def.h>

    24 

    25 // CLASS DECLARATION

    26 

    27 /**

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

    29 *  if they wish to receive clip sharing specific events.

    30 *

    31 *  This observer is set using CMusEngClipSession::SetSessionObserver function.

    32 *

    33 */

    34 class MMusEngClipSessionObserver

    35     {

    36     public: 

    37     

    38         /**

    39 	    * Indicates that shared clip has ended.

    40 	    */

    41         virtual void EndOfClip() = 0;        

    42         

    43         /**

    44 	    * Indicates that chosen clip must be transcoded before sharing.

    45 	    * @param aDueUnknownRemoteCapabilities, ETrue if transcoding is needed because

    46 	    *  it is unknown whether remote end can support current format of clip.

    47 	    */

    48         virtual void TranscodingNeeded(TBool aDueUnknownRemoteCapabilities) = 0;

    49         

    50         /**

    51 	    * Indicates that transcoding has progressed.

    52 	    * @param aPercentage Percentage of completion

    53 	    */

    54         virtual void TranscodingProgressed( TInt aPercentage ) = 0;

    55         

    56         /**

    57 	    * Indicates that transcoding has successfully complited

    58 	    * but session establishment is not yet proceeding.

    59 	    */

    60         virtual void TranscodingCompletedInit() = 0;

    61         

    62         /**

    63 	    * Indicates that transcoding has successfully complited

    64 	    * and session establishment continues.

    65 	    */

    66         virtual void TranscodingCompletedFinalize() = 0;

    67         

    68         /**

    69 	    * Indicates that transcoding has failed.

    70 	    */

    71         virtual void TranscodingFailed() = 0;

    72         

    73         /**

    74 	    * Handle specific case that rewinding from end of file.

    75 	    */

    76         virtual void RewindFromEndL() = 0;

    77     };

    78 

    79 #endif