Freigeben über


Übersicht über das PlayFab Multiplayer Unity-Plug-In

Das PlayFab Multiplayer Unity SDK-Plug-In ist ein Unity C#-Wrapper auf einer nativen PlayFabMultiplayer-C++-Bibliothek, die für Unity-Spieleentwickler erstellt wurde.

Es ermöglicht Ihnen, PlayFab Multiplayer-Dienste in Ihrem Unity-Spiel zu nutzen. Derzeit umfasst dies Lobby und Matchmaking. Es ist für die Entwicklung von Spielen auf mehreren Plattformen konzipiert.

Das PlayFab Multiplayer Unity-Plug-In funktioniert zusammen mit dem PlayFab-Unity-SDK "Core". Das PlayFab Core Unity SDK bietet andere PlayFab-Funktionen wie Wirtschaft, Bestenlisten und vieles mehr. Weitere Informationen finden Sie unter PlayFab Unity SDK und PlayFab Unity SDK-Dokumentation.

Das PlayFab Multiplayer Unity-Plug-In steht als Unity Asset-Paket zum Download zur Verfügung.

Welche API-Features werden vom PlayFab Multiplayer Unity-Plug-In bereitgestellt?

  • Lobby
  • Spielersuche
  • Unterstützung für die folgenden Plattformen:
    • GDK:
      • Xbox Series X|S
      • Xbox One
      • PC
    • Windows
  • Unterstützung für Crossplay auf den oben genannten Plattformen

Was ist im PlayFab Multiplayer Unity-Plug-In enthalten?

  • Die in Unity C# geschriebene Multiplayer-API der obersten Ebene, die von der Klasse bereitgestellt wird PlayFabMultiplayer , und ein Prefab für die Integration des Unity-Spiels des Benutzers in die PlayFabMultiplayer-Bibliothek
  • C#-Interopebene, die eine Schnittstelle mit verwaltetem Code für die zugrunde liegende native (C++)-Multiplayerbibliotheks-API bereitstellt. Sie wird von der C#-API der obersten Ebene verwendet.
  • Zugrunde liegende native (C++) PlayFabMultiplayer-Binärdateien für jede unterstützte Plattform:
    • Multiplayer-DLL-Bibliotheken für GDK
    • Multiplayer-DLL-Bibliotheken für Windows
  • PlayFab"Core" Unity SDK-Plug-In (kann bei Bedarf unabhängig aktualisiert werden)

PlayFab Multiplayer Unity-Plug-In-Versionen und Kompatibilität zwischen Plattformen

Das PlayFab Multiplayer Unity-Plug-In wird veröffentlicht und kann je nach Plattform an mehreren Verteilungspunkten (Git-Repositorys) heruntergeladen werden. Der Zugriff auf einige Verteilungspunkte ist eingeschränkt. Sie müssen eine Anfrage an Ihren Microsoft-Vertreter senden und können zusätzliche Schritte enthalten.

Um eine bessere Anleitung zur Kompatibilität zwischen Versionen bereitzustellen, die von verschiedenen Verteilungspunkten heruntergeladen wurden, und einen Verweis auf eine bestimmte Version der zugrunde liegenden nativen Bibliothek widerspiegeln, folgt das PlayFab Multiplayer Unity-Plug-In einem benutzerdefinierten Versionsverwaltungsschema.

PlayFab Multiplayer Unity-Plug-In-Versionsverwaltungsschema

X.X.X.Y-(distribution-point-indicator).Z

Beispiel: (eine Version, 1.2.0.3-gdk.0 die aus dem GDK-Repository mit eingeschränktem Zugriff heruntergeladen wurde) oder 1.2.0.3-ps5.0 (eine Version mit Multiplayer-Binärdateien nur für PlayStation®5, heruntergeladen aus dem PS5-Repository™ mit eingeschränktem Zugriff).

