Freigeben über

Übersicht über das Party Unity-Plug-In

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

Es ermöglicht Ihnen, Party- und Party Cognitive Services in Ihrem Unity-Spiel zu verwenden. Dies umfasst Multiplayer-Netzwerke, Chatnachrichten und Datenaustausch, Crosstalk, Crossplay, Barrierefreiheitsfeatures wie Die Übersetzung von Textchats in Echtzeit und Sprachtranskription. Es ist für die Entwicklung von Spielen auf mehreren Plattformen konzipiert.

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

Das Party Unity-Plug-In steht als Unity-Ressourcenpaket zum Download zur Verfügung. Es wird derzeit für die Entwicklung von Spielen auf den folgenden Plattformen unterstützt:

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

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

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

*- Die zugrunde liegenden Parteibibliotheken für GDK sind nicht im Plug-In enthalten (siehe unten).

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

Welche API-Features werden vom Party Unity-Plug-In bereitgestellt?

  • Spielenetzwerke
  • VoIP
  • Unterstützung für die folgenden Plattformen:
    • GDK:
      • Xbox Series X|S
      • Xbox One
      • PC
    • Windows
    • iOS
    • Android
    • PS4™
    • PS5™
    • Wechseln
  • Unterstützung für Crossplay-& Cross-Talk über die oben genannten Plattformen hinweg
  • Party Cognitive Services
    • Textchatübersetzung in Echtzeit
    • Echtzeit-Sprachchattranskription
    • Sprachchatübersetzung in Echtzeit
    • Sprachsynthese

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

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

Was ist im Party Unity-Plug-In enthalten?

  • Vereinfachte, in Unity C# geschriebene Party-API auf oberster Ebene, die von Klasse und Prefab bereitgestellt wird PlayFabMultiplayerManager , um die Integration des Unity-Spiels des Benutzers mit den Kernfunktionen der Partybibliothek zu vereinfachen
  • C#-Interopebene, die eine Schnittstelle mit verwaltetem Code für die zugrunde liegende native (C++)-Partybibliotheks-API bereitstellt. Sie wird von der C#-API der obersten Ebene verwendet.
  • Zugrunde liegende systemeigene Binärdateien (C++) für jede unterstützte Plattform:
    • Party-DLL-Bibliotheken für Windows
    • Party iOS Framework-Bibliotheken für iOS (Gerät und Simulator)
    • Party-AAR-Bibliotheksarchiv für Android
    • Party-DLL-Bibliotheken für Microsoft Game Core sind NICHT enthalten. Sie werden mit GDK verteilt und müssen vor dem Erstellen des Unity-Projekts des Benutzers in das Plug-In kopiert werden (siehe Details in der README-Datei, die im Plug-In enthalten ist).
    • Dynamische Partybibliotheken für PS4, PS5
    • Statische Partybibliotheken für Switch
  • PlayFab"Core" Unity SDK-Plug-In (kann bei Bedarf unabhängig aktualisiert werden)
  • Xbox Live-Authentifizierungs- und Richtlinienanbieter-API, derzeit nur auf der GDK-Plattform unterstützt

Party Unity-Plug-In-Versionen und Kompatibilität zwischen Plattformen

Das Party 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 und erfordert eine Anfrage an Ihren Microsoft-Vertreter.

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 Party Unity-Plug-In einem benutzerdefinierten Versionsverwaltungsschema.

Party Unity-Plug-In-Versionsverwaltungsschema

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

Beispiel: (eine Version, 1.5.0.3-main.0 die aus dem Standard öffentlichen GitHub-Repository heruntergeladen wurde) oder 1.5.0.3-ps5.0 (eine Version mit Parteibinärdateien nur für PS5, heruntergeladen aus einem Repository mit eingeschränktem Zugriff).

Versionskomponenten:

  • X.X.X – die niedrigste Version der zugrunde liegenden Parteibibliothek 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.5.0 die Version einer enthaltenen Parteibibliothek für jede Plattform oder höher.
  • Y – ein inkrementeller Index aller Änderungen auf der Party 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 Party Unity-Plug-In-Paket heruntergeladen wurde. Sie unterscheidet sich je nach Verteilungspunkt, z. B. main (Standard GitHub-Repository für die öffentliche Verteilung), 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. parteiinterne 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.

Kompatibilität zwischen Versionen von verschiedenen Verteilungspunkten

Unabhängig von einem Verteilungspunkt, von dem ein Party Unity-Plug-In heruntergeladen wird, ist es garantiert vollständig kompatibel mit einem Party Unity-Plug-In, das von einem anderen Verteilungspunkt heruntergeladen wird, wenn die ersten vier Nummern (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 Party Unity-Plug-Ins in beliebiger sequenzieller Reihenfolge in Ihr Unity-Projekt importieren, wenn Sie iOS, PS5 und Switch als Ziel verwenden:

  • 1.5.0.3-main.0 (importiert unter anderem Parteibinärdateien für iOS)
  • 1.5.0.3-ps5.0 (importiert Unter anderem Parteibinärdateien für PS5)
  • 1.5.0.3-sw.0 (importiert Unter anderem Partybinä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 bemühen uns, alle aktuellen Versionen von Unity ab Unity 2017 zu unterstützen. Ihre Wahl kann jedoch 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 Party Unity-Plug-In mit einer der neuesten Versionen von Unity-Entwicklungs-Add-Ons, die für jede Plattform verfügbar sind. Wir empfehlen unseren Kunden, Build- oder Laufzeitprobleme mit jeder neuen Version von Unity Editor, Unity-Add-On oder einem Plattform-SDK zu melden.

Preisgestaltung

VoIP- und Game Networking-Funktionen sind für Benutzer kostenlos, die mit einem Xbox Live-Konto angemeldet sind (derzeit nur auf der GDK-Plattform unterstützt).

Party Cognitive Services und andere Dienste können mit Kosten verbunden sein. Weitere Informationen finden Sie unter Abrechnung für PlayFab-Party , oder wenden Sie sich an Ihren Microsoft-Vertreter.