Urho3D
|
Network subsystem. Manages client-server communications using the UDP protocol. More...
#include <Network.h>
Public Member Functions | |
Network (Context *context) | |
Construct. | |
~Network () | |
Destruct. | |
virtual void | HandleMessage (kNet::MessageConnection *source, kNet::packet_id_t packetId, kNet::message_id_t msgId, const char *data, size_t numBytes) |
Handle a kNet message from either a client or the server. | |
virtual u32 | ComputeContentID (kNet::message_id_t msgId, const char *data, size_t numBytes) |
Compute the content ID for a message. | |
virtual void | NewConnectionEstablished (kNet::MessageConnection *connection) |
Handle a new client connection. | |
virtual void | ClientDisconnected (kNet::MessageConnection *connection) |
Handle a client disconnection. | |
bool | Connect (const String &address, unsigned short port, Scene *scene, const VariantMap &identity=VariantMap()) |
Connect to a server using UDP protocol. Return true if connection process successfully started. | |
void | Disconnect (int waitMSec=0) |
Disconnect the connection to the server. If wait time is non-zero, will block while waiting for disconnect to finish. | |
bool | StartServer (unsigned short port) |
Start a server on a port using UDP protocol. Return true if successful. | |
void | StopServer () |
Stop the server. | |
void | BroadcastMessage (int msgID, bool reliable, bool inOrder, const VectorBuffer &msg, unsigned contentID=0) |
Broadcast a message with content ID to all client connections. | |
void | BroadcastMessage (int msgID, bool reliable, bool inOrder, const unsigned char *data, unsigned numBytes, unsigned contentID=0) |
Broadcast a message with content ID to all client connections. | |
void | BroadcastRemoteEvent (StringHash eventType, bool inOrder, const VariantMap &eventData=VariantMap()) |
Broadcast a remote event to all client connections. | |
void | BroadcastRemoteEvent (Scene *scene, StringHash eventType, bool inOrder, const VariantMap &eventData=VariantMap()) |
Broadcast a remote event to all client connections in a specific scene. | |
void | BroadcastRemoteEvent (Node *node, StringHash eventType, bool inOrder, const VariantMap &eventData=VariantMap()) |
Broadcast a remote event with the specified node as a sender. Is sent to all client connections in the node's scene. | |
void | SetUpdateFps (int fps) |
Set network update FPS. | |
void | RegisterRemoteEvent (StringHash eventType) |
Register a remote event as allowed to be sent and received. If no events are registered, all are allowed. | |
void | UnregisterRemoteEvent (StringHash eventType) |
Unregister a remote event as allowed to be sent and received. | |
void | UnregisterAllRemoteEvents () |
Unregister all remote events. This results in all being allowed. | |
void | SetPackageCacheDir (const String &path) |
Set the package download cache directory. | |
int | GetUpdateFps () const |
Return network update FPS. | |
Connection * | GetConnection (kNet::MessageConnection *connection) const |
Return a client or server connection by kNet MessageConnection, or null if none exist. | |
Connection * | GetServerConnection () const |
Return the connection to the server. Null if not connected. | |
Vector< SharedPtr< Connection > > | GetClientConnections () const |
Return all client connections. | |
bool | IsServerRunning () const |
Return whether the server is running. | |
bool | CheckRemoteEvent (StringHash eventType) const |
Return whether a remote event is allowed to be sent and received. If no events are registered, all are allowed. | |
const String & | GetPackageCacheDir () const |
Return the package download cache directory. | |
void | Update (float timeStep) |
Process incoming messages from connections. Called by HandleBeginFrame. | |
void | PostUpdate (float timeStep) |
Send outgoing messages after frame logic. Called by HandleRenderUpdate. | |
![]() | |
Object (Context *context) | |
Construct. | |
virtual | ~Object () |
Destruct. Clean up self from event sender & receiver structures. | |
virtual ShortStringHash | GetType () const =0 |
Return type hash. | |
virtual const String & | GetTypeName () const =0 |
Return type name. | |
virtual void | OnEvent (Object *sender, StringHash eventType, VariantMap &eventData) |
Handle event. | |
void | SubscribeToEvent (StringHash eventType, EventHandler *handler) |
Subscribe to an event that can be sent by any sender. | |
void | SubscribeToEvent (Object *sender, StringHash eventType, EventHandler *handler) |
Subscribe to a specific sender's event. | |
void | UnsubscribeFromEvent (StringHash eventType) |
Unsubscribe from an event. | |
void | UnsubscribeFromEvent (Object *sender, StringHash eventType) |
Unsubscribe from a specific sender's event. | |
void | UnsubscribeFromEvents (Object *sender) |
Unsubscribe from a specific sender's events. | |
void | UnsubscribeFromAllEvents () |
Unsubscribe from all events. | |
void | UnsubscribeFromAllEventsExcept (const PODVector< StringHash > &exceptions, bool onlyUserData) |
Unsubscribe from all events except those listed, and optionally only those with userdata (script registered events.) | |
void | SendEvent (StringHash eventType) |
Send event to all subscribers. | |
void | SendEvent (StringHash eventType, VariantMap &eventData) |
Send event with parameters to all subscribers. | |
Context * | GetContext () const |
Return execution context. | |
Object * | GetSubsystem (ShortStringHash type) const |
Return subsystem by type. | |
Object * | GetEventSender () const |
Return active event sender. Null outside event handling. | |
EventHandler * | GetEventHandler () const |
Return active event handler. Null outside event handling. | |
bool | HasSubscribedToEvent (StringHash eventType) const |
Return whether has subscribed to an event without specific sender. | |
bool | HasSubscribedToEvent (Object *sender, StringHash eventType) const |
Return whether has subscribed to a specific sender's event. | |
template<class T > | |
T * | GetSubsystem () const |
Template version of returning a subsystem. | |
![]() | |
RefCounted () | |
Construct. Allocate the reference count structure and set an initial self weak reference. | |
virtual | ~RefCounted () |
Destruct. Mark as expired and also delete the reference count structure if no outside weak references exist. | |
void | AddRef () |
Increment reference count. Can also be called outside of a SharedPtr for traditional reference counting. | |
void | ReleaseRef () |
Decrement reference count and delete self if no more references. Can also be called outside of a SharedPtr for traditional reference counting. | |
int | Refs () const |
Return reference count. | |
int | WeakRefs () const |
Return weak reference count. | |
RefCount * | RefCountPtr () |
Return pointer to the reference count structure. |
Private Member Functions | |
OBJECT (Network) | |
void | HandleBeginFrame (StringHash eventType, VariantMap &eventData) |
Handle begin frame event. | |
void | HandleRenderUpdate (StringHash eventType, VariantMap &eventData) |
Handle render update frame event. | |
void | OnServerConnected () |
Handle server connection. | |
void | OnServerDisconnected () |
Handle server disconnection. |
Private Attributes | |
kNet::Network * | network_ |
kNet instance. | |
SharedPtr< Connection > | serverConnection_ |
Client's server connection. | |
HashMap < kNet::MessageConnection *, SharedPtr< Connection > > | clientConnections_ |
Server's client connections. | |
HashSet< StringHash > | allowedRemoteEvents_ |
Allowed remote events. | |
HashSet< Scene * > | networkScenes_ |
Networked scenes. | |
int | updateFps_ |
Update FPS. | |
float | updateInterval_ |
Update time interval. | |
float | updateAcc_ |
Update time accumulator. | |
String | packageCacheDir_ |
Package cache directory. |
Additional Inherited Members | |
![]() | |
Context * | context_ |
Execution context. |
Network subsystem. Manages client-server communications using the UDP protocol.