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.1.1] - 2024-10-18 ### Added - Added ability to edit the `NetworkConfig.AutoSpawnPlayerPrefabClientSide` within the inspector view. (#3097) - Added `IContactEventHandlerWithInfo` that derives from `IContactEventHandler` that can be updated per frame to provide `ContactEventHandlerInfo` information to the `RigidbodyContactEventManager` when processing collisions. (#3094) - `ContactEventHandlerInfo.ProvideNonRigidBodyContactEvents`: When set to true, non-`Rigidbody` collisions with the registered `Rigidbody` will generate contact event notifications. (#3094) - `ContactEventHandlerInfo.HasContactEventPriority`: When set to true, the `Rigidbody` will be prioritized as the instance that generates the event if the `Rigidbody` colliding does not have priority. (#3094) - Added a static `NetworkManager.OnInstantiated` event notification to be able to track when a new `NetworkManager` instance has been instantiated. (#3088) - Added a static `NetworkManager.OnDestroying` event notification to be able to track when an existing `NetworkManager` instance is being destroyed. (#3088) ### Fixed - Fixed issue where `NetworkPrefabProcessor` would not mark the prefab list as dirty and prevent saving the `DefaultNetworkPrefabs` asset when only imports or only deletes were detected.(#3103) - Fixed an issue where nested `NetworkTransform` components in owner authoritative mode cleared their initial settings on the server, causing improper synchronization. (#3099) - Fixed issue with service not getting synchronized with in-scene placed `NetworkObject` instances when a session owner starts a `SceneEventType.Load` event. (#3096) - Fixed issue with the in-scene network prefab instance update menu tool where it was not properly updating scenes when invoked on the root prefab instance. (#3092) - Fixed an issue where newly synchronizing clients would always receive current `NetworkVariable` values, potentially causing issues with collections if there were pending updates. Now, pending state updates serialize previous values to avoid duplicates on new clients. (#3081) - Fixed issue where changing ownership would mark every `NetworkVariable` dirty. Now, it will only mark any `NetworkVariable` with owner read permissions as dirty and will send/flush any pending updates to all clients prior to sending the change in ownership message. (#3081) - Fixed an issue where transferring ownership of `NetworkVariable` collections didn't update the new owner’s previous value, causing the last added value to be detected as a change during additions or removals. (#3081) - Fixed issue where a client (or server) with no write permissions for a `NetworkVariable` using a standard .NET collection type could still modify the collection which could cause various issues depending upon the modification and collection type. (#3081) - Fixed issue where applying the position and/or rotation to the `NetworkManager.ConnectionApprovalResponse` when connection approval and auto-spawn player prefab were enabled would not apply the position and/or rotation when the player prefab was instantiated. (#3078) - Fixed issue where `NetworkObject.SpawnWithObservers` was not being honored when spawning the player prefab. (#3077) - Fixed issue with the client count not being correct on the host or server side when a client disconnects itself from a session. (#3075) ### Changed - Changed `NetworkConfig.AutoSpawnPlayerPrefabClientSide` is no longer automatically set when starting `NetworkManager`. (#3097) - Updated `NetworkVariableDeltaMessage` so the server now forwards delta state updates from clients immediately, instead of waiting until the end of the frame or the next network tick. (#3081)
208 lines
8.3 KiB
C#
208 lines
8.3 KiB
C#
using Unity.Collections;
|
|
|
|
namespace Unity.Netcode
|
|
{
|
|
/// <summary>
|
|
/// Only used when connecting to the distributed authority service
|
|
/// </summary>
|
|
internal struct ClientConfig : INetworkSerializable
|
|
{
|
|
/// <summary>
|
|
/// We start at version 1, where anything less than version 1 on the service side
|
|
/// is not bypass feature compatible.
|
|
/// </summary>
|
|
private const int k_BypassFeatureCompatible = 1;
|
|
public int Version => k_BypassFeatureCompatible;
|
|
public uint TickRate;
|
|
public bool EnableSceneManagement;
|
|
|
|
// Only gets deserialized but should never be used unless testing
|
|
public int RemoteClientVersion;
|
|
|
|
public void NetworkSerialize<T>(BufferSerializer<T> serializer) where T : IReaderWriter
|
|
{
|
|
if (serializer.IsWriter)
|
|
{
|
|
var writer = serializer.GetFastBufferWriter();
|
|
BytePacker.WriteValueBitPacked(writer, Version);
|
|
BytePacker.WriteValueBitPacked(writer, TickRate);
|
|
writer.WriteValueSafe(EnableSceneManagement);
|
|
}
|
|
else
|
|
{
|
|
var reader = serializer.GetFastBufferReader();
|
|
ByteUnpacker.ReadValueBitPacked(reader, out RemoteClientVersion);
|
|
ByteUnpacker.ReadValueBitPacked(reader, out TickRate);
|
|
reader.ReadValueSafe(out EnableSceneManagement);
|
|
}
|
|
}
|
|
}
|
|
|
|
internal struct ConnectionRequestMessage : INetworkMessage
|
|
{
|
|
// This version update is unidirectional (client to service) and version
|
|
// handling occurs on the service side. This serialized data is never sent
|
|
// to a host or server.
|
|
private const int k_SendClientConfigToService = 1;
|
|
public int Version => k_SendClientConfigToService;
|
|
|
|
public ulong ConfigHash;
|
|
public bool CMBServiceConnection;
|
|
public ClientConfig ClientConfig;
|
|
|
|
public byte[] ConnectionData;
|
|
|
|
public bool ShouldSendConnectionData;
|
|
|
|
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
|
|
// ============================================================
|
|
|
|
if (CMBServiceConnection)
|
|
{
|
|
writer.WriteNetworkSerializable(ClientConfig);
|
|
}
|
|
|
|
if (ShouldSendConnectionData)
|
|
{
|
|
writer.WriteValueSafe(ConfigHash);
|
|
writer.WriteValueSafe(ConnectionData);
|
|
}
|
|
else
|
|
{
|
|
writer.WriteValueSafe(ConfigHash);
|
|
}
|
|
}
|
|
|
|
public bool Deserialize(FastBufferReader reader, ref NetworkContext context, int receivedMessageVersion)
|
|
{
|
|
var networkManager = (NetworkManager)context.SystemOwner;
|
|
if (!networkManager.IsServer)
|
|
{
|
|
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);
|
|
for (var i = 0; i < length; ++i)
|
|
{
|
|
var messageVersion = new MessageVersionData();
|
|
messageVersion.Deserialize(reader);
|
|
networkManager.ConnectionManager.MessageManager.SetVersion(context.SenderId, messageVersion.Hash, messageVersion.Version);
|
|
|
|
// 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(ConnectionRequestMessage))
|
|
{
|
|
receivedMessageVersion = messageVersion.Version;
|
|
}
|
|
}
|
|
// ============================================================
|
|
// END FORBIDDEN SEGMENT
|
|
// ============================================================
|
|
|
|
if (networkManager.NetworkConfig.ConnectionApproval)
|
|
{
|
|
if (!reader.TryBeginRead(FastBufferWriter.GetWriteSize(ConfigHash) + FastBufferWriter.GetWriteSize<int>()))
|
|
{
|
|
if (NetworkLog.CurrentLogLevel <= LogLevel.Normal)
|
|
{
|
|
NetworkLog.LogWarning($"Incomplete connection request message given config - possible {nameof(NetworkConfig)} mismatch.");
|
|
}
|
|
|
|
networkManager.DisconnectClient(context.SenderId);
|
|
return false;
|
|
}
|
|
|
|
reader.ReadValue(out ConfigHash);
|
|
|
|
if (!networkManager.NetworkConfig.CompareConfig(ConfigHash))
|
|
{
|
|
if (NetworkLog.CurrentLogLevel <= LogLevel.Normal)
|
|
{
|
|
NetworkLog.LogWarning($"{nameof(NetworkConfig)} mismatch. The configuration between the server and client does not match");
|
|
}
|
|
|
|
networkManager.DisconnectClient(context.SenderId);
|
|
return false;
|
|
}
|
|
|
|
reader.ReadValueSafe(out ConnectionData);
|
|
}
|
|
else
|
|
{
|
|
if (!reader.TryBeginRead(FastBufferWriter.GetWriteSize(ConfigHash)))
|
|
{
|
|
if (NetworkLog.CurrentLogLevel <= LogLevel.Normal)
|
|
{
|
|
NetworkLog.LogWarning($"Incomplete connection request message.");
|
|
}
|
|
|
|
networkManager.DisconnectClient(context.SenderId);
|
|
return false;
|
|
}
|
|
reader.ReadValue(out ConfigHash);
|
|
|
|
if (!networkManager.NetworkConfig.CompareConfig(ConfigHash))
|
|
{
|
|
if (NetworkLog.CurrentLogLevel <= LogLevel.Normal)
|
|
{
|
|
NetworkLog.LogWarning($"{nameof(NetworkConfig)} mismatch. The configuration between the server and client does not match");
|
|
}
|
|
|
|
networkManager.DisconnectClient(context.SenderId);
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
public void Handle(ref NetworkContext context)
|
|
{
|
|
var networkManager = (NetworkManager)context.SystemOwner;
|
|
var senderId = context.SenderId;
|
|
|
|
if (networkManager.ConnectionManager.PendingClients.TryGetValue(senderId, out PendingClient client))
|
|
{
|
|
// Set to pending approval to prevent future connection requests from being approved
|
|
client.ConnectionState = PendingClient.State.PendingApproval;
|
|
}
|
|
|
|
if (networkManager.NetworkConfig.ConnectionApproval)
|
|
{
|
|
var messageRequest = this;
|
|
networkManager.ConnectionManager.ApproveConnection(ref messageRequest, ref context);
|
|
}
|
|
else
|
|
{
|
|
var response = new NetworkManager.ConnectionApprovalResponse
|
|
{
|
|
Approved = true,
|
|
CreatePlayerObject = networkManager.DistributedAuthorityMode && networkManager.AutoSpawnPlayerPrefabClientSide ? false : networkManager.NetworkConfig.PlayerPrefab != null
|
|
};
|
|
networkManager.ConnectionManager.HandleConnectionApproval(senderId, response);
|
|
}
|
|
}
|
|
}
|
|
}
|