インタレストマネジメント

概要

インタレストマネジメントは、クラウドサーバーから特定のプレイヤーへ、ネットワークオブジェクトのデータの複製を制限するための、データカリング機能一式です。
データカリングは、ネットワークのトラフィックの削減に役立ちます。

Object Interest

Object Interestはネットワークオブジェクトごとの設定で、オブジェクトに対して、プレイヤーがどのように関心を持つのかを定めます。ネットワークオブジェクトに関心を持たないプレイヤーは、サーバーからネットワークオブジェクトの更新（ネットワークプロパティやRPC）を受け取ることは一切ありません。

NetworkObject.ObjectInterestには、以下の3つのオプションがあります。

Area Of Interest：プレイヤーは、自身の関心領域と位置（2D/3D）が重なるネットワークオブジェクトに対して関心を持ちます
Global：ネットワークオブジェクトに対して、すべてのプレイヤーが関心を持ちます
Explicit：ネットワークオブジェクトに対して、明示的にSetPlayerAlwaysInterested()を使用したプレイヤーのみが関心を持ちます

NetworkObject ObjectInterest Options — Object Interestオプション

IInterestEnter / IInterestExit コールバック

ネットワークオブジェクトに登録されているコンポーネントにIInterestEnter/IInterestExitインターフェースを実装すると、ローカルプレイヤーがオブジェクトに対する関心を持った/失った時にInterestEnter(PlayerRef player)/InterestExit(PlayerRef player)が呼ばれます。これは、プレイヤーの関心領域にオブジェクトが出入りしたり、サーバーによって明示的にSetPlayerAlwaysInterested()が設定されたりした時に発生します。

これらのコールバックは、ホストモードのサーバー（専用サーバー/ホスト）でもトリガーされます。すべてのプレイヤーの関心から外れているネットワークオブジェクトの動作を、選択的に無効にするのに便利です（例えば、関心を持つプレイヤーがいないNPCのアニメーションを無効にしたい場合など）。

ローカルプレイヤーが関心を持つオブジェクトでのみ、クライアントでコールバックがトリガーされます。ホスト以外のプレイヤーは、他のプレイヤーがどのオブジェクトに関心を持っているかを知ることはできません。

NetworkBehaviourのIInterestEnterとIInterestExitの実装は、ネットワークオブジェクトによって自動的に検出されますが、NetworkBehaiourを継承しないコンポーネントでインターフェースを実装した場合は、NetworkRunnerに手動で登録する必要があります。

重要： プレイヤーの関心はSpawned()時に適用されるため、クライアントでは、オブジェクトがスポーンする時にIInterestEnterは呼び出されません。必要に応じて、Spawned()でInterestEnter()固有の処理を実行してください。

重要： クライアントでは、オブジェクトがデスポーンする時にIInterestExitは呼び出されません。必要に応じて、Despawned()でInterestExit()固有の処理を実行してください。

Area Of Interest

NetworkObjectでこのモードが選択されると、は、各プレイヤーが定義した関心領域（AOI）を使用して、プレイヤーがそのネットワークオブジェクトに関心があるかどうかを判定します。プレイヤーの関心領域を指定するには、Runner.AddPlayerAreaOfInterest()メソッドを呼び出します。

重要： 関心領域処理を有効にするには、Network Project ConfigのReplication FeaturesをScheduling and Interest Managementに設定する必要があります。

重要: Area Of Interest の処理を有効にするには、Network Project Config (NPC) の Replication Features フィールドを Scheduling and Interest Management に設定する必要があります。

Enable Interest Management — NetworkProjectConfigからインタレストマネジメントを有効にする

共有モードを使用している場合を除き、クライアントは複数の領域を定義することができます（例えば、プレイヤーがリモートカメラを操作している場合など）。プレイヤーは、関心領域に1つ以上重なるネットワークオブジェクトに関心を持ち、サーバーからネットワークオブジェクトの更新を受け取ります。

重要： 共有モードでは、AddPlayerAreaOfInterest()でプレイヤーの新しい関心領域を追加すると、過去のアクティブな領域は削除されます。共有モードは、プレイヤーごとに関心領域を1つのみ設定できます。

NetworkTransform要件

Fusionのコンポーネントは、NetworkTRSPを継承していて、関心領域処理に準拠します。
関心領域システムは、NetworkTransformクラスの位置の値から、オブジェクトの位置を決定します。関心領域処理に含めたいネットワークオブジェクトは、NetworkObjectコンポーネントと同じゲームオブジェクトにNetworkTransformコンポーネントを追加する必要があります。

NetworkTransformの詳細はこちらをご覧ください。

AddPlayerAreaOfInterestの使用方法

public class SetAreaOfInterest : NetworkBehaviour
{
  public float Extents = 32f;

  public override void FixedUpdateNetwork()
  {
    if (Runner.IsServer)
    {
      var controller = Object.InputAuthority;
      // Set the controlling players area of interest region around this object
      if (!controller.IsNone)
      {
        Runner.AddPlayerAreaOfInterest(controller, transform.position, Extents);
      }
    }
  }
}

備考： Object.SetPlayerAlwaysInterested()を関心領域と合わせて使用することで、関心領域外のオブジェクトに対して強制的に関心を持たせることができます。

Global

すべてのプレイヤーが、このネットワークオブジェクトに対して関心を持ちます。ネットワークオブジェクトに対するカリングを効率的に無効化でき、すべてのプレイヤーが、ネットワークオブジェクトの更新をサーバーから受け取ります。

Explicit

Runner.SetPlayerAlwaysInterested()で明示的に関心を持ったプレイヤーのみが、このネットワークオブジェクトに対して関心を持ちます。明示的に関心を持ったプレイヤーのみが、ネットワークオブジェクトの更新をサーバーから受け取ります。

public class MakeAlwaysInterested : NetworkBehaviour, IPlayerJoined
{
  void IPlayerJoined.PlayerJoined(PlayerRef player)
  {
    if (Runner.IsServer)
    {
      Object.SetPlayerAlwaysInterested(player, true);
      // or
      // Runner.SetPlayerAlwaysInterested(player, Object, true);
    }
  }
}

RPCとObject Interest

Object Interestは、静的ではないRPC（インスタンスRPC・ターゲットRPC）の配信にも影響します。サーバーは、ネットワークオブジェクトに関心を持たないプレイヤーへのRPC送信の失敗を、RpcInvokeInfoの戻り値から検知して処理できます。

[Rpc]
public RpcInvokeInfo RpcFoo()
{
  return default;
}

public override void FixedUpdateNetwork()
{
  if (Object.HasStateAuthority)
  {
    var info = RpcFoo();
    int culledCount = info.SendResult.CulledReceivers.Length;
    if (culledCount > 0)
    {
      //Handling for a target peer being culled from send
      Debug.LogWarning($"{culledCount} receivers culled, possibly due to no Object Interest.");
    }
  }
}

概要
Object Interest

IInterestEnter / IInterestExit コールバック
Area Of Interest
Global
Explicit
RPCとObject Interest