diff -r b31261fd4e04 -r ccd8e69b5392 tsrc/musmanagerstub/inc/musmanagerstub.h --- a/tsrc/musmanagerstub/inc/musmanagerstub.h Tue Feb 02 00:09:07 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,191 +0,0 @@ -/* -* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies). -* All rights reserved. -* This component and the accompanying materials are made available -* under the terms of "Eclipse Public License v1.0" -* which accompanies this distribution, and is available -* at the URL "http://www.eclipse.org/legal/epl-v10.html". -* -* Initial Contributors: -* Nokia Corporation - initial contribution. -* -* Contributors: -* -* Description: ?Description -* -*/ - - -#ifndef MUSMANAGER_H -#define MUSMANAGER_H - - -#include "musmanagercommon.h" - -#include -#include - - - -class CMusManagerImpl; - -#undef IMPORT_C -#define IMPORT_C -/** - * ?one_line_short_description - * - * ?more_complete_description - * - * @lib ?library - * @since S60 ?S60_version *** for example, S60 v3.0 - */ -class CMusManager : public CBase - { -public: - enum TRequestType - { - ESipOptions = 0x1028238D, - ESipInviteDesired = 0x10282391, - ESipInviteNotDesired = 0x1028238D - }; - -public: // first phase constructors - - IMPORT_C static CMusManager* NewL(); - - IMPORT_C static CMusManager* NewLC(); - - virtual ~CMusManager(); - - -public: // new functions - /** - * This function causes following things: - * - MS manager starts to monitor call and network state - * - In case of active call, MS manager - * - resolves the SIP address of the remote host - * - makes a capability query (SIP OPTIONS) - * - * This function must be called before a MultimediaSharing - * session is tried to be established. Otherwise, the internal state of - * MultimediaSharing will remain as undefined. In that state, - * MultimediaSharing Manager will not start the application. - * - * @since S60 v3.2 - */ - IMPORT_C void ExamineAvailabilityL(); - - /** - * This function allows clients to monitor the availability - * status of MultimediaSharing. - * - * The request will return when the availability status changes. - * - * @since S60 v3.2 - * @param aStatus TRequestStatus object of the listener. - * @param aAvailabilityStatus Contains the new status, when request complete. - */ - IMPORT_C void MonitorAvailabilityL( - TRequestStatus& aRequestStatus, - MultimediaSharing::TMusAvailabilityStatus& aAvailabilityStatus ); - - /** - * Cancels the currently active availability monitoring. - * - * @since S60 v3.2 - */ - IMPORT_C void CancelMonitoring(); - - /** - * Returns the current availability status. - * - * @since S60 v3.2 - * @return The current availability status. - */ - IMPORT_C MultimediaSharing::TMusAvailabilityStatus AvailabilityL(); - - -public: // functions related to application start-up - - /** - * This function allows clients to request coomand's to be executed by - * the MUS manager server. - * - * In erroneous cases, this function will leave - * with an error code that describes the error. Positive leave codes - * are defined in MultimediaSharing::TMusAvailabilityStatus. - * - * @param aRequest Defines the coomand type. - * - */ - IMPORT_C void HandleCommandL( MultimediaSharing::TCommandType aCommandType ); - - - /** - * Orders MultimediaSharing subsystem to handle a SIP request. - * In some cases, this function call starts the application. - * - * In erroneous cases, this function will leave - * with an error code that describes the error. Positive leave codes - * are defined in MultimediaSharing::TMusAvailabilityStatus. - * - * @param aRequest Defines the request type. - * Must be SipStrConsts::EOptions or SipStrConsts::EInvite - */ - IMPORT_C void HandleSipRequestL( TRequestType aRequestType ); - - /** - * Starts the MultimediaSharing application - * - * If the application can't be started, this function will leave - * with an error code that describes the error. Positive leave codes - * are defined in MultimediaSharing::TMusAvailabilityStatus. - * - * @param aUseCase Describes the desired use case and - affects the default view. - */ - IMPORT_C void StartApplicationL( MultimediaSharing::TMusUseCase aUseCase ); - - -public: // functions to related application closing - - /** - * This function causes the application to get a stop signal. - * Application will close itself smoothly. - * - * @since S60 v3.2 - */ - IMPORT_C void StopApplicationL(); - -private: // second phase constructors - - CMusManager(); - - void ConstructL(); - - -public: // new functions for testing purposes - - IMPORT_C static void SetStartError( TInt aError ); - - IMPORT_C static void SetAvailability( TInt aAvailability ); - - IMPORT_C static void SetUseCase( MultimediaSharing::TMusUseCase aUseCase ); - - IMPORT_C static MultimediaSharing::TMusUseCase UseCase(); - -public: // data - - MultimediaSharing::TMusAvailabilityStatus iAvailability; - - TInt iExamineLeaveCode; - - TInt iStartError; - - TRequestStatus* iStatus; - - TRequestType iHandleSipRequestLCalledWithParam; - - }; - -#endif // ? C_CLASSNAME_H