1 /*

     2 * Copyright (c) 2006-2006 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:  Observer interface for RDS events

    15 *

    16 */

    17 

    18 

    19 #ifndef MFMRADIORDSOBSERVER_H

    20 #define MFMRADIORDSOBSERVER_H

    21 

    22 class MFMRadioRdsObserver

    23     {

    24 public:

    25 

    26     /**

    27      * Programme Service data available

    28      *

    29      * @param aProgramService The new Programme Service data

    30      */  

    31     virtual void RdsDataProgrammeService( const TDesC& aProgramService ) = 0;

    32     

    33     /**

    34      * Reports if the programme service name is detected as dynamically changing or not

    35      *

    36      * @param aStatic ETrue if the name is static, EFalse if it is dynamic

    37      */  

    38     virtual void RdsDataPsNameIsStatic( TBool aStatic ) = 0;

    39     

    40     /**

    41      * Radio text data available

    42      *

    43      * @param aRadioText The new Radio text data

    44      */  

    45     virtual void RdsDataRadioText( const TDesC& aRadioText ) = 0;

    46 

    47     /**

    48      * Radio text plus data available

    49      *

    50      * @param aRTPlusClass The type of RT+ text

    51      * @param aRadioTextPlus The new Radio text data

    52      */  

    53     virtual void RdsDataRadioTextPlus( const TInt aRTPlusClass, const TDesC& aRadioTextPlus ) = 0;

    54        

    55     /**

    56      * Notifies of the beginning of Alternate Frequency search

    57      */

    58     virtual void RdsAfSearchBegin() = 0;

    59     

    60     /**

    61      * Notifies of the completed Alternate Frequency search

    62      *

    63      * @param aFrequency The new frequency

    64      * @param aError A standard system error code

    65      */

    66     virtual void RdsAfSearchEnd( TUint32 aFrequency, TInt aError ) = 0;

    67 

    68     /**

    69      * Notifies of the changed Alternate Frequency search state

    70      *

    71      * @param aEnabled ETrue if AF search was enabled, otherwise EFalse

    72      */

    73     virtual void RdsAfSearchStateChange( TBool aEnabled ) = 0;

    74 

    75     /**

    76      * Notifies of the status of RDS signal

    77      * 

    78      * @param aAvailable is RDS available

    79      */

    80     virtual void RdsAvailable( TBool aAvailable ) = 0;

    81     };

    82 

    83 #endif // MFMRADIORDSOBSERVER_H