/*
* Copyright (c) 2008-2009 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: Command object factory
*
*/
#ifndef T_GLXMEDIAKEYUTILITY_H
#define T_GLXMEDIAKEYUTILITY_H
#include <ipvideo/ViaPlayerMediaKeyListener.h> // MViaPlayerMediaKeyListener
/**
* TGlxMediaKeyUtility
*
* This is a utility class that simplifies the use of RemCon
* A problem results when an application instantiates more than one
* Instance of RemCon.
*
* This class enables other components to use the same instance on RemCon that the
* It inherits from MRemConCoreApiTargetObserver and links with the RemConCoreApi.lib
* It inherits from MViaPlayerMediaKeyListener and links with the ViaPlayerUtilities.lib
* It interperets the keys from RemCon via the MediaKeyEventL method and translates them
* to standard key which get added to the application event queue for normal processing
* (Via OfferKeyEventL).
*
* Note that TranslateKeyEvent and DispatchKeyEvent methods are virtual.
* So if different behaviour is required just create a Sub class and overide
* those metheds are needed.
*
*/
class CGlxMediaKeyUtility : public CBase, public MViaPlayerMediaKeyListener
{
public:
/**
* Standard NewLC class used for Instantiation
* @return Instance of Itself, also on the cleanup stack
*/
static CGlxMediaKeyUtility* NewLC();
/**
* Standard NewL class used for Instantiation
* @return Instance of Itself
*/
static CGlxMediaKeyUtility* NewL();
/**
* Destructor
*/
virtual ~CGlxMediaKeyUtility();
protected:
/**
* Creates KeyEvent and places it on the application event queue.
*
* @param aKeyCode this is the action (up, down or click).
* @param aScanCode this is the TStdScanCode for the Key Event.
*/
void DoSimulateKeyEvent( TRawEvent::TType aKeyCode, TStdScanCode aScanCode );
/**
* Converts RemCon key types to standard key types
*
* @param aOperationId the RemCon key type
*
* @return the standard key type
*/
virtual TStdScanCode TranslateKeyEvent(TRemConCoreApiOperationId aOperationId);
/**
* Places the Key Event in the applications quere acording to aButtonAct (up, down, click)
*
* @param aButtonAct (up, down or click)
* @param aScanCode the standard scan code for a key
*/
virtual void DispatchKeyEvent( TRemConCoreApiButtonAction aButtonAct, TStdScanCode aScanCode);
private:
CGlxMediaKeyUtility();
void ConstructL();
private: // from MViaPlayerMediaKeyListener
void MediaKeyEventL(TRemConCoreApiOperationId aOperationId,
TRemConCoreApiButtonAction aButtonAct );
};
#endif