This repository has been archived on 2025-04-22. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
com.unity.netcode.gameobjects/Tests/Runtime/Transports/UnityTransportConnectionTests.cs
Unity Technologies 4d70c198bd com.unity.netcode.gameobjects@1.5.1
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

Additional documentation and release notes are available at [Multiplayer Documentation](https://docs-multiplayer.unity3d.com).

## [1.5.1] - 2023-06-07

### Added

- Added support for serializing `NativeArray<>` and `NativeList<>` in `FastBufferReader`/`FastBufferWriter`, `BufferSerializer`, `NetworkVariable`, and RPCs. (To use `NativeList<>`, add `UNITY_NETCODE_NATIVE_COLLECTION_SUPPORT` to your Scripting Define Symbols in `Project Settings > Player`) (#2375)
- The location of the automatically-created default network prefab list can now be configured (#2544)
- Added: Message size limits (max single message and max fragmented message) can now be set using NetworkManager.MaximumTransmissionUnitSize and NetworkManager.MaximumFragmentedMessageSize for transports that don't work with the default values (#2530)
- Added `NetworkObject.SpawnWithObservers` property (default is true) that when set to false will spawn a `NetworkObject` with no observers and will not be spawned on any client until `NetworkObject.NetworkShow` is invoked. (#2568)

### Fixed

- Fixed: Fixed a null reference in codegen in some projects (#2581)
- Fixed issue where the `OnClientDisconnected` client identifier was incorrect after a pending client connection was denied. (#2569)
- Fixed warning "Runtime Network Prefabs was not empty at initialization time." being erroneously logged when no runtime network prefabs had been added (#2565)
- Fixed issue where some temporary debug console logging was left in a merged PR. (#2562)
- Fixed the "Generate Default Network Prefabs List" setting not loading correctly and always reverting to being checked. (#2545)
- Fixed issue where users could not use NetworkSceneManager.VerifySceneBeforeLoading to exclude runtime generated scenes from client synchronization. (#2550)
- Fixed missing value on `NetworkListEvent` for `EventType.RemoveAt` events.  (#2542,#2543)
- Fixed issue where parenting a NetworkTransform under a transform with a scale other than Vector3.one would result in incorrect values on non-authoritative instances. (#2538)
- Fixed issue where a server would include scene migrated and then despawned NetworkObjects to a client that was being synchronized. (#2532)
- Fixed the inspector throwing exceptions when attempting to render `NetworkVariable`s of enum types. (#2529)
- Making a `NetworkVariable` with an `INetworkSerializable` type that doesn't meet the `new()` constraint will now create a compile-time error instead of an editor crash (#2528)
- Fixed Multiplayer Tools package installation docs page link on the NetworkManager popup. (#2526)
- Fixed an exception and error logging when two different objects are shown and hidden on the same frame (#2524)
- Fixed a memory leak in `UnityTransport` that occurred if `StartClient` failed. (#2518)
- Fixed issue where a client could throw an exception if abruptly disconnected from a network session with one or more spawned `NetworkObject`(s). (#2510)
- Fixed issue where invalid endpoint addresses were not being detected and returning false from NGO UnityTransport. (#2496)
- Fixed some errors that could occur if a connection is lost and the loss is detected when attempting to write to the socket. (#2495)

## Changed

- Adding network prefabs before NetworkManager initialization is now supported. (#2565)
- Connecting clients being synchronized now switch to the server's active scene before spawning and synchronizing NetworkObjects. (#2532)
- Updated `UnityTransport` dependency on `com.unity.transport` to 1.3.4. (#2533)
- Improved performance of NetworkBehaviour initialization by replacing reflection when initializing NetworkVariables with compile-time code generation, which should help reduce hitching during additive scene loads. (#2522)
2023-06-07 00:00:00 +00:00

400 lines
15 KiB
C#

using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using NUnit.Framework;
using Unity.Netcode.Transports.UTP;
using UnityEngine;
using UnityEngine.TestTools;
using static Unity.Netcode.RuntimeTests.UnityTransportTestHelpers;
namespace Unity.Netcode.RuntimeTests
{
public class UnityTransportConnectionTests
{
// For tests using multiple clients.
private const int k_NumClients = 5;
private UnityTransport m_Server;
private UnityTransport[] m_Clients = new UnityTransport[k_NumClients];
private List<TransportEvent> m_ServerEvents;
private List<TransportEvent>[] m_ClientsEvents = new List<TransportEvent>[k_NumClients];
[UnityTearDown]
public IEnumerator Cleanup()
{
if (m_Server)
{
m_Server.Shutdown();
UnityEngine.Object.DestroyImmediate(m_Server);
}
foreach (var transport in m_Clients)
{
if (transport)
{
transport.Shutdown();
UnityEngine.Object.DestroyImmediate(transport);
}
}
foreach (var transportEvents in m_ClientsEvents)
{
transportEvents?.Clear();
}
yield return null;
}
// Check that invalid endpoint addresses are detected and return false if detected
[Test]
public void DetectInvalidEndpoint()
{
using var netcodeLogAssert = new NetcodeLogAssert(true);
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
m_Server.ConnectionData.Address = "Fubar";
m_Server.ConnectionData.ServerListenAddress = "Fubar";
m_Clients[0].ConnectionData.Address = "MoreFubar";
Assert.False(m_Server.StartServer(), "Server failed to detect invalid endpoint!");
Assert.False(m_Clients[0].StartClient(), "Client failed to detect invalid endpoint!");
netcodeLogAssert.LogWasReceived(LogType.Error, $"Network listen address ({m_Server.ConnectionData.Address}) is Invalid!");
netcodeLogAssert.LogWasReceived(LogType.Error, $"Target server network address ({m_Clients[0].ConnectionData.Address}) is Invalid!");
}
// Check connection with a single client.
[UnityTest]
public IEnumerator ConnectSingleClient()
{
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
m_Server.StartServer();
m_Clients[0].StartClient();
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[0]);
// Check we've received Connect event on server too.
Assert.AreEqual(1, m_ServerEvents.Count);
Assert.AreEqual(NetworkEvent.Connect, m_ServerEvents[0].Type);
yield return null;
}
// Check connection with multiple clients.
[UnityTest]
public IEnumerator ConnectMultipleClients()
{
InitializeTransport(out m_Server, out m_ServerEvents);
m_Server.StartServer();
for (int i = 0; i < k_NumClients; i++)
{
InitializeTransport(out m_Clients[i], out m_ClientsEvents[i]);
m_Clients[i].StartClient();
}
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[k_NumClients - 1]);
// Check that every client received a Connect event.
Assert.True(m_ClientsEvents.All(evs => evs.Count == 1));
Assert.True(m_ClientsEvents.All(evs => evs[0].Type == NetworkEvent.Connect));
// Check we've received Connect events on server too.
Assert.AreEqual(k_NumClients, m_ServerEvents.Count);
Assert.True(m_ServerEvents.All(ev => ev.Type == NetworkEvent.Connect));
yield return null;
}
// Check server disconnection with a single client.
[UnityTest]
public IEnumerator ServerDisconnectSingleClient()
{
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
m_Server.StartServer();
m_Clients[0].StartClient();
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[0]);
m_Server.DisconnectRemoteClient(m_ServerEvents[0].ClientID);
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ClientsEvents[0]);
yield return null;
}
// Check server disconnection with multiple clients.
[UnityTest]
public IEnumerator ServerDisconnectMultipleClients()
{
InitializeTransport(out m_Server, out m_ServerEvents);
m_Server.StartServer();
for (int i = 0; i < k_NumClients; i++)
{
InitializeTransport(out m_Clients[i], out m_ClientsEvents[i]);
m_Clients[i].StartClient();
}
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[k_NumClients - 1]);
// Disconnect a single client.
m_Server.DisconnectRemoteClient(m_ServerEvents[0].ClientID);
// Need to manually wait since we don't know which client will get the Disconnect.
yield return new WaitForSeconds(MaxNetworkEventWaitTime);
// Check that we received a Disconnect event on only one client.
Assert.AreEqual(1, m_ClientsEvents.Count(evs => evs.Count == 2 && evs[1].Type == NetworkEvent.Disconnect));
// Disconnect all the other clients.
for (int i = 1; i < k_NumClients; i++)
{
m_Server.DisconnectRemoteClient(m_ServerEvents[i].ClientID);
}
// Need to manually wait since we don't know which client got the Disconnect.
yield return new WaitForSeconds(MaxNetworkEventWaitTime);
// Check that all clients got a Disconnect event.
Assert.True(m_ClientsEvents.All(evs => evs.Count == 2));
Assert.True(m_ClientsEvents.All(evs => evs[1].Type == NetworkEvent.Disconnect));
yield return null;
}
// Check client disconnection from a single client.
[UnityTest]
public IEnumerator ClientDisconnectSingleClient()
{
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
m_Server.StartServer();
m_Clients[0].StartClient();
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[0]);
m_Clients[0].DisconnectLocalClient();
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ServerEvents);
}
// Check client disconnection with multiple clients.
[UnityTest]
public IEnumerator ClientDisconnectMultipleClients()
{
InitializeTransport(out m_Server, out m_ServerEvents);
m_Server.StartServer();
for (int i = 0; i < k_NumClients; i++)
{
InitializeTransport(out m_Clients[i], out m_ClientsEvents[i]);
m_Clients[i].StartClient();
}
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[k_NumClients - 1]);
// Disconnect a single client.
m_Clients[0].DisconnectLocalClient();
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ServerEvents);
// Disconnect all the other clients.
for (int i = 1; i < k_NumClients; i++)
{
m_Clients[i].DisconnectLocalClient();
}
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ServerEvents);
// Check that we got the correct number of Disconnect events on the server.
Assert.AreEqual(k_NumClients * 2, m_ServerEvents.Count);
Assert.AreEqual(k_NumClients, m_ServerEvents.Count(e => e.Type == NetworkEvent.Disconnect));
yield return null;
}
// Check that server re-disconnects are no-ops.
[UnityTest]
public IEnumerator RepeatedServerDisconnectsNoop()
{
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
m_Server.StartServer();
m_Clients[0].StartClient();
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[0]);
m_Server.DisconnectRemoteClient(m_ServerEvents[0].ClientID);
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ClientsEvents[0]);
var previousServerEventsCount = m_ServerEvents.Count;
var previousClientEventsCount = m_ClientsEvents[0].Count;
m_Server.DisconnectRemoteClient(m_ServerEvents[0].ClientID);
// Need to wait manually since no event should be generated.
yield return new WaitForSeconds(MaxNetworkEventWaitTime);
// Check we haven't received anything else on the client or server.
Assert.AreEqual(m_ServerEvents.Count, previousServerEventsCount);
Assert.AreEqual(m_ClientsEvents[0].Count, previousClientEventsCount);
yield return null;
}
// Check that client re-disconnects are no-ops.
[UnityTest]
public IEnumerator RepeatedClientDisconnectsNoop()
{
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
m_Server.StartServer();
m_Clients[0].StartClient();
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[0]);
m_Clients[0].DisconnectLocalClient();
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ServerEvents);
var previousServerEventsCount = m_ServerEvents.Count;
var previousClientEventsCount = m_ClientsEvents[0].Count;
m_Clients[0].DisconnectLocalClient();
// Need to wait manually since no event should be generated.
yield return new WaitForSeconds(MaxNetworkEventWaitTime);
// Check we haven't received anything else on the client or server.
Assert.AreEqual(m_ServerEvents.Count, previousServerEventsCount);
Assert.AreEqual(m_ClientsEvents[0].Count, previousClientEventsCount);
yield return null;
}
// Check connection with different server/listen addresses.
[UnityTest]
public IEnumerator DifferentServerAndListenAddresses()
{
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
m_Server.SetConnectionData("127.0.0.1", 10042, "0.0.0.0");
m_Clients[0].SetConnectionData("127.0.0.1", 10042);
m_Server.StartServer();
m_Clients[0].StartClient();
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[0]);
// Check we've received Connect event on server too.
Assert.AreEqual(1, m_ServerEvents.Count);
Assert.AreEqual(NetworkEvent.Connect, m_ServerEvents[0].Type);
yield return null;
}
// Check server disconnection with data in send queue.
[UnityTest]
public IEnumerator ServerDisconnectWithDataInQueue()
{
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
m_Server.StartServer();
m_Clients[0].StartClient();
// Wait for the client to connect before we disconnect the client
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[0]);
var data = new ArraySegment<byte>(new byte[] { 42 });
m_Server.Send(m_ServerEvents[0].ClientID, data, NetworkDelivery.Unreliable);
m_Server.DisconnectRemoteClient(m_ServerEvents[0].ClientID);
yield return WaitForNetworkEvent(NetworkEvent.Data, m_ClientsEvents[0]);
if (m_ClientsEvents[0].Count >= 3)
{
Assert.AreEqual(NetworkEvent.Disconnect, m_ClientsEvents[0][2].Type);
}
else
{
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ClientsEvents[0]);
}
}
// Check client disconnection with data in send queue.
[UnityTest]
public IEnumerator ClientDisconnectWithDataInQueue()
{
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
m_Server.StartServer();
m_Clients[0].StartClient();
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ServerEvents);
var data = new ArraySegment<byte>(new byte[] { 42 });
m_Clients[0].Send(m_Clients[0].ServerClientId, data, NetworkDelivery.Unreliable);
m_Clients[0].DisconnectLocalClient();
yield return WaitForNetworkEvent(NetworkEvent.Data, m_ServerEvents);
if (m_ServerEvents.Count >= 3)
{
Assert.AreEqual(NetworkEvent.Disconnect, m_ServerEvents[2].Type);
}
else
{
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ServerEvents);
}
}
// Check that a server can disconnect a client after another client has disconnected.
[UnityTest]
public IEnumerator ServerDisconnectAfterClientDisconnect()
{
InitializeTransport(out m_Server, out m_ServerEvents);
InitializeTransport(out m_Clients[0], out m_ClientsEvents[0]);
InitializeTransport(out m_Clients[1], out m_ClientsEvents[1]);
m_Server.StartServer();
m_Clients[0].StartClient();
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[0]);
m_Clients[1].StartClient();
yield return WaitForNetworkEvent(NetworkEvent.Connect, m_ClientsEvents[1]);
m_Clients[0].DisconnectLocalClient();
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ServerEvents);
// Pick the client ID of the still connected client.
var clientId = m_ServerEvents[0].ClientID;
if (m_ServerEvents[2].ClientID == clientId)
{
clientId = m_ServerEvents[1].ClientID;
}
m_Server.DisconnectRemoteClient(clientId);
yield return WaitForNetworkEvent(NetworkEvent.Disconnect, m_ClientsEvents[1]);
yield return null;
}
}
}