PlayFab マルチプレイヤー Unity プラグインの概要

[アーティクル]
07/14/2023

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

これにより、Unity ゲームで PlayFab マルチプレイヤーサービスを利用できます。現時点では、これにはロビーとマッチメイキングが含まれます。これは、複数のプラットフォームでゲームを開発するために設計されています。

PlayFab マルチプレイヤー Unity プラグインは、PlayFab "コア" Unity SDK と共に動作します。 PlayFab の "コア" Unity SDK は、エコノミー、ランキングなどの他の PlayFab 機能を提供します。詳細については、PlayFab Unity SDK および PlayFab Unity SDK のドキュメントを参照してください。

PlayFab マルチプレイヤー Unity プラグインは、Unity アセットパッケージとしてダウンロードできます。

PlayFab マルチプレイヤー Unity プラグインによって提供される API 機能は何ですか?

ロビー
マッチメイキング
次のプラットフォームのサポート:
- GDK:
  - Xbox Series X|S
  - Xbox One
  - PC
- Windows
上記のプラットフォーム間でのクロスプレイのサポート

PlayFab マルチプレイヤー Unity プラグインには何が含まれていますか?

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

PlayFab マルチプレイヤー Unity プラグインのバージョンとプラットフォーム間の互換性

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

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

PlayFab マルチプレイヤー 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 専用のマルチプレイヤーバイナリを含むバージョン)。

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

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

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

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

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

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

PlayFab マルチプレイヤー Unity プラグインのダウンロード元の配布ポイントに関係なく、そのバージョンの 最初の 4 つの数値 (X.X.X.Y) が同じ である場合、他の配布ポイントからダウンロードされた PlayFab マルチプレイヤー Unity プラグインと完全に互換性が保証されます。異なる配布ポイントの互換性のあるバージョンは、共有コードが同一である必要があるため、相互に上書きまたは中断するリスクなしに、任意の順序でユーザーの Unity プロジェクトにインポートできます。ただし、各ファイルには、特定のプラットフォームに固有の追加の (共有されていない) ファイルが含まれる場合がありますが、これらは重複してはなりません。

たとえば、GDK、PS5、Switch をターゲットにしている場合は、Unity プロジェクトに次のすべてのバージョンの PlayFab マルチプレイヤー Unity プラグインを任意の順序でインポートできます:

1.2.0.3-gdk.0 (GDK のマルチプレイヤーバイナリを他のファイルにインポートします)
1.2.0.3-ps5.0 (PS5 のマルチプレイヤーバイナリを他のファイルにインポートします)
1.2.0.3-sw.0 (Switch のマルチプレイヤーバイナリを他のファイルにインポートします)

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

どのバージョンの Unity がサポート対象ですか?

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

一般に、PlayFab マルチプレイヤー Unity プラグインは、各プラットフォームで使用できる最新バージョンの Unity 開発アドオンのいずれかを使用してテストします。新しいバージョンの Unity エディター、Unity アドオン、プラットフォーム SDK に関するビルドまたはランタイムの問題を報告することをお勧めします。

次の方法で共有