commoninterfaces.h

基于symbian UIQ 的一款古老的飞机游戏。对入门学习很有帮助。

// Copyright (c) Symbian Ltd 2008. All rights reserved.

#ifndef __COMMOMINTERFACES_H__
#define __COMMOMINTERFACES_H__

#include <e32cmn.h>
#include <bttypes.h>
#include <btextnotifiers.h>
#include <es_sock.h>
#include <bt_sock.h>


//INTERFACE DECLARATIONS

//===================================================================================
/**
* CBluetoothConnectionBase
* Virtual base class that wraps the common Connector/Responder's functionality
*/
class CBluetoothConnectionBase: public CActive
	{
public:
	/**
	* Destructor
	*/
	virtual ~CBluetoothConnectionBase();
	
	/**
	* Send the data to the remote BT device
	* @param aData	A descriptor for the data being sent to the remote BT device
	*/
	virtual void SendData(const TDesC8& aData)=0;
	
	/**
	* Kick off the state machine of the Connector/Responder
	*/
	virtual void StartL()=0;
	
	/**
	* Return the object handle
	* @return The object's handle
	*/
	inline TInt Handle() const {return iHandle;};
	
	/**
	* Query to find out if CBluetoothConnectionBase is either a Master or Slave
	* @return  Etrue if Master
	*/
	inline TBool Master() const {return iMaster;};
	
protected:
	/**
	* Constructor
	* @param aMaster ETrue if the derived class is a Connector
	*/
	CBluetoothConnectionBase(TBool aMaster);
	
protected:
	/**
	* Flag for querying if the object is a Master
	*/
	TBool iMaster;
	
	/**
	* Object's handle
	*/
	TInt iHandle;
	};

//===================================================================================

/**
* MBluetoothServiceSearcherObserver
* Interface for notifying service search events
*/
class MBluetoothServiceSearcherObserver
	{
public:
	/**
	* Callback to notify the caller the completion of the service search.
	* @param aPort	 On succesfull return the RFCOMM's port to use
	* @param aError	 KErrNone if succesfull, otherwise one of the system errors
	*/
	virtual void OnServiceSearchComplete(TInt aPort, TInt aError)=0;
	};

//===================================================================================

/**
* MSocketConnectorObserver
* Iterface for notifying connection event
*/
class MSocketConnectorObserver
	{
public:
	/**
	* Callback to notify the caller the completion of the connection to the remote BT device
	* @param aError	 KErrNone if succesfull, otherwise one of the system errors
	*/
	virtual void OnSockConnectionComplete(TInt aError)=0;
	};

//===================================================================================
	
/**
* MBluetoothConnectorObserver
* Interface for notifying to the status of the connection to the remote BT device
* and to notify incoming/sending data completion 
*/
class MBluetoothObserver
	{
public:
	/**
	* Report any connection error
	* @param aConnHandle 	The handle of the Connector/Responder
	* @param aError	 An error
	*/
	virtual void ConnectionErr(const TInt aConnHandle, const TInt aError)=0;
	
	/**
	* Notify when data arrives from the remote BT device
	* @param aConnHandle The handle of the Connector/Responder
	* @param aData Description containing the data arrived from the remote BT device 
	*/
	virtual void DataReceived(const TInt aConnHandle, const TDesC8& aData)=0;
	
	/**
	* Notify when the sending data to the remote BT device is succesfull
	* @param aConnHandle The handle of the Connector/Responder	
	*/
	virtual void SendDataComplete(const TInt aConnHandle)=0;
	};

//===================================================================================

/**
* MBluetoothDeviceDiscovererObserver
* Interface for notifying the remote BT device's address selected by the user using the CQBTUISelectDialog
*/
class MBluetoothDeviceDiscovererObserver
	{
public:
	/**
	* Notify any error during device discovering
	* @param aError An error
	*/
	virtual void OnDeviceDiscoveryErr(const TInt aError)=0;
	
	/**
	* Call when the user selects a BT device in range
	* @param aResponse Pckgbuf to retrieve the response from the device selection dialog via CQBTUISelectDialog
	*/
	virtual void OnDeviceDiscoveryComplete(const TBTDeviceResponseParamsPckg& aResponse)=0;
	};

//===================================================================================

/**
* MBluetoothServiceAdvertiserObserver
* Interface for notifying when a service advertising is completed
*/
class MBluetoothServiceAdvertiserObserver
	{
public:
	/**
	* Report any error during service advertising
	* @param aError An error
	*/
	virtual void ReportAdvertiserErr(TInt aError)=0;
	
	/**
	* Service advertising completed succesfully
	*/
	virtual void AdvertiserComplete()=0;
	};

//===================================================================================

/**
* MSocketWriterReaderObserver
* Interface for sending/receiveing data completion
*/
class MSocketWriterReaderObserver
	{
public:
	/**
	* Sending data completed
	* @param aError An error
	*/
	virtual void WriteComplete(TInt aError)=0;
	
	/**
	* Notify the data arrived from the remote BT device 
	* @param aData A descriptor for the data being received from the remote BT device
	* @param aError An error
	*/
	virtual void ReportData(const TDesC8& aData, TInt aError)=0;
	};

//===================================================================================
#endif // __COMMOMINTERFACES_H__