Passer au contenu principal
Le plug-in SDK Unity PlayFab Multiplayer est un wrapper C# pour Unity reposant sur une bibliothèque C++ native PlayFabMultiplayer, créé pour faciliter le travail des développeurs de jeux Unity. Il vous permet d’utiliser les services PlayFab Multiplayer dans votre jeu Unity. Actuellement, cela inclut Lobby et Matchmaking. Il est conçu pour le développement de jeux sur plusieurs plateformes. Le plug-in Unity PlayFab Multiplayer fonctionne conjointement avec le SDK Unity PlayFab « principal ». Le SDK Unity PlayFab « principal » fournit d’autres fonctionnalités PlayFab, telles que l’économie, les classements, et plus encore. Pour plus d’informations, consultez PlayFab Unity SDK et la documentation du SDK Unity PlayFab. Le plug-in Unity PlayFab Multiplayer est disponible au téléchargement sous forme de package d’assets Unity.

​
Quelles fonctionnalités d’API le plug-in Unity PlayFab Multiplayer fournit-il ?

  • Lobby
  • Matchmaking
  • Prise en charge des plateformes suivantes :
    • GDK :
      • XBOX Series X|S
      • XBOX One
      • PC
    • Windows
  • Prise en charge du jeu multiplateforme entre les plateformes ci-dessus

​
Que contient le plug-in Unity PlayFab Multiplayer ?

  • L’API Multiplayer de haut niveau écrite en C# pour Unity, fournie par la classe PlayFabMultiplayer, et un prefab permettant d’intégrer le jeu Unity de l’utilisateur à la bibliothèque PlayFabMultiplayer
  • Une couche d’interopérabilité C# fournissant une interface en code managé à l’API de la bibliothèque Multiplayer native (C++) sous-jacente. Elle est utilisée par l’API C# de haut niveau.
  • Les binaires natifs (C++) PlayFabMultiplayer sous-jacents pour chaque plateforme prise en charge :
    • Bibliothèques DLL Multiplayer pour GDK
    • Bibliothèques DLL Multiplayer pour Windows
  • Le plug-in SDK Unity PlayFab « principal » (peut être mis à jour indépendamment si nécessaire)

​
Versions du plug-in Unity PlayFab Multiplayer et compatibilité entre les plateformes

Le plug-in Unity PlayFab Multiplayer est publié et disponible au téléchargement à plusieurs points de distribution (dépôts Git), selon la plateforme. L’accès à certains points de distribution est restreint. Vous devez envoyer une demande à votre représentant Microsoft, ce qui peut impliquer des étapes supplémentaires. Afin de mieux vous guider sur la compatibilité entre les versions téléchargées depuis différents points de distribution, et de refléter la référence à une version spécifique de la bibliothèque native sous-jacente, le plug-in Unity PlayFab Multiplayer suit un schéma de versionnage personnalisé.

​
Schéma de versionnage du plug-in Unity PlayFab Multiplayer

Par exemple, 1.2.0.3-gdk.0 (une version téléchargée depuis le dépôt GDK à accès restreint) ou 1.2.0.3-ps5.0 (une version contenant des binaires Multiplayer uniquement pour PlayStation®5, téléchargée depuis le dépôt PS5™ à accès restreint). Composantes de la version :
  • X.X.X : la version la plus basse de la bibliothèque PlayFabMultiplayer sous-jacente parmi toutes les plateformes prises en charge. Elle sert de référence générale de cohérence avec une version de la bibliothèque C++ sous-jacente. Dans l’exemple ci-dessus, la version de la bibliothèque PlayFabMultiplayer incluse pour chaque plateforme est 1.2.0 ou ultérieure.
  • Y : un index incrémentiel de toutes les modifications de la couche C# Multiplayer pour Unity, pour une partie X.X.X donnée de la version.
  • (distribution-point-indicator) : un code mnémotechnique permettant de savoir depuis quel point de distribution un package de plug-in Unity PlayFab Multiplayer a été téléchargé. Il diffère selon le point de distribution, par exemple gdk (dépôt Microsoft Azure DevOps à accès restreint pour les développeurs GDK), ps5 (dépôt Microsoft Azure DevOps à accès restreint pour les développeurs PS5), etc.
  • Z : un index incrémentiel des modifications propres au point de distribution (par exemple, des binaires Multiplayer mis à jour ou corrigés pour une plateforme spécifique uniquement).
Un nombre plus élevé dans n’importe quelle composante de la version indique une version plus récente, par ordre d’importance de gauche à droite. « PlayStation » est une marque déposée ou une marque commerciale de Sony Interactive Entertainment Inc. « PS5 » est une marque déposée ou une marque commerciale de Sony Interactive Entertainment Inc.

​
Compatibilité entre les versions issues de différents points de distribution

Quel que soit le point de distribution depuis lequel un plug-in Unity PlayFab Multiplayer est téléchargé, il est garanti d’être entièrement compatible avec un plug-in Unity PlayFab Multiplayer téléchargé depuis n’importe quel autre point de distribution, si les quatre premiers nombres (X.X.X.Y) de leur version sont identiques. Les versions compatibles issues de différents points de distribution peuvent être importées dans le projet Unity de l’utilisateur dans n’importe quel ordre, sans risque de s’écraser ou de se casser mutuellement, car leur code partagé doit être identique. Chacune d’elles peut toutefois comporter des fichiers supplémentaires (non partagés), propres à une plateforme particulière, qui ne doivent pas se chevaucher. Par exemple, si vous ciblez GDK, PS5 et Switch, vous pouvez importer toutes les versions suivantes du plug-in Unity PlayFab Multiplayer dans votre projet Unity, dans n’importe quel ordre :
  • 1.2.0.3-gdk.0 (importe notamment les binaires Multiplayer pour GDK)
  • 1.2.0.3-ps5.0 (importe notamment les binaires Multiplayer pour PS5)
  • 1.2.0.3-sw.0 (importe notamment les binaires Multiplayer pour Switch)
Le code C# Unity partagé (multiplateforme) inclus dans chacun de ces plug-ins sera identique.

​
Quelles versions d’Unity sont prises en charge ?

Nous nous efforçons de prendre en charge toutes les versions récentes d’Unity à partir d’Unity 2017 ; votre choix peut toutefois être limité par la disponibilité d’un module complémentaire de développement Unity pour chaque plateforme (consultez la documentation Unity correspondante). Cela peut également limiter votre choix de SDK de plateforme. En général, nous testons le plug-in Unity PlayFab Multiplayer avec l’une des versions les plus récentes des modules complémentaires de développement Unity disponibles pour chaque plateforme. Nous vous encourageons à signaler tout problème de build ou d’exécution rencontré avec une nouvelle version de l’éditeur Unity, d’un module complémentaire Unity ou d’un SDK de plateforme.
Dernière modification le 8 octobre 2026