1 - Getting Starter

概要

Getting Startedでは、Fusionプロジェクトを開始するために必要な初期ステップを説明します。UnityとC#の一般的な理解が必要です。

Fusionは複数のネットワークトポロジーに対応しています。 -Server Mode（サーバーモード）：パブリックIPを持つ専用サーバー。

Host Mode（ホストモード）：一人のプレイヤーがホストとなり、他のプレイヤーはそのプレイヤーに接続します。 -Shared Mode（共有モード）：クラウドルームはStateAuthorityを持つ。

トポロジーの詳細はこちら

どのモードを選択するかは、早めに決断する必要のある重要なことです。選択したモードによって、Fusionの使い方やマルチプレイヤーコードの書き方が根本的に変わってきます。

どのモードを使うかは、Quadrantから始めて、あなたのゲームのジャンルに最もマッチする解を選ぶことをお勧めします。

このチュートリアルは、Shared Mode用です。サーバーモードとホストモードについては、Fusion 100 チュートリアルを参照してください。

ステップ 0 - アカウントを作成する

まず、PhotonEngineのアカウントをこちらから作成します。

ステップ1 - SDKのダウンロード

最新のSDKは、Getting Started > SDK & Release Notesのページからダウンロードできます。このページに移動するにはここをクリックしてください

ステップ2 - Unityの要件を確認する

お使いのUnityのバージョンが、Fusionを動作させるための最小要件を満たしていることを確認してください。最新の要件は、Getting Started > SDK & Release Notes の Requirements セクションに記載されています。こちらをクリックしてください。

原時点では、Unity 2020.3.x LTS 以上が最低要件となっています。バージョンが古い場合は、Unity Hubから最新の安定版Unityをインストールしてください。

install a compatible unity editor — 互換性のあるUnity Editorをインストールする。

Step 3 - 空のプロジェクトを作成する

空のプロジェクトを作成します。

Fusion はネットワーキングライブラリであるため、選択したレンダリングパイプラインに依存せず、すべてのレンダリングパイプラインで機能します。

Step 4 - プロジェクトをFusion用に準備する

Fusion SDKをインポートする前に、デフォルトのUnityプロジェクトの設定にいくつかの微調整が必要です。

アセットのシリアル化

Fusionの設定の一部は、ScriptableObjectアセットに保存されます。これらの設定を常に読みやすくするためには、アセットシリアライズのモードをEdit > Project Settings > Editor > Asset Serialization > ModeのForce Textに設定する必要があります。

asset serialization mode — Asset Serialization ModeをForce Textに設定

Mono Cecil

Fusion IL Weaverは、低レベルのネットコードベースを生成し、Assembly-CSharp.dllに注入します。そのために、Mono Cecilパッケージが使用されています。このパッケージは、Unityパッケージ・マネージャーからインストールすることができます。

Window > Package Manager > Click the + icon > Add package from git URLに移動し、com.unity.nuget.mono-cecil@1.10.2を追加します。

add the mono cecil package via the package manager — パッケージマネージャでMono Cecil Packageを追加。

Step 5 - Fusion SDKをインポートする

ステップ1～5が完了すると、プロジェクトはFusion SDKをインポートする準備が整いました。SDKは.unitypackageファイルとして提供され、Assets > Import Package > Custom Packageツールでインポートすることができます。SDKがダウンロードされた場所に移動し、インポートを開始します。