Versionskomponenten:

  • X.X.X – die niedrigste Version der zugrunde liegenden PlayFabMultiplayer-Bibliothek auf allen unterstützten Plattformen. Dies wird für die allgemeine Verweiskonsistenz mit einer Version der zugrunde liegenden C++-Bibliothek verwendet. Im obigen Beispiel ist 1.2.0 die Version einer enthaltenen PlayFabMultiplayer-Bibliothek für jede Plattform oder höher.
  • Y : Ein inkrementeller Index aller Änderungen in der Multiplayer-Unity-C#-Ebene für jeden bestimmten X.X.X-Teil der Version.
  • (distribution-point-indicator) – ein mnemonischer Code zum Nachverfolgen des Verteilungspunkts, von dem ein bestimmtes PlayFab Multiplayer Unity-Plug-In-Paket heruntergeladen wurde. Sie unterscheidet sich je nach Verteilungspunkt, gdk z. B. (Microsoft Azure DevOps-Repository mit eingeschränktem Zugriff für GDK-Entwickler), ps5 (Microsoft Azure DevOps-Repository mit eingeschränktem Zugriff für PS5-Entwickler) usw.
  • Z – ein inkrementeller Index aller Änderungen, die für den Verteilungspunkt eindeutig sind (z. B. Multiplayer-Binärdateien, die nur für eine bestimmte Plattform aktualisiert/gepatcht wurden).

Eine höhere Zahl in jeder Versionskomponente bedeutet eine neuere Version, je nach Bedeutung von links nach rechts.

"PlayStation" ist eine eingetragene Marke oder Marke von Sony Interactive Entertainment Inc.

"PS5" ist eine eingetragene Marke oder Marke von Sony Interactive Entertainment Inc.

Kompatibilität zwischen Versionen von verschiedenen Verteilungspunkten

Unabhängig von einem Verteilungspunkt, von dem ein PlayFab Multiplayer Unity-Plug-In heruntergeladen wird, ist es garantiert vollständig kompatibel mit einem PlayFab Multiplayer Unity-Plug-In, das von einem anderen Verteilungspunkt heruntergeladen wurde, wenn die ersten vier Zahlen (X.X.X.Y) ihrer Version identisch sind. Kompatible Versionen von verschiedenen Verteilungspunkten können in beliebiger Reihenfolge in das Unity-Projekt des Benutzers importiert werden, ohne dass das Risiko besteht, dass sie sich gegenseitig überschreiben/unterbrechen, da der freigegebene Code identisch sein sollte. Obwohl jede von ihnen möglicherweise einige zusätzliche (nicht freigegebene) Dateien enthält, die für eine bestimmte Plattform spezifisch sind, die sich nicht überschneiden sollten.

Sie können beispielsweise alle folgenden Versionen des PlayFab Multiplayer Unity-Plug-Ins in beliebiger sequenzieller Reihenfolge in Ihrem Unity-Projekt importieren, wenn Sie GDK, PS5 und Switch als Ziel verwenden:

  • 1.2.0.3-gdk.0 (importiert Unter anderem Multiplayer-Binärdateien für GDK)
  • 1.2.0.3-ps5.0 (importiert Unter anderem Multiplayer-Binärdateien für PS5)
  • 1.2.0.3-sw.0 (importiert Unter anderem Multiplayer-Binärdateien für Switch)

Der freigegebene (plattformübergreifende) Unity C#-Code, der in jedem dieser Plug-Ins enthalten ist, ist identisch.

Welche Versionen von Unity werden unterstützt?

Wir sind bestrebt, alle aktuellen Versionen von Unity ab Unity 2017 zu unterstützen, aber Ihre Wahl kann durch die Verfügbarkeit eines Unity-Entwicklungs-Add-Ons für jede bestimmte Plattform eingeschränkt sein. Weitere Informationen finden Sie in der entsprechenden Unity-Dokumentation. Dies wiederum kann auch Ihre Wahl des Plattform-SDK einschränken.

Im Allgemeinen testen wir das PlayFab Multiplayer Unity-Plug-In mit einer der neuesten Versionen von Unity-Entwicklungs-Add-Ons, die für jede Plattform verfügbar sind. Wir empfehlen Ihnen, alle Build- oder Laufzeitprobleme mit jeder neuen Version von Unity Editor, Unity-Add-On oder einem Plattform-SDK zu melden.