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). ## [2.0.0-exp.4] - 2024-05-31 ### Added - Added `NetworkRigidbodyBase.AttachToFixedJoint` and `NetworkRigidbodyBase.DetachFromFixedJoint` to replace parenting for rigid bodies that have `NetworkRigidbodyBase.UseRigidBodyForMotion` enabled. (#2933) - Added `NetworkBehaviour.OnNetworkPreSpawn` and `NetworkBehaviour.OnNetworkPostSpawn` methods that provide the ability to handle pre and post spawning actions during the `NetworkObject` spawn sequence. (#2912) - Added a client-side only `NetworkBehaviour.OnNetworkSessionSynchronized` convenience method that is invoked on all `NetworkBehaviour`s after a newly joined client has finished synchronizing with the network session in progress. (#2912) - Added `NetworkBehaviour.OnInSceneObjectsSpawned` convenience method that is invoked when all in-scene `NetworkObject`s have been spawned after a scene has been loaded or upon a host or server starting. (#2912) ### Fixed - Fixed issue where non-authoritative rigid bodies with `NetworkRigidbodyBase.UseRigidBodyForMotion` enabled would constantly log errors about the renderTime being before `StartTimeConsumed`. (#2933) - Fixed issue where in-scene placed NetworkObjects could be destroyed if a client disconnects early and/or before approval. (#2924) - Fixed issue where a `NetworkObject` component's associated `NetworkBehaviour` components would not be detected if scene loading is disabled in the editor and the currently loaded scene has in-scene placed `NetworkObject`s. (#2912) - Fixed issue where an in-scene placed `NetworkObject` with `NetworkTransform` that is also parented under a `GameObject` would not properly synchronize when the parent `GameObject` had a world space position other than 0,0,0. (#2898) ### Changed - Change all the access modifiers of test class from Public to Internal (#2930) - Changed messages are now sorted by enum values as opposed to ordinally sorting the messages by their type name. (#2929) - Changed `NetworkClient.SessionModeTypes` to `NetworkClient.NetworkTopologyTypes`. (#2875) - Changed `NetworkClient.SessionModeType` to `NetworkClient.NetworkTopologyType`. (#2875) - Changed `NetworkConfig.SessionMode` to `NeworkConfig.NetworkTopology`. (#2875)
276 lines
13 KiB
C#
276 lines
13 KiB
C#
#if MULTIPLAYER_TOOLS
|
|
using System;
|
|
using System.Collections;
|
|
using System.Collections.Generic;
|
|
using System.Linq;
|
|
using NUnit.Framework;
|
|
using Unity.Collections;
|
|
using Unity.Multiplayer.Tools.MetricTypes;
|
|
using Unity.Netcode.TestHelpers.Runtime.Metrics;
|
|
using UnityEngine;
|
|
using UnityEngine.TestTools;
|
|
|
|
namespace Unity.Netcode.RuntimeTests.Metrics
|
|
{
|
|
internal class MessagingMetricsTests : DualClientMetricTestBase
|
|
{
|
|
private const uint k_MessageNameHashSize = 8;
|
|
// Header is dynamically sized due to packing, will be 2 bytes for all test messages.
|
|
private const int k_MessageHeaderSize = 2;
|
|
private static readonly int k_NamedMessageOverhead = (int)k_MessageNameHashSize + k_MessageHeaderSize;
|
|
private static readonly int k_UnnamedMessageOverhead = k_MessageHeaderSize;
|
|
|
|
protected override int NumberOfClients => 2;
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackNetworkMessageSentMetric()
|
|
{
|
|
var waitForMetricValues = new WaitForEventMetricValues<NetworkMessageEvent>(ServerMetrics.Dispatcher, NetworkMetricTypes.NetworkMessageSent);
|
|
|
|
var messageName = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(messageName);
|
|
|
|
Server.CustomMessagingManager.SendNamedMessage(messageName.Value.ToString(), FirstClient.LocalClientId, writer);
|
|
}
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
var networkMessageSentMetricValues = waitForMetricValues.AssertMetricValuesHaveBeenFound();
|
|
|
|
// We should have 1 NamedMessage
|
|
Assert.That(networkMessageSentMetricValues, Has.Exactly(1).Matches<NetworkMessageEvent>(x => x.Name == nameof(NamedMessage)));
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackNetworkMessageSentMetricToMultipleClients()
|
|
{
|
|
var waitForMetricValues = new WaitForEventMetricValues<NetworkMessageEvent>(ServerMetrics.Dispatcher, NetworkMetricTypes.NetworkMessageSent);
|
|
var messageName = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(messageName);
|
|
|
|
Server.CustomMessagingManager.SendNamedMessage(messageName.Value.ToString(), new List<ulong> { FirstClient.LocalClientId, SecondClient.LocalClientId }, writer);
|
|
}
|
|
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
var networkMessageSentMetricValues = waitForMetricValues.AssertMetricValuesHaveBeenFound();
|
|
Assert.AreEqual(2, networkMessageSentMetricValues.Count(x => x.Name.Equals(nameof(NamedMessage))));
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackNetworkMessageReceivedMetric()
|
|
{
|
|
var messageName = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
|
|
LogAssert.Expect(LogType.Log, $"Received from {Server.LocalClientId}");
|
|
FirstClient.CustomMessagingManager.RegisterNamedMessageHandler(messageName.Value.ToString(), (ulong sender, FastBufferReader payload) =>
|
|
{
|
|
Debug.Log($"Received from {sender}");
|
|
});
|
|
var waitForMetricValues = new WaitForEventMetricValues<NetworkMessageEvent>(FirstClientMetrics.Dispatcher, NetworkMetricTypes.NetworkMessageReceived,
|
|
metric => metric.Name == nameof(NamedMessage));
|
|
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(messageName);
|
|
|
|
Server.CustomMessagingManager.SendNamedMessage(messageName.Value.ToString(), FirstClient.LocalClientId, writer);
|
|
}
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
var networkMessageReceivedValues = waitForMetricValues.AssertMetricValuesHaveBeenFound();
|
|
// We should have 1 NamedMessage
|
|
Assert.That(networkMessageReceivedValues, Has.Exactly(1).Matches<NetworkMessageEvent>(x => x.Name == nameof(NamedMessage)));
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackNamedMessageSentMetric()
|
|
{
|
|
var waitForMetricValues = new WaitForEventMetricValues<NamedMessageEvent>(ServerMetrics.Dispatcher, NetworkMetricTypes.NamedMessageSent);
|
|
|
|
var messageName = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(messageName);
|
|
|
|
Server.CustomMessagingManager.SendNamedMessage(messageName.Value.ToString(), FirstClient.LocalClientId, writer);
|
|
}
|
|
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
var namedMessageSentMetricValues = waitForMetricValues.AssertMetricValuesHaveBeenFound();
|
|
Assert.AreEqual(1, namedMessageSentMetricValues.Count);
|
|
|
|
var namedMessageSent = namedMessageSentMetricValues.First();
|
|
Assert.AreEqual(messageName.Value.ToString(), namedMessageSent.Name);
|
|
Assert.AreEqual(FirstClient.LocalClientId, namedMessageSent.Connection.Id);
|
|
Assert.AreEqual(FastBufferWriter.GetWriteSize(messageName) + k_NamedMessageOverhead, namedMessageSent.BytesCount);
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackNamedMessageSentMetricToMultipleClients()
|
|
{
|
|
var waitForMetricValues = new WaitForEventMetricValues<NamedMessageEvent>(ServerMetrics.Dispatcher, NetworkMetricTypes.NamedMessageSent);
|
|
var messageName = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(messageName);
|
|
|
|
Server.CustomMessagingManager.SendNamedMessage(messageName.Value.ToString(), new List<ulong> { FirstClient.LocalClientId, SecondClient.LocalClientId }, writer);
|
|
}
|
|
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
var namedMessageSentMetricValues = waitForMetricValues.AssertMetricValuesHaveBeenFound();
|
|
Assert.AreEqual(2, namedMessageSentMetricValues.Count);
|
|
Assert.That(namedMessageSentMetricValues.Select(x => x.Name), Has.All.EqualTo(messageName.Value.ToString()));
|
|
Assert.That(namedMessageSentMetricValues.Select(x => x.BytesCount), Has.All.EqualTo(FastBufferWriter.GetWriteSize(messageName) + k_NamedMessageOverhead));
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackNamedMessageSentMetricToSelf()
|
|
{
|
|
var waitForMetricValues = new WaitForEventMetricValues<NamedMessageEvent>(ServerMetrics.Dispatcher, NetworkMetricTypes.NamedMessageSent);
|
|
var messageName = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(messageName);
|
|
|
|
Server.CustomMessagingManager.SendNamedMessage(messageName.Value.ToString(), Server.LocalClientId, writer);
|
|
}
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
waitForMetricValues.AssertMetricValuesHaveNotBeenFound();
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackNamedMessageReceivedMetric()
|
|
{
|
|
var waitForMetricValues = new WaitForEventMetricValues<NamedMessageEvent>(FirstClientMetrics.Dispatcher, NetworkMetricTypes.NamedMessageReceived);
|
|
|
|
var messageName = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
|
|
LogAssert.Expect(LogType.Log, $"Received from {Server.LocalClientId}");
|
|
FirstClient.CustomMessagingManager.RegisterNamedMessageHandler(messageName.Value.ToString(), (ulong sender, FastBufferReader payload) =>
|
|
{
|
|
Debug.Log($"Received from {sender}");
|
|
});
|
|
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(messageName);
|
|
|
|
Server.CustomMessagingManager.SendNamedMessage(messageName.Value.ToString(), FirstClient.LocalClientId, writer);
|
|
}
|
|
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
var namedMessageReceivedValues = waitForMetricValues.AssertMetricValuesHaveBeenFound();
|
|
Assert.AreEqual(1, namedMessageReceivedValues.Count);
|
|
|
|
var namedMessageReceived = namedMessageReceivedValues.First();
|
|
Assert.AreEqual(messageName.Value.ToString(), namedMessageReceived.Name);
|
|
Assert.AreEqual(Server.LocalClientId, namedMessageReceived.Connection.Id);
|
|
Assert.AreEqual(FastBufferWriter.GetWriteSize(messageName) + k_NamedMessageOverhead, namedMessageReceived.BytesCount);
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackUnnamedMessageSentMetric()
|
|
{
|
|
var message = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(message);
|
|
|
|
Server.CustomMessagingManager.SendUnnamedMessage(FirstClient.LocalClientId, writer);
|
|
}
|
|
|
|
|
|
var waitForMetricValues = new WaitForEventMetricValues<UnnamedMessageEvent>(ServerMetrics.Dispatcher, NetworkMetricTypes.UnnamedMessageSent);
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
var unnamedMessageSentMetricValues = waitForMetricValues.AssertMetricValuesHaveBeenFound();
|
|
Assert.AreEqual(1, unnamedMessageSentMetricValues.Count);
|
|
|
|
var unnamedMessageSent = unnamedMessageSentMetricValues.First();
|
|
Assert.AreEqual(FirstClient.LocalClientId, unnamedMessageSent.Connection.Id);
|
|
Assert.AreEqual(FastBufferWriter.GetWriteSize(message) + k_UnnamedMessageOverhead, unnamedMessageSent.BytesCount);
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackUnnamedMessageSentMetricToMultipleClients()
|
|
{
|
|
var message = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
var waitForMetricValues = new WaitForEventMetricValues<UnnamedMessageEvent>(ServerMetrics.Dispatcher, NetworkMetricTypes.UnnamedMessageSent);
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(message);
|
|
|
|
Server.CustomMessagingManager.SendUnnamedMessage(new List<ulong> { FirstClient.LocalClientId, SecondClient.LocalClientId }, writer);
|
|
}
|
|
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
var unnamedMessageSentMetricValues = waitForMetricValues.AssertMetricValuesHaveBeenFound();
|
|
Assert.AreEqual(2, unnamedMessageSentMetricValues.Count);
|
|
Assert.That(unnamedMessageSentMetricValues.Select(x => x.BytesCount), Has.All.EqualTo(FastBufferWriter.GetWriteSize(message) + k_UnnamedMessageOverhead));
|
|
|
|
var clientIds = unnamedMessageSentMetricValues.Select(x => x.Connection.Id).ToList();
|
|
Assert.Contains(FirstClient.LocalClientId, clientIds);
|
|
Assert.Contains(SecondClient.LocalClientId, clientIds);
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackUnnamedMessageSentMetricToSelf()
|
|
{
|
|
var waitForMetricValues = new WaitForEventMetricValues<UnnamedMessageEvent>(ServerMetrics.Dispatcher, NetworkMetricTypes.UnnamedMessageSent);
|
|
var messageName = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(messageName);
|
|
|
|
Server.CustomMessagingManager.SendUnnamedMessage(Server.LocalClientId, writer);
|
|
}
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
waitForMetricValues.AssertMetricValuesHaveNotBeenFound();
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TrackUnnamedMessageReceivedMetric()
|
|
{
|
|
var message = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
var waitForMetricValues = new WaitForEventMetricValues<UnnamedMessageEvent>(FirstClientMetrics.Dispatcher, NetworkMetricTypes.UnnamedMessageReceived);
|
|
using (var writer = new FastBufferWriter(1300, Allocator.Temp))
|
|
{
|
|
writer.WriteValueSafe(message);
|
|
|
|
Server.CustomMessagingManager.SendUnnamedMessage(FirstClient.LocalClientId, writer);
|
|
}
|
|
|
|
yield return waitForMetricValues.WaitForMetricsReceived();
|
|
|
|
var unnamedMessageReceivedValues = waitForMetricValues.AssertMetricValuesHaveBeenFound();
|
|
Assert.AreEqual(1, unnamedMessageReceivedValues.Count);
|
|
|
|
var unnamedMessageReceived = unnamedMessageReceivedValues.First();
|
|
Assert.AreEqual(Server.LocalClientId, unnamedMessageReceived.Connection.Id);
|
|
Assert.AreEqual(FastBufferWriter.GetWriteSize(message) + k_UnnamedMessageOverhead, unnamedMessageReceived.BytesCount);
|
|
}
|
|
}
|
|
}
|
|
#endif
|