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)
183 lines
7.3 KiB
C#
183 lines
7.3 KiB
C#
using System.Collections;
|
|
using System.Collections.Generic;
|
|
using NUnit.Framework;
|
|
using Unity.Netcode.TestHelpers.Runtime;
|
|
using UnityEngine.TestTools;
|
|
|
|
namespace Unity.Netcode.RuntimeTests
|
|
{
|
|
[TestFixture(HostOrServer.DAHost)]
|
|
[TestFixture(HostOrServer.Host)]
|
|
internal class NetworkVarBufferCopyTest : NetcodeIntegrationTest
|
|
{
|
|
internal class DummyNetVar : NetworkVariableBase
|
|
{
|
|
private const int k_DummyValue = 0x13579BDF;
|
|
public bool DeltaWritten;
|
|
public bool FieldWritten;
|
|
public bool DeltaRead;
|
|
public bool FieldRead;
|
|
|
|
public override void WriteDelta(FastBufferWriter writer)
|
|
{
|
|
writer.TryBeginWrite(FastBufferWriter.GetWriteSize(k_DummyValue) + 1);
|
|
using (var bitWriter = writer.EnterBitwiseContext())
|
|
{
|
|
bitWriter.WriteBits(1, 1);
|
|
}
|
|
writer.WriteValue(k_DummyValue);
|
|
|
|
DeltaWritten = true;
|
|
}
|
|
|
|
public override void WriteField(FastBufferWriter writer)
|
|
{
|
|
writer.TryBeginWrite(FastBufferWriter.GetWriteSize(k_DummyValue) + 1);
|
|
using (var bitWriter = writer.EnterBitwiseContext())
|
|
{
|
|
bitWriter.WriteBits(1, 1);
|
|
}
|
|
writer.WriteValue(k_DummyValue);
|
|
|
|
FieldWritten = true;
|
|
}
|
|
|
|
public override void ReadField(FastBufferReader reader)
|
|
{
|
|
reader.TryBeginRead(FastBufferWriter.GetWriteSize(k_DummyValue) + 1);
|
|
using (var bitReader = reader.EnterBitwiseContext())
|
|
{
|
|
bitReader.ReadBits(out byte b, 1);
|
|
}
|
|
|
|
reader.ReadValue(out int i);
|
|
Assert.AreEqual(k_DummyValue, i);
|
|
|
|
FieldRead = true;
|
|
}
|
|
|
|
public override void ReadDelta(FastBufferReader reader, bool keepDirtyDelta)
|
|
{
|
|
reader.TryBeginRead(FastBufferWriter.GetWriteSize(k_DummyValue) + 1);
|
|
using (var bitReader = reader.EnterBitwiseContext())
|
|
{
|
|
bitReader.ReadBits(out byte b, 1);
|
|
}
|
|
|
|
reader.ReadValue(out int i);
|
|
Assert.AreEqual(k_DummyValue, i);
|
|
|
|
DeltaRead = true;
|
|
}
|
|
|
|
public DummyNetVar(
|
|
NetworkVariableReadPermission readPerm = DefaultReadPerm,
|
|
NetworkVariableWritePermission writePerm = DefaultWritePerm) : base(readPerm, writePerm) { }
|
|
}
|
|
|
|
internal class DummyNetBehaviour : NetworkBehaviour
|
|
{
|
|
public static bool DistributedAuthority;
|
|
public DummyNetVar NetVar;
|
|
|
|
private void Awake()
|
|
{
|
|
if (DistributedAuthority)
|
|
{
|
|
NetVar = new DummyNetVar(writePerm: NetworkVariableWritePermission.Owner);
|
|
}
|
|
else
|
|
{
|
|
NetVar = new DummyNetVar();
|
|
}
|
|
}
|
|
|
|
public override void OnNetworkSpawn()
|
|
{
|
|
if ((NetworkManager.DistributedAuthorityMode && !IsOwner) || (!NetworkManager.DistributedAuthorityMode && !IsServer))
|
|
{
|
|
ClientDummyNetBehaviourSpawned(this);
|
|
}
|
|
base.OnNetworkSpawn();
|
|
}
|
|
}
|
|
protected override int NumberOfClients => 1;
|
|
|
|
public NetworkVarBufferCopyTest(HostOrServer hostOrServer) : base(hostOrServer) { }
|
|
|
|
private static List<DummyNetBehaviour> s_ClientDummyNetBehavioursSpawned = new List<DummyNetBehaviour>();
|
|
public static void ClientDummyNetBehaviourSpawned(DummyNetBehaviour dummyNetBehaviour)
|
|
{
|
|
s_ClientDummyNetBehavioursSpawned.Add(dummyNetBehaviour);
|
|
}
|
|
|
|
protected override IEnumerator OnSetup()
|
|
{
|
|
s_ClientDummyNetBehavioursSpawned.Clear();
|
|
return base.OnSetup();
|
|
}
|
|
|
|
protected override void OnCreatePlayerPrefab()
|
|
{
|
|
DummyNetBehaviour.DistributedAuthority = m_DistributedAuthority;
|
|
m_PlayerPrefab.AddComponent<DummyNetBehaviour>();
|
|
}
|
|
|
|
[UnityTest]
|
|
public IEnumerator TestEntireBufferIsCopiedOnNetworkVariableDelta()
|
|
{
|
|
// This is the *SERVER VERSION* of the *CLIENT PLAYER*
|
|
var serverClientPlayerResult = new NetcodeIntegrationTestHelpers.ResultWrapper<NetworkObject>();
|
|
yield return NetcodeIntegrationTestHelpers.GetNetworkObjectByRepresentation(
|
|
x => x.IsPlayerObject && x.OwnerClientId == m_ClientNetworkManagers[0].LocalClientId,
|
|
m_ServerNetworkManager, serverClientPlayerResult);
|
|
|
|
var serverSideClientPlayer = serverClientPlayerResult.Result;
|
|
var serverComponent = serverSideClientPlayer.GetComponent<DummyNetBehaviour>();
|
|
|
|
// This is the *CLIENT VERSION* of the *CLIENT PLAYER*
|
|
var clientClientPlayerResult = new NetcodeIntegrationTestHelpers.ResultWrapper<NetworkObject>();
|
|
yield return NetcodeIntegrationTestHelpers.GetNetworkObjectByRepresentation(
|
|
x => x.IsPlayerObject && x.OwnerClientId == m_ClientNetworkManagers[0].LocalClientId,
|
|
m_ClientNetworkManagers[0], clientClientPlayerResult);
|
|
|
|
var clientSideClientPlayer = clientClientPlayerResult.Result;
|
|
var clientComponent = clientSideClientPlayer.GetComponent<DummyNetBehaviour>();
|
|
|
|
// Wait for the DummyNetBehaviours on the client side to notify they have been initialized and spawned
|
|
yield return WaitForConditionOrTimeOut(() => s_ClientDummyNetBehavioursSpawned.Count >= 1);
|
|
Assert.IsFalse(s_GlobalTimeoutHelper.TimedOut, "Timed out waiting for client side DummyNetBehaviour to register it was spawned!");
|
|
|
|
// Check that FieldWritten is written when dirty
|
|
var authorityComponent = m_DistributedAuthority ? clientComponent : serverComponent;
|
|
var nonAuthorityComponent = m_DistributedAuthority ? serverComponent : clientComponent;
|
|
authorityComponent.NetVar.SetDirty(true);
|
|
yield return s_DefaultWaitForTick;
|
|
Assert.True(authorityComponent.NetVar.FieldWritten);
|
|
// Check that DeltaWritten is written when dirty
|
|
authorityComponent.NetVar.SetDirty(true);
|
|
yield return s_DefaultWaitForTick;
|
|
Assert.True(authorityComponent.NetVar.DeltaWritten);
|
|
|
|
|
|
// Check that both FieldRead and DeltaRead were invoked on the client side
|
|
yield return WaitForConditionOrTimeOut(() => nonAuthorityComponent.NetVar.FieldRead == true && nonAuthorityComponent.NetVar.DeltaRead == true);
|
|
|
|
var timedOutMessage = "Timed out waiting for client reads: ";
|
|
if (s_GlobalTimeoutHelper.TimedOut)
|
|
{
|
|
if (!nonAuthorityComponent.NetVar.FieldRead)
|
|
{
|
|
timedOutMessage += "[FieldRead]";
|
|
}
|
|
|
|
if (!nonAuthorityComponent.NetVar.DeltaRead)
|
|
{
|
|
timedOutMessage += "[DeltaRead]";
|
|
}
|
|
}
|
|
Assert.IsFalse(s_GlobalTimeoutHelper.TimedOut, timedOutMessage);
|
|
}
|
|
}
|
|
}
|