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.2.0] - 2022-11-21 ### Added - Added protected method `NetworkBehaviour.OnSynchronize` which is invoked during the initial `NetworkObject` synchronization process. This provides users the ability to include custom serialization information that will be applied to the `NetworkBehaviour` prior to the `NetworkObject` being spawned. (#2298) - Added support for different versions of the SDK to talk to each other in circumstances where changes permit it. Starting with this version and into future versions, patch versions should be compatible as long as the minor version is the same. (#2290) - Added `NetworkObject` auto-add helper and Multiplayer Tools install reminder settings to Project Settings. (#2285) - Added `public string DisconnectReason` getter to `NetworkManager` and `string Reason` to `ConnectionApprovalResponse`. Allows connection approval to communicate back a reason. Also added `public void DisconnectClient(ulong clientId, string reason)` allowing setting a disconnection reason, when explicitly disconnecting a client. (#2280) ### Changed - Changed 3rd-party `XXHash` (32 & 64) implementation with an in-house reimplementation (#2310) - When `NetworkConfig.EnsureNetworkVariableLengthSafety` is disabled `NetworkVariable` fields do not write the additional `ushort` size value (_which helps to reduce the total synchronization message size_), but when enabled it still writes the additional `ushort` value. (#2298) - Optimized bandwidth usage by encoding most integer fields using variable-length encoding. (#2276) ### Fixed - Fixed issue where `NetworkTransform` components nested under a parent with a `NetworkObject` component (i.e. network prefab) would not have their associated `GameObject`'s transform synchronized. (#2298) - Fixed issue where `NetworkObject`s that failed to instantiate could cause the entire synchronization pipeline to be disrupted/halted for a connecting client. (#2298) - Fixed issue where in-scene placed `NetworkObject`s nested under a `GameObject` would be added to the orphaned children list causing continual console warning log messages. (#2298) - Custom messages are now properly received by the local client when they're sent while running in host mode. (#2296) - Fixed issue where the host would receive more than one event completed notification when loading or unloading a scene only when no clients were connected. (#2292) - Fixed an issue in `UnityTransport` where an error would be logged if the 'Use Encryption' flag was enabled with a Relay configuration that used a secure protocol. (#2289) - Fixed issue where in-scene placed `NetworkObjects` were not honoring the `AutoObjectParentSync` property. (#2281) - Fixed the issue where `NetworkManager.OnClientConnectedCallback` was being invoked before in-scene placed `NetworkObject`s had been spawned when starting `NetworkManager` as a host. (#2277) - Creating a `FastBufferReader` with `Allocator.None` will not result in extra memory being allocated for the buffer (since it's owned externally in that scenario). (#2265) ### Removed - Removed the `NetworkObject` auto-add and Multiplayer Tools install reminder settings from the Menu interface. (#2285)
199 lines
8.5 KiB
C#
199 lines
8.5 KiB
C#
using System;
|
|
using System.Collections;
|
|
using System.Collections.Generic;
|
|
using NUnit.Framework;
|
|
using Unity.Collections;
|
|
using UnityEngine.TestTools;
|
|
using Unity.Netcode.TestHelpers.Runtime;
|
|
|
|
namespace Unity.Netcode.RuntimeTests
|
|
{
|
|
public class UnnamedMessageTests : NetcodeIntegrationTest
|
|
{
|
|
protected override int NumberOfClients => 2;
|
|
|
|
private NetworkManager FirstClient => m_ClientNetworkManagers[0];
|
|
private NetworkManager SecondClient => m_ClientNetworkManagers[1];
|
|
|
|
[UnityTest]
|
|
public IEnumerator UnnamedMessageIsReceivedOnClientWithContent()
|
|
{
|
|
ulong receivedMessageSender = 0;
|
|
var receivedMessageContent = new ForceNetworkSerializeByMemcpy<Guid>(new Guid());
|
|
FirstClient.CustomMessagingManager.OnUnnamedMessage +=
|
|
(ulong sender, FastBufferReader reader) =>
|
|
{
|
|
receivedMessageSender = sender;
|
|
|
|
reader.ReadValueSafe(out receivedMessageContent);
|
|
};
|
|
|
|
var messageContent = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
var writer = new FastBufferWriter(1300, Allocator.Temp);
|
|
using (writer)
|
|
{
|
|
writer.WriteValueSafe(messageContent);
|
|
m_ServerNetworkManager.CustomMessagingManager.SendUnnamedMessage(
|
|
FirstClient.LocalClientId,
|
|
writer);
|
|
}
|
|
|
|
yield return WaitForMessageReceived<UnnamedMessage>(new List<NetworkManager> { FirstClient });
|
|
|
|
Assert.AreEqual(messageContent.Value, receivedMessageContent.Value);
|
|
Assert.AreEqual(m_ServerNetworkManager.LocalClientId, receivedMessageSender);
|
|
}
|
|
|
|
[Test]
|
|
public void UnnamedMessageIsReceivedOnHostWithContent()
|
|
{
|
|
ulong receivedMessageSender = 0;
|
|
var receivedMessageContent = new ForceNetworkSerializeByMemcpy<Guid>(new Guid());
|
|
m_ServerNetworkManager.CustomMessagingManager.OnUnnamedMessage +=
|
|
(ulong sender, FastBufferReader reader) =>
|
|
{
|
|
receivedMessageSender = sender;
|
|
|
|
reader.ReadValueSafe(out receivedMessageContent);
|
|
};
|
|
|
|
var messageContent = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
var writer = new FastBufferWriter(1300, Allocator.Temp);
|
|
using (writer)
|
|
{
|
|
writer.WriteValueSafe(messageContent);
|
|
m_ServerNetworkManager.CustomMessagingManager.SendUnnamedMessage(
|
|
m_ServerNetworkManager.LocalClientId,
|
|
writer);
|
|
}
|
|
|
|
Assert.AreEqual(messageContent.Value, receivedMessageContent.Value);
|
|
Assert.AreEqual(m_ServerNetworkManager.LocalClientId, receivedMessageSender);
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator UnnamedMessageIsReceivedOnMultipleClientsWithContent()
|
|
{
|
|
ulong firstReceivedMessageSender = 0;
|
|
var firstReceivedMessageContent = new ForceNetworkSerializeByMemcpy<Guid>(new Guid());
|
|
FirstClient.CustomMessagingManager.OnUnnamedMessage +=
|
|
(ulong sender, FastBufferReader reader) =>
|
|
{
|
|
firstReceivedMessageSender = sender;
|
|
|
|
reader.ReadValueSafe(out firstReceivedMessageContent);
|
|
};
|
|
|
|
ulong secondReceivedMessageSender = 0;
|
|
var secondReceivedMessageContent = new ForceNetworkSerializeByMemcpy<Guid>(new Guid());
|
|
SecondClient.CustomMessagingManager.OnUnnamedMessage +=
|
|
(ulong sender, FastBufferReader reader) =>
|
|
{
|
|
secondReceivedMessageSender = sender;
|
|
|
|
reader.ReadValueSafe(out secondReceivedMessageContent);
|
|
};
|
|
|
|
ulong thirdReceivedMessageSender = 0;
|
|
var thirdReceivedMessageContent = new ForceNetworkSerializeByMemcpy<Guid>(new Guid());
|
|
m_ServerNetworkManager.CustomMessagingManager.OnUnnamedMessage +=
|
|
(ulong sender, FastBufferReader reader) =>
|
|
{
|
|
thirdReceivedMessageSender = sender;
|
|
|
|
reader.ReadValueSafe(out thirdReceivedMessageContent);
|
|
};
|
|
|
|
var messageContent = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
var writer = new FastBufferWriter(1300, Allocator.Temp);
|
|
using (writer)
|
|
{
|
|
writer.WriteValueSafe(messageContent);
|
|
m_ServerNetworkManager.CustomMessagingManager.SendUnnamedMessage(
|
|
new List<ulong> { m_ServerNetworkManager.LocalClientId, FirstClient.LocalClientId, SecondClient.LocalClientId },
|
|
writer);
|
|
}
|
|
|
|
yield return WaitForMessageReceived<UnnamedMessage>(new List<NetworkManager> { FirstClient, SecondClient });
|
|
|
|
Assert.AreEqual(messageContent.Value, firstReceivedMessageContent.Value);
|
|
Assert.AreEqual(m_ServerNetworkManager.LocalClientId, firstReceivedMessageSender);
|
|
|
|
Assert.AreEqual(messageContent.Value, secondReceivedMessageContent.Value);
|
|
Assert.AreEqual(m_ServerNetworkManager.LocalClientId, secondReceivedMessageSender);
|
|
|
|
Assert.AreEqual(messageContent.Value, thirdReceivedMessageContent.Value);
|
|
Assert.AreEqual(m_ServerNetworkManager.LocalClientId, thirdReceivedMessageSender);
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator WhenSendingUnnamedMessageToAll_AllClientsReceiveIt()
|
|
{
|
|
ulong firstReceivedMessageSender = 0;
|
|
var firstReceivedMessageContent = new ForceNetworkSerializeByMemcpy<Guid>(new Guid());
|
|
FirstClient.CustomMessagingManager.OnUnnamedMessage +=
|
|
(ulong sender, FastBufferReader reader) =>
|
|
{
|
|
firstReceivedMessageSender = sender;
|
|
|
|
reader.ReadValueSafe(out firstReceivedMessageContent);
|
|
};
|
|
|
|
ulong secondReceivedMessageSender = 0;
|
|
var secondReceivedMessageContent = new ForceNetworkSerializeByMemcpy<Guid>(new Guid());
|
|
SecondClient.CustomMessagingManager.OnUnnamedMessage +=
|
|
(ulong sender, FastBufferReader reader) =>
|
|
{
|
|
secondReceivedMessageSender = sender;
|
|
|
|
reader.ReadValueSafe(out secondReceivedMessageContent);
|
|
};
|
|
|
|
ulong thirdReceivedMessageSender = 0;
|
|
var thirdReceivedMessageContent = new ForceNetworkSerializeByMemcpy<Guid>(new Guid());
|
|
m_ServerNetworkManager.CustomMessagingManager.OnUnnamedMessage +=
|
|
(ulong sender, FastBufferReader reader) =>
|
|
{
|
|
thirdReceivedMessageSender = sender;
|
|
|
|
reader.ReadValueSafe(out thirdReceivedMessageContent);
|
|
};
|
|
|
|
var messageContent = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
var writer = new FastBufferWriter(1300, Allocator.Temp);
|
|
using (writer)
|
|
{
|
|
writer.WriteValueSafe(messageContent);
|
|
m_ServerNetworkManager.CustomMessagingManager.SendUnnamedMessageToAll(writer);
|
|
}
|
|
|
|
yield return WaitForMessageReceived<UnnamedMessage>(new List<NetworkManager> { FirstClient, SecondClient });
|
|
|
|
Assert.AreEqual(messageContent.Value, firstReceivedMessageContent.Value);
|
|
Assert.AreEqual(m_ServerNetworkManager.LocalClientId, firstReceivedMessageSender);
|
|
|
|
Assert.AreEqual(messageContent.Value, secondReceivedMessageContent.Value);
|
|
Assert.AreEqual(m_ServerNetworkManager.LocalClientId, secondReceivedMessageSender);
|
|
|
|
Assert.AreEqual(messageContent.Value, thirdReceivedMessageContent.Value);
|
|
Assert.AreEqual(m_ServerNetworkManager.LocalClientId, thirdReceivedMessageSender);
|
|
}
|
|
|
|
[Test]
|
|
public void WhenSendingNamedMessageToNullClientList_ArgumentNullExceptionIsThrown()
|
|
{
|
|
var messageContent = new ForceNetworkSerializeByMemcpy<Guid>(Guid.NewGuid());
|
|
var writer = new FastBufferWriter(1300, Allocator.Temp);
|
|
using (writer)
|
|
{
|
|
writer.WriteValueSafe(messageContent);
|
|
Assert.Throws<ArgumentNullException>(
|
|
() =>
|
|
{
|
|
m_ServerNetworkManager.CustomMessagingManager.SendUnnamedMessage(null, writer);
|
|
});
|
|
}
|
|
}
|
|
}
|
|
}
|