/*

* Copyright (c) 2007 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:  Observes audio output routing changes

*

*/

#ifndef SYSAPAUDIOROUTINGONBSERVER_H

#define SYSAPAUDIOROUTINGONBSERVER_H

#include <MTelephonyAudioRoutingObserver.h>

class CSysApAppUi;

/**

 *  ?one_line_short_description

 *

 *  ?more_complete_description

 *

 *  @lib ?library

 *  @since S60 ?S60_version *** for example, S60 v3.0

 */

class CSysApAudioRoutingObserver : public CBase,

                                   public MTelephonyAudioRoutingObserver

    {

public:

    /**

    * Symbian two-phased constructor.

    * 

    * @param aSysApAppUi    reference to System Application's application UI class

    */

    static CSysApAudioRoutingObserver* NewL( CSysApAppUi& aSysApAppUi );

    /**

    * Destructor.

    */

    virtual ~CSysApAudioRoutingObserver();

    /**

    * Returns whether audio output is routed to IHF.

    * 

    * @since S60 3.2

    * @return   TBool   ETrue audios routed to IHF

    *                   EFalse audios not routed to IHF.

    */

    TBool IhfEnabled() const;

private: // from MTelephonyAudioRoutingObserver

    /**

    * Signals that available audio outputs have changed.

    *

    * @since S60 3.2

    * @param CTelephonyAudioRouting& aTelephonyAudioRouting reference.

    * @see MTelephonyAudioRoutingObserver::AvailableOutputsChanged

    */

    virtual void AvailableOutputsChanged( CTelephonyAudioRouting& aTelephonyAudioRouting);

    /**

    * Signals that current output has changed. 

    *

    * @since 60 3.2

    * @param CTelephonyAudioRouting& aTelephonyAudioRouting reference.

    * @see MTelephonyAudioRoutingObserver::OutputChanged

    */

    virtual void OutputChanged( CTelephonyAudioRouting& aTelephonyAudioRouting);

    /**

    * Signals that CTelephonyAudioRouting::SetOutputL request issued by this

    * application (on CTelephonyAudioRouting instance) was serviced by the

    * Adaptation.

    *

    * @since S60 3.2

    * @param CTelephonyAudioRouting& aTelephonyAudioRouting reference.

    * @param aError KErrNone if output requested by application is set, else

    *        system-wide error code.

    * @see MTelephonyAudioRoutingObserver::SetOutputComplete

    */

    virtual void SetOutputComplete( CTelephonyAudioRouting& aTelephonyAudioRouting, TInt aError);

private:

    /**

    * C++ default constructor.

    */

    CSysApAudioRoutingObserver();

    /**

    * Constructor.

    * 

    * @param aSysApAppUi    reference to System Application's application UI class

    */

    CSysApAudioRoutingObserver( CSysApAppUi& aSysApAppUi );

    /**

    * Symbian 2nd-phase constructor.

    */

    void ConstructL();

private: // data

    /**

    * Telephony audio routing instance.

    * Own.

    */

    CTelephonyAudioRouting* iTelephonyAudioRouting;

    /**

    * System Application application UI class.

    */

    CSysApAppUi& iSysApAppUi;

    };

#endif // SYSAPAUDIOROUTINGONBSERVER_H