> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab Multiplayer Unity プラグインの概要

> サポートされる Unity バージョンや統合に関する注意事項を含む、Lobby and Matchmaking C++ SDK をラップする PlayFab Multiplayer Unity プラグインの概要。

PlayFab Multiplayer Unity SDK プラグインは、Unity ゲーム開発者の利便性のために作成された、ネイティブの PlayFabMultiplayer C++ ライブラリ上の Unity C# ラッパーです。

これにより、Unity ゲームで PlayFab Multiplayer サービスを利用できます。現在、これには Lobby と Matchmaking が含まれます。複数のプラットフォームでゲームを開発するために設計されています。

PlayFab Multiplayer Unity プラグインは、PlayFab の「コア」Unity SDK と併用します。PlayFab の「コア」Unity SDK は、economy、leaderboards などの他の PlayFab 機能を提供します。詳細については、[PlayFab Unity SDK](https://github.com/PlayFab/UnitySDK) と [PlayFab Unity SDK ドキュメント](/services/playfab/sdks/unity3d) を参照してください。

PlayFab Multiplayer Unity プラグインは、Unity Asset パッケージとしてダウンロードできます。

## PlayFab Multiplayer Unity プラグインで提供される API 機能

* Lobby
* Matchmaking
* 次のプラットフォームのサポート:
  * GDK:
    * XBOX Series X|S
    * XBOX One
    * PC
  * Windows
* 上記プラットフォーム間のクロスプレイのサポート

## PlayFab Multiplayer Unity プラグインに含まれるもの

* Unity C# で書かれた `PlayFabMultiplayer` クラスによって提供されるトップ レベルの Multiplayer API と、ユーザーの Unity ゲームを PlayFabMultiplayer ライブラリと統合するためのプレハブ
* 基になるネイティブ (C++) の Multiplayer ライブラリ API へのマネージド コード インターフェイスを提供する C# 相互運用層。これはトップ レベルの C# API によって使用されます。
* サポートされる各プラットフォーム用の基になるネイティブ (C++) PlayFabMultiplayer バイナリ:
  * GDK 用の Multiplayer DLL ライブラリ
  * Windows 用の Multiplayer DLL ライブラリ
* PlayFab「コア」Unity SDK プラグイン (必要に応じて個別に更新できます)

## PlayFab Multiplayer Unity プラグインのバージョンとプラットフォーム間の互換性

PlayFab Multiplayer Unity プラグインは、プラットフォームに応じていくつかの配布ポイント (Git リポジトリ) で公開・ダウンロード可能になります。一部の配布ポイントへのアクセスは制限されています。Microsoft の担当者にリクエストを送信する必要があり、追加の手順が含まれる場合があります。

異なる配布ポイントからダウンロードされたバージョン間の互換性についてより良いガイダンスを提供し、基になるネイティブ ライブラリの特定バージョンへの参照を反映するため、PlayFab Multiplayer Unity プラグインはカスタム バージョニング スキームに従います。

### PlayFab Multiplayer Unity プラグインのバージョニング スキーム

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

たとえば、`1.2.0.3-gdk.0` (アクセス制限付き GDK リポジトリからダウンロードされたバージョン) や `1.2.0.3-ps5.0` (アクセス制限付き PS5™ リポジトリからダウンロードされた、PlayStation®5 のみの Multiplayer バイナリを持つバージョン) など。

バージョンのコンポーネント:

* `X.X.X` - サポートされるすべてのプラットフォームにわたる、基になる PlayFabMultiplayer ライブラリの最も低いバージョン。基になる C++ ライブラリのバージョンに対する一般的な参照の一貫性のために使用されます。上記の例では、各プラットフォームの含まれる PlayFabMultiplayer ライブラリのバージョンは `1.2.0` 以上です。
* `Y` - X.X.X 部分の特定のバージョンに対する、Multiplayer Unity C# 層でのあらゆる変更のインクリメンタルなインデックス。
* `(distribution-point-indicator)` - 特定の PlayFab Multiplayer Unity プラグイン パッケージがどの配布ポイントからダウンロードされたかを追跡するためのニーモニック コード。配布ポイントによって異なります。たとえば、`gdk` (GDK 開発者向けのアクセス制限付き Microsoft Azure DevOps リポジトリ)、`ps5` (PS5 開発者向けのアクセス制限付き Microsoft Azure DevOps リポジトリ) など。
* `Z` - 配布ポイントに固有の変更のインクリメンタルなインデックス (たとえば、特定のプラットフォームのみで更新/パッチが適用された Multiplayer バイナリ)。

バージョン コンポーネントの数値が大きいほど新しいバージョンで、左から右に重要度が下がります。

「PlayStation」は Sony Interactive Entertainment Inc. の登録商標または商標です。

「PS5」は Sony Interactive Entertainment Inc. の登録商標または商標です。

### 異なる配布ポイントのバージョン間の互換性

PlayFab Multiplayer Unity プラグインをどの配布ポイントからダウンロードしたかに関係なく、**バージョンの最初の 4 つの数値 (`X.X.X.Y`) が同じ** であれば、他の配布ポイントからダウンロードした PlayFab Multiplayer Unity プラグインと完全に互換性があることが保証されます。異なる配布ポイントの互換バージョンは、共有コードが同一であるはずなので、上書きや相互破損のリスクなしに、任意の順序でユーザーの Unity プロジェクトにインポートできます。ただし、それぞれに特定のプラットフォーム固有の追加 (共有されない) ファイルがある場合がありますが、これらは重複しないはずです。

たとえば、GDK、PS5、Switch を対象としている場合、Unity プロジェクトに以下のすべてのバージョンの PlayFab Multiplayer Unity プラグインを任意の順序でインポートできます:

* `1.2.0.3-gdk.0` (他のファイルとともに GDK 用の Multiplayer バイナリをインポート)
* `1.2.0.3-ps5.0` (他のファイルとともに PS5 用の Multiplayer バイナリをインポート)
* `1.2.0.3-sw.0` (他のファイルとともに Switch 用の Multiplayer バイナリをインポート)

これらのプラグインのそれぞれに含まれる共有 (クロスプラットフォーム) の Unity C# コードは同じになります。

## Unity のどのバージョンがサポートされていますか?

私たちは Unity 2017 以降の最近のすべての Unity バージョンをサポートするよう努めていますが、特定のプラットフォームごとの Unity 開発アドオンの利用可能性によって選択肢が制限される場合があります。対応する Unity ドキュメントを参照してください。それによって、プラットフォーム SDK の選択肢も制限される可能性があります。

一般に、当社は各プラットフォームで利用可能な最新の Unity 開発アドオンのいずれかで PlayFab Multiplayer Unity プラグインをテストしています。Unity Editor、Unity アドオン、またはプラットフォーム SDK の新しいバージョンでのビルドまたは実行時の問題があれば、報告することをお勧めします。


## Related topics

- [PlayFab Unreal GSDK プラグインの概要](/ja-jp/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Multiplayer Unity プラグイン クイックスタート](/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.md)
- [Party Unity plugin quickstart](/ja-jp/services/playfab/multiplayer/networking/party-unity-plugin-quickstart.md)
- [Integrate the PlayFab Unreal Engine Marketplace plugin](/ja-jp/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration.md)
- [Unity 用 PlayFab Multiplayer スタート ガイド](/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-sdk-getting-started.md)