Migrate to the Multiplayer Services SDK
Transfer from the individual services' SDKs to the unified Multiplayer Services SDK.
読み終わるまでの所要時間 2 分最終更新 1日前
The Multiplayer Services SDK unites the functionality of the standalone SDKs from the following services: If you're already using any of the SDKs from these individual services in your project but want to move to the unified Multiplayer Services SDK, you must first migrate from the individual services' packages to the Multiplayer Services package.
Migrate from Lobby
To migrate from the Lobby SDK to the unified Multiplayer Services SDK, do the following:- Remove the Lobby package from the Package Manager.
- Install the Multiplayer Services package from the Package Manager.
- Change any usage of to
Lobbies.InstanceLobbyService.Instance
注
If you use assembly definition files (Unity Manual), change any Lobby package reference to the Multiplayer Services package.
Migrate from Matchmaker
To migrate from the Matchmaker SDK to the unified Multiplayer Services SDK, do the following:- Remove the Matchmaker package from the Package Manager.
- Install the Multiplayer Services package from the Package Manager.
注
If you use assembly definition files (Unity Manual), change any Matchmaker package reference to the Multiplayer Services package.
Migrate from Relay
To migrate from the Relay SDK to the unified Multiplayer Services SDK, do the following:- Remove the Relay package from the Package Manager.
- Install the Multiplayer Services package from the Package Manager.
- Change any usage of to
Relay.Instance.RelayService.Instance - Change constructors into
RelayServerData(hostAllocation, connectionType). Refer to the code below for more details.AllocationUtils.ToRelayServerData(hostAllocation, connectionType)
注
If you use assembly definition files (Unity Manual), change any Relay package reference to the Multiplayer Services package.
RelayServerDataFor the host
// maxConnections is the maximum number of connections the allocation is expecting// connectionType is the host connection type, this can be "dtls", "udp" or "wss"var allocation = await RelayService.Instance.CreateAllocationAsync(maxConnections);NetworkManager.Singleton.GetComponent<UnityTransport>().SetRelayServerData(AllocationUtils.ToRelayServerData(allocation, connectionType));
For the joining player
Refer to Use Relay with Netcode for GameObjects for more details on using Relay with Netcode for GameObjects with the Multiplayer Services SDK.// connectionType is the host connection type, this can be "dtls", "udp" or "wss"// joinCode is the allocation join code shared by the host player after creating the allocation and retrieving the join code var allocation = await RelayService.Instance.JoinAllocationAsync(joinCode); NetworkManager.Singleton.GetComponent<UnityTransport>().SetRelayServerData(new RelayServerData(allocation, connectionType));