NetworkBehaviour

NetworkBehaviour は NetworkIdentity コンポーネントを持つオブジェクトとともに機能する、特殊なスクリプトです。このスクリプトでは、Commands、ClientRPCs、SyncEvents それに SyncVars などの HLAPI 機能を実行することができます。

Unity のネットワークシステムの1つであるサーバー権限を持つシステムでは、NetworkServer.Spawn() を使用してサーバー側で NetworkIdentity コンポーネントを持つネットワークオブジェクトを生成しなければいけません。NetworkInstanceId が割り当てられている場合、サーバーに接続されているすべてのクライアント上でネットワークオブジェクトが生成されます。

プロパティー

プロパティー:		説明:
isLocalPlayer		ローカルのクライアントで使用（操作）されるプレイヤーオブジェクトである場合は true を返します。
isServer		オブジェクトがサーバー上で実行されていて、かつ、サーバー上で生成された場合は true を返します。
isClient		クライアント上で実行されるオブジェクトの場合は true を返します。
hasAuthority		オブジェクトがオリジナルの（権限を持つ）オブジェクトである場合、true を返します。これはサーバー側とクライアント側両方で使用します。ただし、クライアント側は localPlayerAuthority を使うことをおすすめします。
assetId		オブジェクトの NetworkIdentity のアセット ID です。
netId		オブジェクトの NetworkIdentity のネットワーク ID です。
playerControllerId		オブジェクトの NetworkIdentity の プレイヤーコントローラーID です。
connectionToServer		NetworkConnection オブジェクトをサーバーに送信するために使用します。
connectionToClient		NetworkConnection オブジェクトをクライアントに送信するために使用します。

NetworkBehaviour は、以下の特徴を持っています。

• 変数の同期
• ネットワークコールバック
• サーバーとクライアントの機能
• コマンドの送信
• ClientRPC 呼び出し
• ネットワークイベント

変数の同期

NetworkBehaviour のメンバ変数は、サーバーからクライアントに同期させることができます。サーバーは、同期システムの権限を持っているので、サーバーからクライアントへの一方通行で同期されます。クライアントはコマンド機能を使って、同期権限のないクライアントからでもリクエストを行えます。

SyncVar 属性は、メンバ変数を同期するために使用されます。SyncVar は基本的な型が扱え、クラスやリスト、その他コレクションは扱えません。

public class SpaceShip : NetworkBehaviour
{
    [SyncVar]
    public int health;

    [SyncVar]
    public string playerName;
}

サーバー側で SyncVar の値が変更されたときゲーム内の準備ができているすべてのクライアントに向けて送信されます。オブジェクトが生成されたときは、サーバー側からすべての SyncVar で管理している最新のステータスを使ってクライアント側にオブジェクトを作成します。

ネットワークのコールバック

さまざまなネットワークイベントを NetworkBehaviour 上で実行するためのコールバック関数があります。基本クラスの virtual 関数としてあるため、以下のようにオーバーライドして使用することができます。

public class SpaceShip : NetworkBehaviour
{
    public override void OnStartServer()
    {
        // disable client stuff
    }

    public override void OnStartClient()
    {
        // register client events, enable effects
    }
}

OnStartServer 関数は、サーバー上でオブジェクトが生成されたとき、サーバーにあるシーン内のオブジェクトが起動した（読み込みした）ときに呼び出されます。OnStartClient 関数は、クライアント上でオブジェクトが生成されたとき、クライアントにあるシーン内のオブジェクトがサーバーと接続したときに呼び出されます。これらの関数は、サーバー上のみに影響をあたえる実装や、クライアント側のイベントを設定するときなど、クライアント/サーバー固有の実装を行うときに便利です。

ローカルクライアントを使用している場合は、OnStartServer と OnStartClient の両方の関数は同じオブジェクト上で呼び出されます。

他にもコールバックが用意されています。

• OnSerialize - サーバーからクライアントへ送信する情報の状態を返すために呼び出されます。
• OnDeSerialize - クライアントのオブジェクトに状態を適用するために呼び出されます。
• OnNetworkDestroy - サーバーからの指示でオブジェクトを破壊するときにクライアント上で呼び出されます。
• OnStartLocalPlayer - ローカルクライアントのプレイヤーオブジェクトの場合、クライアント上で呼び出されます（ローカルクライアントのみで呼び出されます）。
• OnRebuildObservers - オブジェクトのオブザーバーのリストを再構築するときにサーバー上で呼び出されます。
• OnSetLocalVisibility - ローカルクライアントのオブジェクトの可視化を変更するときにホスト上で呼び出されます。
• OnCheckObserver - 新規クライアントの可視化状態をチェックするためにサーバー上で呼び出されます。

サーバーとクライアントの関数

NetworkBehaviour のメンバー関数は、サーバーのみ・クライアントのみで実行できる関数がカスタム属性を付けるだけで実装できます。

using UnityEngine;
using UnityEngine.Networking;

public class SimpleSpaceShip : NetworkBehaviour
{
    int health;

    [Server]
    public void TakeDamage( int amount)
    {
        // will only work on server
        health -= amount;
    }

    [Client]
    void ShowExplosion()
    {
        // will only run on client
    }

