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.7.0] - 2023-10-11 ### Added - exposed NetworkObject.GetNetworkBehaviourAtOrderIndex as a public API (#2724) - Added context menu tool that provides users with the ability to quickly update the GlobalObjectIdHash value for all in-scene placed prefab instances that were created prior to adding a NetworkObject component to it. (#2707) - Added methods NetworkManager.SetPeerMTU and NetworkManager.GetPeerMTU to be able to set MTU sizes per-peer (#2676) - Added `GenerateSerializationForGenericParameterAttribute`, which can be applied to user-created Network Variable types to ensure the codegen generates serialization for the generic types they wrap. (#2694) - Added `GenerateSerializationForTypeAttribute`, which can be applied to any class or method to ensure the codegen generates serialization for the specific provided type. (#2694) - Exposed `NetworkVariableSerialization<T>.Read`, `NetworkVariableSerialization<T>.Write`, `NetworkVariableSerialization<T>.AreEqual`, and `NetworkVariableSerialization<T>.Duplicate` to further support the creation of user-created network variables by allowing users to access the generated serialization methods and serialize generic types efficiently without boxing. (#2694) - Added `NetworkVariableBase.MarkNetworkBehaviourDirty` so that user-created network variable types can mark their containing `NetworkBehaviour` to be processed by the update loop. (#2694) ### Fixed - Fixed issue where the server side `NetworkSceneManager` instance was not adding the currently active scene to its list of scenes loaded. (#2723) - Generic NetworkBehaviour types no longer result in compile errors or runtime errors (#2720) - Rpcs within Generic NetworkBehaviour types can now serialize parameters of the class's generic types (but may not have generic types of their own) (#2720) - Errors are no longer thrown when entering play mode with domain reload disabled (#2720) - NetworkSpawn is now correctly called each time when entering play mode with scene reload disabled (#2720) - NetworkVariables of non-integer types will no longer break the inspector (#2714) - NetworkVariables with NonSerializedAttribute will not appear in the inspector (#2714) - Fixed issue where `UnityTransport` would attempt to establish WebSocket connections even if using UDP/DTLS Relay allocations when the build target was WebGL. This only applied to working in the editor since UDP/DTLS can't work in the browser. (#2695) - Fixed issue where a `NetworkBehaviour` component's `OnNetworkDespawn` was not being invoked on the host-server side for an in-scene placed `NetworkObject` when a scene was unloaded (during a scene transition) and the `NetworkBehaviour` component was positioned/ordered before the `NetworkObject` component. (#2685) - Fixed issue where `SpawnWithObservers` was not being honored when `NetworkConfig.EnableSceneManagement` was disabled. (#2682) - Fixed issue where `NetworkAnimator` was not internally tracking changes to layer weights which prevented proper layer weight synchronization back to the original layer weight value. (#2674) - Fixed "writing past the end of the buffer" error when calling ResetDirty() on managed network variables that are larger than 256 bytes when serialized. (#2670) - Fixed issue where generation of the `DefaultNetworkPrefabs` asset was not enabled by default. (#2662) - Fixed issue where the `GlobalObjectIdHash` value could be updated but the asset not marked as dirty. (#2662) - Fixed issue where the `GlobalObjectIdHash` value of a (network) prefab asset could be assigned an incorrect value when editing the prefab in a temporary scene. (#2662) - Fixed issue where the `GlobalObjectIdHash` value generated after creating a (network) prefab from an object constructed within the scene would not be the correct final value in a stand alone build. (#2662) ### Changed - Updated dependency on `com.unity.transport` to version 1.4.0. (#2716)
152 lines
7.2 KiB
C#
152 lines
7.2 KiB
C#
using System.Collections.Generic;
|
|
using Unity.Collections;
|
|
|
|
namespace Unity.Netcode
|
|
{
|
|
internal struct ConnectionApprovedMessage : INetworkMessage
|
|
{
|
|
public int Version => 0;
|
|
|
|
public ulong OwnerClientId;
|
|
public int NetworkTick;
|
|
|
|
// Not serialized, held as references to serialize NetworkVariable data
|
|
public HashSet<NetworkObject> SpawnedObjectsList;
|
|
|
|
private FastBufferReader m_ReceivedSceneObjectData;
|
|
|
|
public NativeArray<MessageVersionData> MessageVersions;
|
|
|
|
public void Serialize(FastBufferWriter writer, int targetVersion)
|
|
{
|
|
// ============================================================
|
|
// BEGIN FORBIDDEN SEGMENT
|
|
// DO NOT CHANGE THIS HEADER. Everything added to this message
|
|
// must go AFTER the message version header.
|
|
// ============================================================
|
|
BytePacker.WriteValueBitPacked(writer, MessageVersions.Length);
|
|
foreach (var messageVersion in MessageVersions)
|
|
{
|
|
messageVersion.Serialize(writer);
|
|
}
|
|
// ============================================================
|
|
// END FORBIDDEN SEGMENT
|
|
// ============================================================
|
|
|
|
BytePacker.WriteValueBitPacked(writer, OwnerClientId);
|
|
BytePacker.WriteValueBitPacked(writer, NetworkTick);
|
|
|
|
uint sceneObjectCount = 0;
|
|
|
|
// When SpawnedObjectsList is not null then scene management is disabled. Provide a list of
|
|
// all observed and spawned NetworkObjects that the approved client needs to synchronize.
|
|
if (SpawnedObjectsList != null)
|
|
{
|
|
var pos = writer.Position;
|
|
writer.Seek(writer.Position + FastBufferWriter.GetWriteSize(sceneObjectCount));
|
|
|
|
// Serialize NetworkVariable data
|
|
foreach (var sobj in SpawnedObjectsList)
|
|
{
|
|
if (sobj.SpawnWithObservers && (sobj.CheckObjectVisibility == null || sobj.CheckObjectVisibility(OwnerClientId)))
|
|
{
|
|
sobj.Observers.Add(OwnerClientId);
|
|
var sceneObject = sobj.GetMessageSceneObject(OwnerClientId);
|
|
sceneObject.Serialize(writer);
|
|
++sceneObjectCount;
|
|
}
|
|
}
|
|
|
|
writer.Seek(pos);
|
|
// Can't pack this value because its space is reserved, so it needs to always use all the reserved space.
|
|
writer.WriteValueSafe(sceneObjectCount);
|
|
writer.Seek(writer.Length);
|
|
}
|
|
else
|
|
{
|
|
writer.WriteValueSafe(sceneObjectCount);
|
|
}
|
|
}
|
|
|
|
public bool Deserialize(FastBufferReader reader, ref NetworkContext context, int receivedMessageVersion)
|
|
{
|
|
var networkManager = (NetworkManager)context.SystemOwner;
|
|
if (!networkManager.IsClient)
|
|
{
|
|
return false;
|
|
}
|
|
|
|
// ============================================================
|
|
// BEGIN FORBIDDEN SEGMENT
|
|
// DO NOT CHANGE THIS HEADER. Everything added to this message
|
|
// must go AFTER the message version header.
|
|
// ============================================================
|
|
ByteUnpacker.ReadValueBitPacked(reader, out int length);
|
|
var messageHashesInOrder = new NativeArray<uint>(length, Allocator.Temp);
|
|
for (var i = 0; i < length; ++i)
|
|
{
|
|
var messageVersion = new MessageVersionData();
|
|
messageVersion.Deserialize(reader);
|
|
networkManager.ConnectionManager.MessageManager.SetVersion(context.SenderId, messageVersion.Hash, messageVersion.Version);
|
|
messageHashesInOrder[i] = messageVersion.Hash;
|
|
|
|
// Update the received version since this message will always be passed version 0, due to the map not
|
|
// being initialized until just now.
|
|
var messageType = networkManager.ConnectionManager.MessageManager.GetMessageForHash(messageVersion.Hash);
|
|
if (messageType == typeof(ConnectionApprovedMessage))
|
|
{
|
|
receivedMessageVersion = messageVersion.Version;
|
|
}
|
|
}
|
|
networkManager.ConnectionManager.MessageManager.SetServerMessageOrder(messageHashesInOrder);
|
|
messageHashesInOrder.Dispose();
|
|
// ============================================================
|
|
// END FORBIDDEN SEGMENT
|
|
// ============================================================
|
|
|
|
ByteUnpacker.ReadValueBitPacked(reader, out OwnerClientId);
|
|
ByteUnpacker.ReadValueBitPacked(reader, out NetworkTick);
|
|
m_ReceivedSceneObjectData = reader;
|
|
return true;
|
|
}
|
|
|
|
public void Handle(ref NetworkContext context)
|
|
{
|
|
var networkManager = (NetworkManager)context.SystemOwner;
|
|
networkManager.LocalClientId = OwnerClientId;
|
|
networkManager.NetworkMetrics.SetConnectionId(networkManager.LocalClientId);
|
|
|
|
var time = new NetworkTime(networkManager.NetworkTickSystem.TickRate, NetworkTick);
|
|
networkManager.NetworkTimeSystem.Reset(time.Time, 0.15f); // Start with a constant RTT of 150 until we receive values from the transport.
|
|
networkManager.NetworkTickSystem.Reset(networkManager.NetworkTimeSystem.LocalTime, networkManager.NetworkTimeSystem.ServerTime);
|
|
|
|
networkManager.ConnectionManager.LocalClient.SetRole(false, true, networkManager);
|
|
networkManager.ConnectionManager.LocalClient.IsApproved = true;
|
|
networkManager.ConnectionManager.LocalClient.ClientId = OwnerClientId;
|
|
// Stop the client-side approval timeout coroutine since we are approved.
|
|
networkManager.ConnectionManager.StopClientApprovalCoroutine();
|
|
|
|
// Only if scene management is disabled do we handle NetworkObject synchronization at this point
|
|
if (!networkManager.NetworkConfig.EnableSceneManagement)
|
|
{
|
|
networkManager.SpawnManager.DestroySceneObjects();
|
|
m_ReceivedSceneObjectData.ReadValueSafe(out uint sceneObjectCount);
|
|
|
|
// Deserializing NetworkVariable data is deferred from Receive() to Handle to avoid needing
|
|
// to create a list to hold the data. This is a breach of convention for performance reasons.
|
|
for (ushort i = 0; i < sceneObjectCount; i++)
|
|
{
|
|
var sceneObject = new NetworkObject.SceneObject();
|
|
sceneObject.Deserialize(m_ReceivedSceneObjectData);
|
|
NetworkObject.AddSceneObject(sceneObject, m_ReceivedSceneObjectData, networkManager);
|
|
}
|
|
|
|
// Mark the client being connected
|
|
networkManager.IsConnectedClient = true;
|
|
// When scene management is disabled we notify after everything is synchronized
|
|
networkManager.ConnectionManager.InvokeOnClientConnectedCallback(context.SenderId);
|
|
}
|
|
}
|
|
}
|
|
}
|