Migrate to the Multiplayer Services SDK

Transfer from the individual services' SDKs to the unified Multiplayer Services SDK.

읽는 시간 2분

최근 업데이트: 15일 전

The Multiplayer Services SDK unites the functionality of the standalone SDKs from the following services:

Lobby
Matchmaker
Relay

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
```
Lobbies.Instance
```
to
```
LobbyService.Instance
```

참고

If you use assembly definition files (Unity Manual), change any Lobby package reference to the Multiplayer Services package.

You have now migrated the functionality of the Lobby SDK to the Multiplayer Services SDK in your project.

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.

You have now migrated the functionality of the Matchmaker SDK to the Multiplayer Services SDK in your project.

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
```
Relay.Instance
```
to
```
RelayService.Instance
```
.

Change

RelayServerData(hostAllocation, connectionType)

constructors into

AllocationUtils.ToRelayServerData(hostAllocation, connectionType)

. Refer to the code below for more details.

참고

If you use assembly definition files (Unity Manual), change any Relay package reference to the Multiplayer Services package.

If you use Relay with the Unity Transport Protocol (UTP), adapt the creation of the

RelayServerData

using the following sample code:

For 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"// create allocationvar allocation = await RelayService.Instance.CreateAllocationAsync(maxConnections);var relayServerData = allocation.ToRelayServerData(connectionType);NetworkManager.Singleton.GetComponent<UnityTransport>().SetRelayServerData(relayServerData);

For the joining player


// 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 codevar allocation = await RelayService.Instance.JoinAllocationAsync(joinCode);var relayServerData = allocation.ToRelayServerData(connectionType);NetworkManager.Singleton.GetComponent<UnityTransport>().SetRelayServerData(relayServerData);

Refer to Use Relay with Netcode for GameObjects for more details on using Relay with Netcode for GameObjects with the Multiplayer Services SDK.

기술 자료

Development

User Acquisition

Monetization

산업 분야