mirror of
https://github.com/dashr9230/SA-MP.git
synced 2024-12-22 14:37:29 +08:00
98 lines
5.3 KiB
C++
98 lines
5.3 KiB
C++
/// \file
|
|
/// \brief Router plugin. Allows you to send to systems you are not directly connected to, and to route those messages
|
|
///
|
|
/// This file is part of RakNet Copyright 2003 Kevin Jenkins.
|
|
///
|
|
/// Usage of RakNet is subject to the appropriate license agreement.
|
|
/// Creative Commons Licensees are subject to the
|
|
/// license found at
|
|
/// http://creativecommons.org/licenses/by-nc/2.5/
|
|
/// Single application licensees are subject to the license found at
|
|
/// http://www.rakkarsoft.com/SingleApplicationLicense.html
|
|
/// Custom license users are subject to the terms therein.
|
|
/// GPL license users are subject to the GNU General Public
|
|
/// License as published by the Free
|
|
/// Software Foundation; either version 2 of the License, or (at your
|
|
/// option) any later version.
|
|
|
|
#ifndef __ROUTER_PLUGIN_H
|
|
#define __ROUTER_PLUGIN_H
|
|
|
|
class RakPeerInterface;
|
|
#include "NetworkTypes.h"
|
|
#include "PluginInterface.h"
|
|
#include "DS_OrderedList.h"
|
|
#include "DS_WeightedGraph.h"
|
|
#include "PacketPriority.h"
|
|
#include "SystemAddressList.h"
|
|
#include "RouterInterface.h"
|
|
#include "Export.h"
|
|
#include "ConnectionGraph.h"
|
|
|
|
/// \defgroup ROUTER_GROUP Router
|
|
/// \ingroup PLUGINS_GROUP
|
|
|
|
/// \ingroup ROUTER_GROUP
|
|
/// \brief Used to route messages between peers
|
|
class RAK_DLL_EXPORT Router : public PluginInterface , public RouterInterface
|
|
{
|
|
public:
|
|
Router();
|
|
~Router();
|
|
|
|
// --------------------------------------------------------------------------------------------
|
|
// User functions
|
|
// --------------------------------------------------------------------------------------------
|
|
/// We can restrict what kind of messages are routed by this plugin.
|
|
/// This is useful for security, since you usually want to restrict what kind of messages you have to worry about from (as an example) other
|
|
/// clients in a client / server system
|
|
/// \param[in] restrict True to restrict what messages will be routed. False to not do so (default).
|
|
void SetRestrictRoutingByType(bool restrict);
|
|
|
|
/// If types are restricted, this adds an allowed message type to be routed
|
|
/// \param[in] messageId The type to not allow routing of.
|
|
void AddAllowedType(unsigned char messageId);
|
|
|
|
/// Removes a restricted type previously added with AddRestrictedType
|
|
/// \param[in] messageId The type to no longer restrict routing of.
|
|
void RemoveAllowedType(unsigned char messageId);
|
|
|
|
/// Set the connection graph, which is a weighted graph of the topology of the network. You can easily get this from the
|
|
/// ConnectionGraph plugin. See the 'router' sample for usage.
|
|
/// This is necessary if you want to send (not necessary just to route).
|
|
/// \param[in] connectionGraph A weighted graph representing the topology of the network.
|
|
void SetConnectionGraph(DataStructures::WeightedGraph<ConnectionGraph::PlayerIdAndGroupId, unsigned short, false> *connectionGraph);
|
|
|
|
/// Sends a bitstream to one or more systems. If multiple systems are specified, the message will be multicasted using a minimum spanning tree
|
|
/// \pre You just have called SetConnectionGraph with a valid graph representing the network topology
|
|
/// \note Single target sends from RakPeer with this plugin installed will also be routed. Sends from other plugins will also be routed as long as this plugin is attached first.
|
|
/// \param[in] data The data to send
|
|
/// \param[in] bitLength How many bits long data is
|
|
/// \param[in] priority What priority level to send on.
|
|
/// \param[in] reliability How reliability to send this data
|
|
/// \param[in] orderingChannel When using ordered or sequenced packets, what channel to order these on.- Packets are only ordered relative to other packets on the same stream
|
|
/// \param[in] recipients A list of recipients to send to. To send to one recipient, just pass a PlayerID
|
|
/// \return True on success, false mostly if the connection graph cannot find the destination.
|
|
bool Send( char *data, unsigned bitLength, PacketPriority priority, PacketReliability reliability, char orderingChannel, SystemAddressList *recipients );
|
|
bool Send( const char *data, unsigned bitLength, PacketPriority priority, PacketReliability reliability, char orderingChannel, PlayerID playerId );
|
|
|
|
// --------------------------------------------------------------------------------------------
|
|
// Packet handling functions
|
|
// --------------------------------------------------------------------------------------------
|
|
virtual void OnAttach(RakPeerInterface *peer);
|
|
virtual void OnDetach(RakPeerInterface *peer);
|
|
virtual void OnDisconnect(RakPeerInterface *peer);
|
|
virtual void Update(RakPeerInterface *peer);
|
|
virtual PluginReceiveResult OnReceive(RakPeerInterface *peer, Packet *packet);
|
|
virtual void OnCloseConnection(RakPeerInterface *peer, PlayerID playerId);
|
|
protected:
|
|
void SendTree(PacketPriority priority, PacketReliability reliability, char orderingChannel, DataStructures::Tree<ConnectionGraph::PlayerIdAndGroupId> *tree, const char *data, unsigned bitLength, RakNet::BitStream *out, SystemAddressList *recipients);
|
|
void SerializePreorder(DataStructures::Tree<ConnectionGraph::PlayerIdAndGroupId> *tree, RakNet::BitStream *out, SystemAddressList *recipients) const;
|
|
DataStructures::WeightedGraph<ConnectionGraph::PlayerIdAndGroupId, unsigned short, false> *graph;
|
|
bool restrictByType;
|
|
DataStructures::OrderedList<unsigned char,unsigned char> allowedTypes;
|
|
RakPeerInterface *rakPeer;
|
|
};
|
|
|
|
#endif
|