coreapplicationuis/SysAp/Inc/sysapaudioroutingobserver.h
author hgs
Tue, 29 Jun 2010 10:40:11 +0300
changeset 46 eea20ed08f4b
permissions -rw-r--r--
201025_02
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
46
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
     1
/*
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
     2
* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). 
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
     3
* All rights reserved.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
     8
*
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
     9
* Initial Contributors:
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    11
*
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    12
* Contributors:
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    13
*
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    14
* Description:  Observes audio output routing changes
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    15
*
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    16
*/
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    17
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    18
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    19
#ifndef SYSAPAUDIOROUTINGONBSERVER_H
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    20
#define SYSAPAUDIOROUTINGONBSERVER_H
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    21
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    22
#include <MTelephonyAudioRoutingObserver.h>
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    23
class CSysApAppUi;
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    24
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    25
/**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    26
 *  ?one_line_short_description
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    27
 *
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    28
 *  ?more_complete_description
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    29
 *
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    30
 *  @lib ?library
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    31
 *  @since S60 ?S60_version *** for example, S60 v3.0
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    32
 */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    33
class CSysApAudioRoutingObserver : public CBase,
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    34
                                   public MTelephonyAudioRoutingObserver
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    35
    {
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    36
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    37
public:
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    38
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    39
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    40
    * Symbian two-phased constructor.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    41
    * 
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    42
    * @param aSysApAppUi    reference to System Application's application UI class
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    43
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    44
    static CSysApAudioRoutingObserver* NewL( CSysApAppUi& aSysApAppUi );
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    45
    
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    46
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    47
    * Destructor.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    48
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    49
    virtual ~CSysApAudioRoutingObserver();
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    50
    
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    51
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    52
    * Returns whether audio output is routed to IHF.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    53
    * 
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    54
    * @since S60 3.2
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    55
    * @return   TBool   ETrue audios routed to IHF
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    56
    *                   EFalse audios not routed to IHF.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    57
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    58
    TBool IhfEnabled() const;
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    59
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    60
private: // from MTelephonyAudioRoutingObserver
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    61
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    62
    * Signals that available audio outputs have changed.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    63
    *
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    64
    * @since S60 3.2
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    65
    * @param CTelephonyAudioRouting& aTelephonyAudioRouting reference.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    66
    * @see MTelephonyAudioRoutingObserver::AvailableOutputsChanged
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    67
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    68
    virtual void AvailableOutputsChanged( CTelephonyAudioRouting& aTelephonyAudioRouting);
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    69
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    70
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    71
    * Signals that current output has changed. 
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    72
    *
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    73
    * @since 60 3.2
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    74
    * @param CTelephonyAudioRouting& aTelephonyAudioRouting reference.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    75
    * @see MTelephonyAudioRoutingObserver::OutputChanged
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    76
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    77
    virtual void OutputChanged( CTelephonyAudioRouting& aTelephonyAudioRouting);
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    78
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    79
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    80
    * Signals that CTelephonyAudioRouting::SetOutputL request issued by this
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    81
    * application (on CTelephonyAudioRouting instance) was serviced by the
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    82
    * Adaptation.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    83
    *
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    84
    * @since S60 3.2
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    85
    * @param CTelephonyAudioRouting& aTelephonyAudioRouting reference.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    86
    * @param aError KErrNone if output requested by application is set, else
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    87
    *        system-wide error code.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    88
    * @see MTelephonyAudioRoutingObserver::SetOutputComplete
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    89
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    90
    virtual void SetOutputComplete( CTelephonyAudioRouting& aTelephonyAudioRouting, TInt aError);
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    91
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    92
private:
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    93
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    94
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    95
    * C++ default constructor.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    96
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    97
    CSysApAudioRoutingObserver();
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    98
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
    99
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   100
    * Constructor.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   101
    * 
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   102
    * @param aSysApAppUi    reference to System Application's application UI class
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   103
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   104
    CSysApAudioRoutingObserver( CSysApAppUi& aSysApAppUi );
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   105
    
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   106
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   107
    * Symbian 2nd-phase constructor.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   108
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   109
    void ConstructL();
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   110
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   111
private: // data
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   112
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   113
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   114
    * Telephony audio routing instance.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   115
    * Own.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   116
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   117
    CTelephonyAudioRouting* iTelephonyAudioRouting;
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   118
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   119
    /**
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   120
    * System Application application UI class.
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   121
    */
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   122
    CSysApAppUi& iSysApAppUi;
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   123
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   124
    };
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   125
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   126
eea20ed08f4b 201025_02
hgs
parents:
diff changeset
   127
#endif // SYSAPAUDIOROUTINGONBSERVER_H