NetworkManager
Singleton network manager. Owns the active transport backend (ENet or Steam). Does NOT know game logic — pure transport management.
- Module
- Networking
- Header
#include "Networking/NetworkManager.h"- Namespace
Mowo
Type aliases
| Alias | Description |
|---|---|
using ReplicationFilter = std::function<bool(const NetworkEvent&)> | Engine-side replication framework registers a filter that gets first crack at every DataReceived event before it lands in the script queue. Returning true means "consumed by engine, don't expose to scripts" — typical for replication packets. Returning false lets the event fall through to PollEvent() as usual. PeerConnected / Disconnected events are NOT routed through the filter; scripts always see those. |
using PeerLifecycleHandler = std::function<void(uint32_t peerId)> | Connection-event hooks that fire alongside the script queue (don't suppress the event for scripts — both layers see it). Used by the replication framework to catch up newly-joined peers. |
using PeerObserverHandle = uint32_t | |
using DataObserver = std::function<bool(const NetworkEvent&)> | Data observers get a crack at every DataReceived event the replication filter DECLINED, in registration order, before the event lands in the script queue. Returning true consumes it. The single-slot replication filter has one owner by design; this is the multi-subscriber seam an engine subsystem on its own channel (voice) needs without displacing it. |
Public functions
| Returns | Name | Description |
|---|---|---|
NetworkManager& | Get | |
bool | Initialize | |
void | Shutdown | |
void | Update | Called once per frame — polls transport, queues events |
bool | Host | |
uint16_t | GetBoundPort | The port Host actually bound (the OS pick when Host was given 0). |
bool | Connect | |
void | Disconnect | |
void | DisconnectPeer | Server-side: forcibly drop a single peer (e.g. |
void | DisconnectPeerAfterFlush | The graceful form: after everything queued for the peer went out. |
void | Send | |
void | Broadcast | |
size_t | TakeVoiceBytes | Voice bytes sent to each peer since the last take. |
NetworkRole | GetRole | |
ConnectionState | GetState | |
uint32_t | GetLocalPeerId | |
int | GetPeerCount | |
uint32_t | GetPeerIdAt | |
bool | PollEvent | |
void | SetReplicationFilter | |
void | ClearReplicationFilter | |
void | SetReplicationOnPeerConnected | |
void | SetReplicationOnPeerDisconnected | |
void | ClearReplicationPeerHandlers | |
PeerObserverHandle | AddPeerConnectedObserver | |
PeerObserverHandle | AddPeerDisconnectedObserver | |
void | RemovePeerObserver | |
void | ClearPeerObservers | |
PeerObserverHandle | AddDataObserver | |
void | RemoveDataObserver | |
void | ClearDataObservers | |
void | SetMaxQueuedEvents | |
void | SetTransport | |
void | FollowConfiguredTransport | Makes the transport the one net.Transport names, unless a caller set its own with SetTransport or a session is up. |
INetworkTransport* | GetTransport | |
bool | IsInitialized |
Function details
Get
static NetworkManager& Get()Initialize
bool Initialize()Shutdown
void Shutdown()Update
void Update()Called once per frame — polls transport, queues events
Host
bool Host(uint16_t port, uint32_t maxClients = 4)GetBoundPort
uint16_t GetBoundPort() constThe port Host actually bound (the OS pick when Host was given 0).
Connect
bool Connect(const std::string& address, uint16_t port)Disconnect
void Disconnect()DisconnectPeer
void DisconnectPeer(uint32_t peerId)Server-side: forcibly drop a single peer (e.g. failed authentication).
DisconnectPeerAfterFlush
void DisconnectPeerAfterFlush(uint32_t peerId)The graceful form: after everything queued for the peer went out.
Send
void Send(uint32_t peerId, const void* data, size_t size, uint8_t channel)Broadcast
void Broadcast(const void* data, size_t size, uint8_t channel)TakeVoiceBytes
size_t TakeVoiceBytes(uint32_t peerId)Voice bytes sent to each peer since the last take. Voice leaves through Send on its own channel, so replication never saw it; the replication refill takes this and charges the peer's shared byte bucket.
GetRole
NetworkRole GetRole() constGetState
ConnectionState GetState() constGetLocalPeerId
uint32_t GetLocalPeerId() constGetPeerCount
int GetPeerCount() constGetPeerIdAt
uint32_t GetPeerIdAt(int index) constPollEvent
bool PollEvent(NetworkEvent& outEvent)SetReplicationFilter
void SetReplicationFilter(ReplicationFilter f)ClearReplicationFilter
void ClearReplicationFilter()SetReplicationOnPeerConnected
void SetReplicationOnPeerConnected(PeerLifecycleHandler h)SetReplicationOnPeerDisconnected
void SetReplicationOnPeerDisconnected(PeerLifecycleHandler h)ClearReplicationPeerHandlers
void ClearReplicationPeerHandlers()AddPeerConnectedObserver
PeerObserverHandle AddPeerConnectedObserver(PeerLifecycleHandler h)AddPeerDisconnectedObserver
PeerObserverHandle AddPeerDisconnectedObserver(PeerLifecycleHandler h)RemovePeerObserver
void RemovePeerObserver(PeerObserverHandle handle)ClearPeerObservers
void ClearPeerObservers()AddDataObserver
PeerObserverHandle AddDataObserver(DataObserver o)RemoveDataObserver
void RemoveDataObserver(PeerObserverHandle handle)ClearDataObservers
void ClearDataObservers()SetMaxQueuedEvents
void SetMaxQueuedEvents(size_t maxEvents)SetTransport
void SetTransport(std::unique_ptr<INetworkTransport> transport)FollowConfiguredTransport
void FollowConfiguredTransport()Makes the transport the one net.Transport names, unless a caller set its own with SetTransport or a session is up. The network module starts before the project's config is applied, so the value a game sets in DefaultEngine.ini only exists by the time it hosts or joins; Host, Connect and every session call this first.
GetTransport
INetworkTransport* GetTransport()IsInitialized
bool IsInitialized() const