server | v5 switch to V4  

詳細なガイド

目次

ガイドイントロ

このガイドの目的は、初めてPhoton Serverプラグインを作成、設定および使用する際の手順の説明です。

このガイドはPhoton Serverプラグインを初めて使用するユーザーが対象で、注意深く順番どおりに手順をおこなう必要があります。

なお、このガイドはこちらのマニュアルに代わるものではありません。

トップに戻る
 

初めてのプラグイン

最初のパートでは、最小限のプラグインを作成および展開します。

  1. Photonアカウントを作成します。

  2. Photon Plugin SDKをダウンロードします。

  3. SDKを展開します。このガイドでは、展開後に表示されるフォルダパスは"{pluginsSdkFolder}"と記載します。

  4. Visual Studioプロジェクトを新規作成します（このガイドでは、Visual Studio 2019 Community版を使用しています）：

    • 「Class Library (.NET Framework)」という種類の新しいプロジェクトを追加します。
    • プロジェクト名：「MyFirstPlugin」
    • 場所：「{pluginsSdkFolder}\src-server\Plugins」
    • 確認：「ソリューションとプロジェクトを同じディレクトリ内に格納してください」
    • フレームワーク：「.NET Framework 4」
    New Project Creation Window in Visual Studio 2019
    Visual Studio 2019でのプロジェクト作成ウィンドウ

  5. 依存関係を追加します： 1つのライブラリのみが必要です：「PhotonHivePlugin.dll」。 Visual Studioから追加する方法は以下のとおりです:

    • プロジェクトから「References」を右クリックします
    • 「Add Reference..」をクリックします
    • 「Browse」を選択します
    • 「Browse」をクリックして、「{pluginsSdkFolder}\src-server\Plugins\lib\PhotonHivePlugin.dll」を選択します。
    • 確認したら「OK」をクリックします。

  6. プラグインクラスを追加します：

- Visual Studioで自動的に作成されたクラスファイルの名前を「Class.cs」から「MyFirstPlugin.cs」へ変更します。

- Visual Studioからクラスの名前の変更が提案されるので、承認してください。提案されない場合には、クラスの名前をClassからMyFirstPluginへ変更します。

- PluginBaseを拡張します。

<pre><code class="language-csharp">    using Photon.Hive.Plugin;

    namespace MyFirstPlugin
    {
        public class MyFirstPlugin : PluginBase
        {
        }
    }</code></pre>
  1. プラグイン名を設定します：
public override string Name => "MyFirstPlugin";
- 予約されたプラグイン名は「Default」と「ErrorPlugin」です。

  1. コールバック内にログメッセージを追加します：

        public override void OnCreateGame(ICreateGameCallInfo info)
 {
     this.PluginHost.LogInfo(string.Format("OnCreateGame {0} by user {1}", info.Request.GameId, info.UserId));
 }

  2. コールバック処理メソッドを1つ呼び出します：

        public override void OnCreateGame(ICreateGameCallInfo info)
 {
     this.PluginHost.LogInfo(string.Format("OnCreateGame {0} by user {1}", info.Request.GameId, info.UserId));
     info.Continue(); // same as base.OnCreateGame(info);
 }

  3. プラグインファクトリクラスを追加します：

    • MyPluginFactoryという名前の新しいクラスを追加します。
    • そのクラスをパブリックにします。
        using Photon.Hive.Plugin;

namespace MyFirstPlugin
{
    public class MyPluginFactory
    {
    }
}

  4. クラス PluginFactoryBaseを拡張します:

      　using Photon.Hive.Plugin;

namespace MyFirstPlugin
{
    public class MyPluginFactory : PluginFactoryBase
    {
        public override IGamePlugin Create(string pluginName)
        {
            throw new NotImplementedException();
        }
    }
}

  5. プラグインを作成し、返します：

public override IGamePlugin Create(string pluginName)
{
    return new MyFirstPlugin();
}

  1. ソリューションをビルドします（F6）。

  2. プラグインの設定をアップデートします：

    • 「{pluginsSdkFolder}\deploy\LoadBalancing\GameServer\bin\plugin.config」を開きます
    • 「PluginSettings」ノードを以下のようにアップデートします：
        <PluginSettings Enabled="true">
    <Plugins>
        <Plugin
            Name="MyFirstPlugin"
            AssemblyName="MyFirstPlugin.dll"
            Type="MyFirstPlugin.MyPluginFactory" />
    </Plugins>
</PluginSettings>

    セルフホスティングされたPhoton Serverのプラグイン設定については、こちらを参照してください。

  3. 予期されるパスにバイナリをコピーします：

    「{pluginsSdkFolder}\src-server\Plugins\MyFirstPlugin\bin\Debug\」から「{pluginsSdkFolder}\deploy\Plugins\MyFirstPlugin\bin\」へすべてをコピーします。

  4. [PhotonControl]を開きます。 「{pluginsSdkFolder}\bin_Win64\PhotonControl.exe」で検索できます。 ライセンスがない場合には、まずライセンスを取得してここにコピーしてください。

  5. アプリケーションとしてPhoton Serverを起動します：

    Start LoadBalancing from PhotonControl
    PhotonControlからLoadBalancingを起動

  6. ログを確認します：

    PhotonControlから直接ログを開くことができます：

    Open Logs from PhotonControl
    PhotonControlからログを開きます

    「{pluginsSdkFolder}\deploy\log\GSGame.log」で、プラグインの設定が解析され、正常に処理されたことを確認します：

        2019-07-04 15:18:40,272 [1] INFO  Photon.Hive.Plugin.PluginManager - Plugin configured: name=MyFirstPlugin
