/*

* Copyright (c) 2008-2008 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:  Java RemCon Observer Active Object

*

*/

#ifndef JAVAREMCONOBSERVER_H

#define JAVAREMCONOBSERVER_H

#include <e32base.h>

#include <remconcoreapi.h>

#include <remconcoreapitargetobserver.h>

#include <e32msgqueue.h>

enum TMethodType

{

    EMethodNone = 0,

    EMethodMrccatoCommand = 1,

    EMethodMrccatoPlay = 2,

};

/**

 * Class is active object which should be created if some API wants use

 * RemCon API for receiving events

 *

 * Java RunTime needs to listen to various events like volume key press,

 * media key press and so on. For this purpose, various modules

 * in Java middleware register with CRemConCoreApiTarget to get events

 * to the observer MRemConCoreApiTargetObserver.

 * For this to happen, a target session has to be opened to RemCon,

 * which is done via CRemConInterfaceSelector::OpenTargetL(). At present,

 * whichever module wants it (say MMAPI, LCDUI etc) goes ahead and registers

 * by calling CRemConInterfaceSelector::OpenTargetL(). However when someother

 * module also calls the same, the OpenTargetL() returns KErrInUse as in

 * Java all modules are in one single process and one process can have

 * only one target session open to RemCon. This means that only one of the

 * required modules will get the events needed.

 *

 * Class provides common callback API for events from RemCon

 *

 *  @lib javaremconobserver

 *  @since S60 v3.2

 */

class CJavaRemConObserver : public CActive

{

private:

    class TJavaRemConMessage

    {

    public:

        TRemConCoreApiPlaybackSpeed iSpeed;

        TRemConCoreApiButtonAction iButtonAct;

        TRemConCoreApiOperationId iOperationId;

        TInt iMethod;

    };

public:

    /**

    * Constructor

    *

    * @since S60 v3.2

    * @param aObserver Set observer, not owned

    */

    IMPORT_C static CJavaRemConObserver* NewL(

        MRemConCoreApiTargetObserver& iObserver);

    CJavaRemConObserver(MRemConCoreApiTargetObserver& iObserver);

    ~CJavaRemConObserver();

    void AddPlayMessage(TRemConCoreApiPlaybackSpeed aSpeed,

                        TRemConCoreApiButtonAction aButtonAct);

    void AddCommandMessage(TRemConCoreApiOperationId aOperationId,

                           TRemConCoreApiButtonAction aButtonAct);

protected:

    void ConstructL();

private:

    void IssueRequest();

    // From CActive

    void RunL();

    void DoCancel();

private:

    /**

    * Observer called in RunL

    */

    MRemConCoreApiTargetObserver& iObserver;

    /**

    * Message queue for storing events from RemCon

    */

    RMsgQueue<TJavaRemConMessage> iQueue;

};

#endif // JAVAREMCONOBSERVER_H