You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
209 lines
8.0 KiB
209 lines
8.0 KiB
/*==LICENSE==* |
|
|
|
CyanWorlds.com Engine - MMOG client, server and tools |
|
Copyright (C) 2011 Cyan Worlds, Inc. |
|
|
|
This program is free software: you can redistribute it and/or modify |
|
it under the terms of the GNU General Public License as published by |
|
the Free Software Foundation, either version 3 of the License, or |
|
(at your option) any later version. |
|
|
|
This program is distributed in the hope that it will be useful, |
|
but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|
GNU General Public License for more details. |
|
|
|
You should have received a copy of the GNU General Public License |
|
along with this program. If not, see <http://www.gnu.org/licenses/>. |
|
|
|
Additional permissions under GNU GPL version 3 section 7 |
|
|
|
If you modify this Program, or any covered work, by linking or |
|
combining it with any of RAD Game Tools Bink SDK, Autodesk 3ds Max SDK, |
|
NVIDIA PhysX SDK, Microsoft DirectX SDK, OpenSSL library, Independent |
|
JPEG Group JPEG library, Microsoft Windows Media SDK, or Apple QuickTime SDK |
|
(or a modified version of those libraries), |
|
containing parts covered by the terms of the Bink SDK EULA, 3ds Max EULA, |
|
PhysX SDK EULA, DirectX SDK EULA, OpenSSL and SSLeay licenses, IJG |
|
JPEG Library README, Windows Media SDK EULA, or QuickTime SDK EULA, the |
|
licensors of this Program grant you additional |
|
permission to convey the resulting work. Corresponding Source for a |
|
non-source form of such a combination shall include the source code for |
|
the parts of OpenSSL and IJG JPEG Library used as well as that of the covered |
|
work. |
|
|
|
You can contact Cyan Worlds, Inc. by email legal@cyan.com |
|
or by snail mail at: |
|
Cyan Worlds, Inc. |
|
14617 N Newport Hwy |
|
Mead, WA 99021 |
|
|
|
*==LICENSE==*/ |
|
//////////////////////////////////////////////////////////////////// |
|
// pyNetClientComm - python wrapper for plNetClientComm class. |
|
|
|
#ifndef pyNetClientComm_h_inc |
|
#define pyNetClientComm_h_inc |
|
|
|
#include "../plNetClientComm/plNetClientComm.h" |
|
#include "../plStatusLog/plStatusLog.h" |
|
|
|
#include "../FeatureLib/pfPython/pyGlueHelpers.h" |
|
#include <python.h> |
|
|
|
//////////////////////////////////////////////////////////////////// |
|
|
|
class pyAgeLinkStruct; |
|
class pyNetServerSessionInfo; |
|
class pyStatusLog; |
|
class pyNetCore; |
|
|
|
//////////////////////////////////////////////////////////////// |
|
// plNetClientComm Callback Wrappers |
|
|
|
// Message handler for unsolicited msgs or registered |
|
// for specific msg types. |
|
class pyNetClientCommMsgHandler : public plNetClientComm::MsgHandler |
|
{ |
|
public: |
|
PyObject* fPyObject; |
|
pyNetClientCommMsgHandler( PyObject* pyObject ): fPyObject( pyObject ) {} |
|
int HandleMessage( plNetMessage* msg ); |
|
}; |
|
|
|
// Receipt handler for changed msg receipts. |
|
class pyNetClientCommRcptHandler : public plNetClientComm::RcptHandler |
|
{ |
|
public: |
|
PyObject* fPyObject; |
|
pyNetClientCommRcptHandler( PyObject* pyObject ): fPyObject( pyObject ) {} |
|
void HandleMsgReceipt( plNetCoreMsgReceipt* rcpt ); |
|
}; |
|
|
|
//////////////////////////////////////////////////////////////////// |
|
|
|
class pyNetClientComm |
|
{ |
|
// We contain the plNetClientComm we are wrapping. |
|
plNetClientComm fNetClient; |
|
|
|
protected: |
|
|
|
//////////////////////////////////////////////////////////////// |
|
|
|
pyNetClientComm(); |
|
|
|
public: |
|
~pyNetClientComm(); |
|
|
|
// required functions for PyObject interoperability |
|
PYTHON_CLASS_NEW_FRIEND(ptNetClientComm); |
|
PYTHON_CLASS_NEW_DEFINITION; |
|
PYTHON_CLASS_CHECK_DEFINITION; // returns true if the PyObject is a pyNetClientComm object |
|
PYTHON_CLASS_CONVERT_FROM_DEFINITION(pyNetClientComm); // converts a PyObject to a pyNetClientComm (throws error if not correct type) |
|
|
|
static void AddPlasmaClasses(PyObject *m); |
|
|
|
plNetClientComm * GetNetClientComm() { return &fNetClient; } |
|
|
|
//////////////////////////////////////////////////////////////// |
|
// NETWORK OPERATIONS |
|
|
|
// Auth with active server using auth info set earlier. |
|
// Will timeout after maxAuthSecs elapsed. |
|
int NetAuthenticate( double maxAuthSecs, PyObject* cbClass=nil, uint32_t cbContext=0 ); |
|
// Leave the active server. |
|
int NetLeave( uint8_t reason, PyObject* cbClass=nil, uint32_t cbContext=0 ); |
|
// Ping the specified server. |
|
int NetPing( int serverType, int timeoutSecs=0, PyObject* cbClass=nil, uint32_t cbContext=0 ); |
|
// Spawn a game for us. |
|
int NetFindAge( const pyAgeLinkStruct* linkInfo, PyObject* cbClass=nil, uint32_t cbContext=0 ); |
|
// Get player list. |
|
int NetGetPlayerList( PyObject* cbClass=nil, uint32_t cbContext=0 ); |
|
// Set the active player. |
|
int NetSetActivePlayer( uint32_t playerID, const char* playerName, PyObject* cbClass=nil, uint32_t cbContext=0 ); |
|
// Create a player |
|
int NetCreatePlayer( const char* playerName, const char* avatarShape, uint32_t createFlags, PyObject* cbClass=nil, uint32_t cbContext=0 ); |
|
// Join age |
|
int NetJoinAge( PyObject* cbClass=nil, uint32_t cbContext=0 ); |
|
// Set server-side timeout |
|
int NetSetTimeout( float timeoutSecs, PyObject* cbClass=nil, uint32_t cbContext=0 ); |
|
|
|
//////////////////////////////////////////////////////////////// |
|
|
|
// Calls ErrorHandler, if set. Returns value of result |
|
// that was passed in (for use in return/compound statements). |
|
int ReportError( int err, int result ); |
|
|
|
//////////////////////////////////////////////////////////////// |
|
|
|
// Get/Set Log object |
|
void SetLog( pyStatusLog* log ); |
|
void SetLogByName( const char * name, uint32_t flags=0 ); |
|
PyObject* GetLog() const; // return pyStatusLog |
|
|
|
// NetCore log level |
|
void SetLogLevel( int logLevel ); |
|
|
|
// Startup/Shutdown this object |
|
int Init( bool threaded=true, int logLevel=0 ); |
|
// flushMsgsSecs: time to spend flushing net msgs queued in net core. |
|
// <0 means no time limit. spin until all msgs are flushed. |
|
int Fini( float flushMsgsSecs=0.f ); |
|
|
|
// Call this in your update loop. |
|
int Update(); |
|
|
|
// Access to the NetCore object. |
|
pyNetCore* GetNetCore() const; |
|
|
|
// Get/Set Authentication info |
|
int SetAuthInfo( const char* acctName, const char* password ); |
|
const char* GetAcctName() const; |
|
const char* GetPassword() const; |
|
|
|
// Sets the server we want to communicate with. |
|
int SetActiveServer( pyNetServerSessionInfo* nfo ); |
|
int SetActiveServer2( const char * addr, int port ); |
|
const pyNetServerSessionInfo* GetActiveServer() const; |
|
|
|
// Sets/clears receipt tracking for given message class. |
|
void SetReceiptTrackingForType( uint16_t msgClassIdx, bool on ); |
|
|
|
// Adds a msg handler for a msg that is convertable to specified type. |
|
void AddMsgHandlerForType( uint16_t msgClassIdx, pyNetClientCommMsgHandler* handler ); |
|
|
|
// Adds a msg handler for a specific msg type. |
|
void AddMsgHandlerForExactType( uint16_t msgClassIdx, pyNetClientCommMsgHandler* handler ); |
|
|
|
void RemoveMsgHandler( pyNetClientCommMsgHandler* handler ); |
|
|
|
// Msgs not part of a task controlled by this |
|
// object, and doesn't have a handler set for its type |
|
// are sent to this handler (if set). |
|
void SetDefaultHandler( pyNetClientCommMsgHandler* msgHandler ); |
|
|
|
// Changed message rcpts are sent to this handler if set. |
|
void SetMsgReceiptHandler( pyNetClientCommRcptHandler* rcptHandler ); |
|
|
|
// Send a message to the server. |
|
int SendMsg( plNetMessage* msg, uint32_t sendFlags=0 ); |
|
// Send a message to specified peer |
|
int SendMsg( plNetMessage* msg, plNetCore::PeerID peerID, uint32_t sendFlags=0 ); |
|
|
|
// Set the alive message send frequency. 0 means don't send periodic alive msgs. |
|
void SetAliveFreq( float secs ); |
|
float GetAliveFreq() const; |
|
|
|
// Set the amount of time before we declare server-silence. |
|
void SetServerSilenceTime( float secs ); |
|
float GetServerSilenceTime() const; |
|
|
|
// Set the maximum amount of time to spend processing |
|
// incoming msgs per call to Update(). |
|
void SetMaxMsgProcessingTime( float secs ); |
|
|
|
}; |
|
|
|
//////////////////////////////////////////////////////////////////// |
|
#endif // pyNetClientComm_h_inc
|
|
|