2019-07-04 15:18:40,326 [1] INFO  Photon.Hive.Plugin.PluginManager - Loaded Assembly Name=MyFirstPlugin, Version=1.0.0.0, Culture=, PublicKey token=, Path=D:\ExitGames\SDKs\Plugins\Photon-OnPremise-Server-Plugin-SDK_v4-0-29-11263\deploy\Plugins\MyFirstPlugin\\bin\MyFirstPlugin.dll
2019-07-04 15:18:40,327 [1] INFO  Photon.Hive.Plugin.PluginManager - Referenced Assembly Name=mscorlib, Version=4.0.0.0, Culture=, PublicKey token=B7-7A-5C-56-19-34-E0-89, Path=
2019-07-04 15:18:40,329 [1] INFO  Photon.Hive.Plugin.PluginManager - Referenced Assembly Name=PhotonHivePlugin, Version=1.0.15.11060, Culture=, PublicKey token=, Path=
2019-07-04 15:18:40,330 [1] INFO  Photon.Hive.Plugin.PluginManager - Plugin Type MyFirstPlugin.MyPluginFactory from assembly MyFirstPlugin, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null was successfuly created
2019-07-04 15:18:40,331 [1] INFO  Photon.Hive.Plugin.PluginManager - Plugin manager (version=1.0.15.11060) is setup. type=MyFirstPlugin.MyPluginFactory;path=D:\ExitGames\SDKs\Plugins\Photon-OnPremise-Server-Plugin-SDK_v4-0-29-11263\deploy\Plugins\MyFirstPlugin\\bin\MyFirstPlugin.dll;version=1.0.15.11060

  7. Photon Serverに接続します。任意のクライアントSDKを使用してください。

  8. ルームを作成します。CreateRoom操作を実装するSDKに適したメソッドを呼び出します。

  9. ログを再確認します： 「"{pluginsSdkFolder}\deploy\log\GSGame.log"」にプラグインの作成が表示され、プラグインコールバックからのカスタムのログメッセージも表示されます：

        2019-07-04 15:25:40,540 [11] INFO  Photon.Hive.Plugin.PluginManager - Plugin successfully created:Type:MyFirstPlugin.MyPluginFactory, path:D:\ExitGames\SDKs\Plugins\Photon-OnPremise-Server-Plugin-SDK_v4-0-29-11263\deploy\Plugins\MyFirstPlugin\\bin\MyFirstPlugin.dll
2019-07-04 15:25:42,435 [11] INFO  Photon.Hive.HiveGame.HiveHostGame.Plugin - OnCreateGame 870c3120-bcdd-4091-b072-8e92ea07bec5 by user 495fca21-b67e-4103-b1ce-c6ce945e6207

トップに戻る
 

デバッグモード

以下のパートでは、プラグイン開発に推奨されるワークフローを示します。

  1. プラグインプロジェクトの「Post-Build Events」をアップデートします：

    ここではプロジェクトビルドの出力ディレクトリから、Photonのコンフィグレーションによって予期されるパスへコピーアンドペーストすることでプラグインバイナリを自動的にアップデートする、という考えが前提になっています。

    スクリーンショットに表示されたように、「Post-Build Events」テキストエリアにこのコマンドを入力してください。これによって、ビルドが正常に完了した直後にこの処理がおこなわ れます。 ここでは、利便性と移植性のため相対パスを使用しています。

        xcopy /Y /Q "$(TargetDir)*.*" "$(SolutionDir)..\..\..\deploy\Plugins\MyFirstPlugin\bin\"
    Post Build Events
    Post Build Events

    忘れずに保存してください。

  2. プラグインプロジェクトの「デバッグ」アクションをアップデートします：

ここでは、デバッグプラグインの起動と同時にPhoton Serverを自動的に起動し、またデバッ　グプラグインの停止と同時にPhoton Serverを自動的に停止する、という考えが前提になって　います。

スクリーンショットのように「Start action」と「Start options」を設定してください。 ここでは、利便性と移植性のため相対パスを使用しています。

  • 「外部プログラムの開始」:

            ..\..\..\deploy\bin_Win64\PhotonSocketServer.exe

  • 「コマンドライン引数」:

            /run LoadBalancing /configPath ..\..\..\..\..\deploy\bin_Win64
<figure>
    <img alt="Debug Start Action" class="no-border" src="data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs=" data-src="/docs/img/PluginsStepByStepGuide/DebugActions.png">
    <figcaption>
        Debug Start Action
    </figcaption>
</figure>

忘れずに保存してください。

  1. ブレークポイントを追加します：

    Breakpoint in MyFirstPlugin.OnCreateGame
    MyFirstPlugin.OnCreateGame内のブレークポイント

  2. [PhotonControl]からPhoton Serverを停止します:

    Stop LoadBalancing from PhotonControl
    PhotonControlからLoadBalancingを停止　

  3. Visual StudioからPhoton Serverを起動します(F5):

Breakpoint in MyFirstPlugin.OnCreateGame
Breakpoint in MyFirstPlugin.OnCreateGame 
サーバーが起動したかは、TaskManagerを使用して確認できます。プロセス名はPhotonです。
  1. Photon Serverに接続します。任意のSDKを使用してください。
  2. ルームを作成します。CreateRoom操作を実装するSDKに適したメソッドを呼び出してください。
  3. ブレークポイントがトリガーされるのを待ちます：
Breakpoint Triggered
Breakpoint Triggered

photoncontrol

ドキュメントのトップへ戻る