    [ClientCallback]
    void Update()
    {
        // engine invoked callback - will only run on client
    }
}

ServerとClientの属性の付いたメソッドは、クライアントやサーバーがアクティブではないときに呼び出されると、メソッド中の処理は実行されません。コンパイル時にエラーは出力されませんが、実行時にコンソールに警告ログとして出力されます。ServerCallback と ClientCallback 属性では、ユーザーのコードはその呼び出しを制御せずに、エンジン側のコールバック関数として使用することができます。つまり、これらの属性は警告ログを生成せずに使用できるということです。

コマンドの送信

コマンドは、サーバーに対してなんらかのリクエストを行うための方法です。HLAPI は、サーバー権威システムなので、クライアントはコマンドを通してのみ何かを行うことができます。コマンドは送信したクライアントに対応する、サーバー上のプレイヤーオブジェクトで実行されます。これは自動でルーティングが行われ、クライアントが別のプレイヤーに対して送信されるということはありません。

コマンドは、メソッド名にプレフィックスとして “Cmd” と、[Command] 属性を付ける必要があります。

using UnityEngine;
using UnityEngine.Networking;

public class SpaceShip : NetworkBehaviour
{
    bool alive;
    float thrusting;
    int spin;

    [Command]
    public void CmdThrust(float thrusting, int spin)
    {   
        if (!alive)
        {
            this.thrusting = 0;
            this.spin = 0;
            return;
        }
            
        this.thrusting = thrusting;
        this.spin = spin;
    }

    [ClientCallback]
    void Update()
    {
        int spin = 0;
        if (Input.GetKey(KeyCode.LeftArrow))
        {
            spin += 1;
        }
        if (Input.GetKey(KeyCode.RightArrow))
        {
            spin -= 1;
        }
        // this will be called on the server
        CmdThrust(Input.GetAxis("Vertical"), spin);
    }
}

コマンドは、クライアント上で通常通りにメソッドを呼び出すように実行します。しかし実際は、クライアント上でコマンドの関数が実行されているのではなく、サーバ上にあるクライアントのプレイヤーオブジェクトに対して実行されています。つまり、コマンドはタイプセーフで、組み込みのセキュリティーが扱え、プレイヤーをルーティングし、効率的なシリアライゼーションのメカニズムを引数によって、高速に呼び出すことができます。

クライアントの RPC 呼び出し

クライアントの RPC 呼び出しは、サーバーで起こったことをクライアントのオブジェクトに伝えるための方法です。これはコマンド機能とは逆方向の機能ですが、考え方は同じです。RPC 呼び出しは、プレイヤーオブジェクト上で呼び出されるのではなく、NetworkIdentity オブジェクト上で呼び出されます。RPC 呼び出しは、メソッド名にプレフィックスとして “Rpc” と、[ClientRPC] 属性を付ける必要があります。

using UnityEngine;
using UnityEngine.Networking;

public class SpaceShipRpc : NetworkBehaviour
{
    [ClientRpc]
    public void RpcDoOnClient(int foo)
    {
        Debug.Log("OnClient " + foo);
    }

    [ServerCallback]
    void Update()
    {
        int value = UnityEngine.Random.Range(0,100);
        if (value < 10)
        {
            // this will be invoked on all clients
            RpcDoOnClient(value);
        }
    }
}

ネットワークイベント

ネットワークイベントは、クライアントの RPC 呼び出しのようなものです。ですが、違いとしてクライアント上のイベントとしてトリガーされた、クライアントオブジェクト上の関数が代わりに呼び出されます。イベントは、クライアント上で他のスクリプトからも登録することができ、サーバー上で実行することができます。イベントは、メソッド名にプレフィックスとして “Event” と、[SyncEvent] 属性を付ける必要があります。

イベントは他のスクリプトから拡張できる、強力なネットワークゲームのシステムを構築することができます。この例は、サーバー上にある Combat（戦闘）スクリプトによって生成されるイベントに、応答するクライアントのスクリプトを扱う方法です。

using UnityEngine;
using UnityEngine.Networking;

// Server script
public class MyCombat : NetworkBehaviour
{
    public delegate void TakeDamageDelegate(int side, int damage);
    public delegate void DieDelegate();
    public delegate void RespawnDelegate();
    
    float deathTimer;
    bool alive;
    int health;

    [SyncEvent(channel=1)]
    public event TakeDamageDelegate EventTakeDamage;
    
    [SyncEvent]
    public event DieDelegate EventDie;
    
    [SyncEvent]
    public event RespawnDelegate EventRespawn;

    [Server]
    void TakeDamage(int amount)
    {
        if (!alive)
            return;
            
        if (health > amount) {
            health -= amount;
        }
        else
        {
            health = 0;
            alive = false;
            // send die event to all clients
            EventDie();
            deathTimer = Time.time + 5.0f;
        }
    }

    [ServerCallback]
    void Update()
    {
        if (!alive)
        {
            if (Time.time > deathTimer)
            {
                Respawn();
            }
            return;
        }
    }

    [Server]
    void Respawn()
    {
        alive = true;
        // send respawn event to all clients
        EventRespawn();
    }
}

ヒント

• これは Commands と ClientRpc を提供するための基本クラスです。