49646383f1
Happy new year to the wonderful Godot community!
2020 has been a tough year for most of us personally, but a good year for
Godot development nonetheless with a huge amount of work done towards Godot
4.0 and great improvements backported to the long-lived 3.2 branch.
We've had close to 400 contributors to engine code this year, authoring near
7,000 commit! (And that's only for the `master` branch and for the engine code,
there's a lot more when counting docs, demos and other first-party repos.)
Here's to a great year 2021 for all Godot users 🎆
(cherry picked from commit b5334d14f7)
174 lines
7 KiB
C++
174 lines
7 KiB
C++
/*************************************************************************/
|
|
/* multiplayer_api.h */
|
|
/*************************************************************************/
|
|
/* This file is part of: */
|
|
/* GODOT ENGINE */
|
|
/* https://godotengine.org */
|
|
/*************************************************************************/
|
|
/* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
|
|
/* Copyright (c) 2014-2021 Godot Engine contributors (cf. AUTHORS.md). */
|
|
/* */
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
/* a copy of this software and associated documentation files (the */
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
/* the following conditions: */
|
|
/* */
|
|
/* The above copyright notice and this permission notice shall be */
|
|
/* included in all copies or substantial portions of the Software. */
|
|
/* */
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
/*************************************************************************/
|
|
|
|
#ifndef MULTIPLAYER_PROTOCOL_H
|
|
#define MULTIPLAYER_PROTOCOL_H
|
|
|
|
#include "core/io/networked_multiplayer_peer.h"
|
|
#include "core/reference.h"
|
|
|
|
class MultiplayerAPI : public Reference {
|
|
|
|
GDCLASS(MultiplayerAPI, Reference);
|
|
|
|
public:
|
|
struct ProfilingInfo {
|
|
ObjectID node;
|
|
String node_path;
|
|
int incoming_rpc;
|
|
int incoming_rset;
|
|
int outgoing_rpc;
|
|
int outgoing_rset;
|
|
};
|
|
|
|
private:
|
|
//path sent caches
|
|
struct PathSentCache {
|
|
Map<int, bool> confirmed_peers;
|
|
int id;
|
|
};
|
|
|
|
//path get caches
|
|
struct PathGetCache {
|
|
struct NodeInfo {
|
|
NodePath path;
|
|
ObjectID instance;
|
|
};
|
|
|
|
Map<int, NodeInfo> nodes;
|
|
};
|
|
|
|
#ifdef DEBUG_ENABLED
|
|
struct BandwidthFrame {
|
|
uint32_t timestamp;
|
|
int packet_size;
|
|
};
|
|
|
|
int bandwidth_incoming_pointer;
|
|
Vector<BandwidthFrame> bandwidth_incoming_data;
|
|
int bandwidth_outgoing_pointer;
|
|
Vector<BandwidthFrame> bandwidth_outgoing_data;
|
|
Map<ObjectID, ProfilingInfo> profiler_frame_data;
|
|
bool profiling;
|
|
|
|
void _init_node_profile(ObjectID p_node);
|
|
int _get_bandwidth_usage(const Vector<BandwidthFrame> &p_buffer, int p_pointer);
|
|
#endif
|
|
|
|
Ref<NetworkedMultiplayerPeer> network_peer;
|
|
int rpc_sender_id;
|
|
Set<int> connected_peers;
|
|
HashMap<NodePath, PathSentCache> path_send_cache;
|
|
Map<int, PathGetCache> path_get_cache;
|
|
int last_send_cache_id;
|
|
Vector<uint8_t> packet_cache;
|
|
Node *root_node;
|
|
bool allow_object_decoding;
|
|
|
|
protected:
|
|
static void _bind_methods();
|
|
|
|
void _process_packet(int p_from, const uint8_t *p_packet, int p_packet_len);
|
|
void _process_simplify_path(int p_from, const uint8_t *p_packet, int p_packet_len);
|
|
void _process_confirm_path(int p_from, const uint8_t *p_packet, int p_packet_len);
|
|
Node *_process_get_node(int p_from, const uint8_t *p_packet, int p_packet_len);
|
|
void _process_rpc(Node *p_node, const StringName &p_name, int p_from, const uint8_t *p_packet, int p_packet_len, int p_offset);
|
|
void _process_rset(Node *p_node, const StringName &p_name, int p_from, const uint8_t *p_packet, int p_packet_len, int p_offset);
|
|
void _process_raw(int p_from, const uint8_t *p_packet, int p_packet_len);
|
|
|
|
void _send_rpc(Node *p_from, int p_to, bool p_unreliable, bool p_set, const StringName &p_name, const Variant **p_arg, int p_argcount);
|
|
bool _send_confirm_path(NodePath p_path, PathSentCache *psc, int p_target);
|
|
|
|
public:
|
|
enum NetworkCommands {
|
|
NETWORK_COMMAND_REMOTE_CALL,
|
|
NETWORK_COMMAND_REMOTE_SET,
|
|
NETWORK_COMMAND_SIMPLIFY_PATH,
|
|
NETWORK_COMMAND_CONFIRM_PATH,
|
|
NETWORK_COMMAND_RAW,
|
|
};
|
|
|
|
enum RPCMode {
|
|
|
|
RPC_MODE_DISABLED, // No rpc for this method, calls to this will be blocked (default)
|
|
RPC_MODE_REMOTE, // Using rpc() on it will call method / set property in all remote peers
|
|
RPC_MODE_MASTER, // Using rpc() on it will call method on wherever the master is, be it local or remote
|
|
RPC_MODE_PUPPET, // Using rpc() on it will call method for all puppets
|
|
RPC_MODE_SLAVE = RPC_MODE_PUPPET, // Deprecated, same as puppet
|
|
RPC_MODE_REMOTESYNC, // Using rpc() on it will call method / set property in all remote peers and locally
|
|
RPC_MODE_SYNC = RPC_MODE_REMOTESYNC, // Deprecated. Same as RPC_MODE_REMOTESYNC
|
|
RPC_MODE_MASTERSYNC, // Using rpc() on it will call method / set property in the master peer and locally
|
|
RPC_MODE_PUPPETSYNC, // Using rpc() on it will call method / set property in all puppets peers and locally
|
|
};
|
|
|
|
void poll();
|
|
void clear();
|
|
void set_root_node(Node *p_node);
|
|
Node *get_root_node();
|
|
void set_network_peer(const Ref<NetworkedMultiplayerPeer> &p_peer);
|
|
Ref<NetworkedMultiplayerPeer> get_network_peer() const;
|
|
Error send_bytes(PoolVector<uint8_t> p_data, int p_to = NetworkedMultiplayerPeer::TARGET_PEER_BROADCAST, NetworkedMultiplayerPeer::TransferMode p_mode = NetworkedMultiplayerPeer::TRANSFER_MODE_RELIABLE);
|
|
|
|
// Called by Node.rpc
|
|
void rpcp(Node *p_node, int p_peer_id, bool p_unreliable, const StringName &p_method, const Variant **p_arg, int p_argcount);
|
|
// Called by Node.rset
|
|
void rsetp(Node *p_node, int p_peer_id, bool p_unreliable, const StringName &p_property, const Variant &p_value);
|
|
|
|
void _add_peer(int p_id);
|
|
void _del_peer(int p_id);
|
|
void _connected_to_server();
|
|
void _connection_failed();
|
|
void _server_disconnected();
|
|
|
|
bool has_network_peer() const { return network_peer.is_valid(); }
|
|
Vector<int> get_network_connected_peers() const;
|
|
int get_rpc_sender_id() const { return rpc_sender_id; }
|
|
int get_network_unique_id() const;
|
|
bool is_network_server() const;
|
|
void set_refuse_new_network_connections(bool p_refuse);
|
|
bool is_refusing_new_network_connections() const;
|
|
|
|
void set_allow_object_decoding(bool p_enable);
|
|
bool is_object_decoding_allowed() const;
|
|
|
|
void profiling_start();
|
|
void profiling_end();
|
|
|
|
int get_profiling_frame(ProfilingInfo *r_info);
|
|
int get_incoming_bandwidth_usage();
|
|
int get_outgoing_bandwidth_usage();
|
|
|
|
MultiplayerAPI();
|
|
~MultiplayerAPI();
|
|
};
|
|
|
|
VARIANT_ENUM_CAST(MultiplayerAPI::RPCMode);
|
|
|
|
#endif // MULTIPLAYER_PROTOCOL_H
|