【Unity】Unityで学ぶデザインパターン12: Proxy パターン【デザパタ】

# はじめに
様々な言語で「デザインパターン」の本が世の中にありますが、筆者個人の経験では
`いまいちピンとこない例` `いまいちピンとこないコード` で説明されてることが多く、
`結局これっていつ使うの？` という疑問に答えるには仕事仲間等との議論をしないと
辿り着けないことが多々ありました。

そこで特に「ゲーム開発ではどう使うか？」にフォーカスを当てて、実践的な例を交えて
デザインパターンの説明の需要があると思い記事を作りました。

## デザインパターンを学ぶ理由

デザインパターンを学ぶ理由としては
1. 車輪の再発明の防止
1. 長文で読みにくいコード（可読性の低いコード）を減らす
1. コードを疎結合にして変更に強くなる(変更時のコスト・変更箇所を減らす)
1. モジュールとして使いまわせるように、コードの再利用性を高める
といった効果を期待できます。

## 対象読者
Unity 全くの初心者(インストールしただけで触ったことがないような方)はお断りです。
最低限以下のことは理解・経験を積んでおくことが必須になります。

- MonoBehaviour 継承クラスでコードを書いたことがある
- C# のピュアクラスを用いた自作クラスを作ったことがある
- クラスの継承という概念は知っている

そのため、`脱・初心者` `中級者へのステップアップ` として `デザインパターンを学ぶ` のが良いと思います。

# デザパタ記事リンク
## 生成系
1. [AbstractFactory パターン](https://qiita.com/Cova8bitdot/items/e863cecf48c0529ba05a)
1. [Builder パターン](https://qiita.com/Cova8bitdot/items/9dcdfeb0641bc774b1f8)
1. [FactoryMethod パターン](https://qiita.com/Cova8bitdot/items/61a38fd51735f321e564)
1. [Prototype パターン](https://qiita.com/Cova8bitdot/items/0bc251bc36201985c204)
1. [Singleton パターン](https://qiita.com/Cova8bitdot/items/29b7064c7472a6f34972)

## 構造系
1. [Adapter パターン](https://qiita.com/Cova8bitdot/items/f09776957073cf64902b)
1. [Bridge パターン](https://qiita.com/Cova8bitdot/private/5b528216952c74436045)
1. [Composite パターン](https://qiita.com/Cova8bitdot/items/1c57d856027a33e99eb0)
1. [Decorator パターン](https://qiita.com/Cova8bitdot/items/e1373a756b3dfd86c920)
1. [Facade パターン](https://qiita.com/Cova8bitdot/items/bdf0976bdfa83e57f121)
1. [Flyweight パターン](https://qiita.com/Cova8bitdot/items/7f1f1f04b46ebaf43c5e)
1. [Proxy パターン](https://qiita.com/Cova8bitdot/items/77bef2e721f0be0804d2) (本記事)

## 様態・ふるまい系
1. [Chain of Responsibility パターン](https://qiita.com/Cova8bitdot/items/66c62dd96adffda7e72e)
1. [Command パターン](https://qiita.com/Cova8bitdot/items/9a88f7fc0782c729f97c)
1. [Interpreter パターン](https://qiita.com/Cova8bitdot/items/a871c1de813d14049934)
1. [Iterator パターン](https://qiita.com/Cova8bitdot/items/302f19863cc3b2235625)
1. [Mediator パターン](https://qiita.com/Cova8bitdot/items/be33b97f35c84e814df7)
1. [Memento パターン](https://qiita.com/Cova8bitdot/items/ae7e6f5d2da7b07d379b)
1. [Observer パターン](https://qiita.com/Cova8bitdot/items/632782ad5264baf6a366)
1. [State パターン](https://qiita.com/Cova8bitdot/items/ab9fc16ac3a6657fdce0)
1. [Strategy パターン](https://qiita.com/Cova8bitdot/items/28dd773075cf6e9fefee)
1. [TemplateMethod パターン](https://qiita.com/Cova8bitdot/items/f0bed164ef6563b489d0)
1. [Visitor パターン](https://qiita.com/Cova8bitdot/items/15c56d40435adf63891d)


# Proxy　パターンについて
`代理人` という意味を持つ `Proxy` 。
具体的には、ある処理を行うときに、その処理が複雑だったり長かったり、レスポンスに時間を要する場合に、別のクラスやモジュールに処理を依頼することがあります。この処理を依頼された側を `proxy` と呼称します。

## Facade パターンとの違い
代理人という意味では窓口になる Facade パターンも、Proxyパターンの一種として見なすこともできます。
確かに単純なインターフェース実行するときには最初にFacadeパターンが窓口になって代理実行して返すこともあります。
また、Facade内でも処理が長くなる場合は、機能を分割したサブクラスに実行依頼をするという proxy が別のproxy に代理実行依頼をするようなパターンもあります。
ただ、Facadeパターンは以前の記事でも解説した通り `複雑なインターフェースの代わりに簡易なAPIを提供する` 役目もあるため、そこは明確にproxyパターンとの役割の違いがあります。

## Proxy パターンの種類
Proxy パターンは、その特性から大きく4つに大別されます。

1. リモートプロキシ
1. 仮想プロキシ
1. プロテクションプロキシ
1. スマートリファレンスプロキシ

### リモートプロキシ

リモートプロキシはおそらく一番有名なプロキシパターンの使い方です。
ローカルにあるObjectがリモートにあるObjectの代理として存在するような場合です。
そしてリモートにあるObjectを操作するためにローカルObjectからRPC（RemoteProcedureCall）を発行することでローカルObjectと同じ動きをRemoteにあるObjectにも適応することができます。

ゲーム開発では多人数プレイのゲームでは必須級の技術です。

### 仮想プロキシ
仮想プロキシとは、あたかも実体（インスタンス）があるかのように振る舞うプロキシです。
特に重い処理（I/O や描画等）を行う場合に、Commandパターンを利用して処理を遅延するという使い方もあるため `軽量プロキシ` とも呼ばれます。

### プロテクションプロキシ

依頼主の権限レベルに合わせた適切なProxyを渡すことで、セキュリティレベルを制御するという方法があります。

### スマートリファレンスプロキシ

C＃ではあまり意識しませんが、C++ではスマートポインタと呼ばれるポインタ操作用の仕組みがあります。
またObjective-cではポインタのライフサイクル管理のために参照カウントを持って、参照カウントが0になったタイミングで初めてリソースの解放を行うように作ります。

この「Objectの間接参照時」に何か操作を加える（今回であれば参照カウントを増やす・減らす）ようなパターンがスマートリファレンスプロキシと呼ばれるようです。

# ゲーム における Proxy パターン
おそらくゲームでも小規模のプロジェクト（例えばワンボタンアクションのゲーム等）を除けば、`処理の分割・委譲` というのは日常茶飯事で起きることかと思います。
この委譲先のサブクラスで同じインターフェースを実装していれば、まさに Proxy パターンそのものになるということです。


さてここからはプロキシパターンの使い方でゲームに特化した例を見ていきましょう。

### リモートプロキシ

先ほどの説明の通りオンラインマルチプレイゲームでは必須テクニックです。
Unityでいえば [Photon のRPC](https://doc.photonengine.com/ja-jp/pun/current/gameplay/rpcsandraiseevent) などが有名でしょう。

### 仮想プロキシ
ゲームでの仮想プロキシ例として `オープンワールドゲーム` における `Object操作` があります。
オープンワールドゲームでは広大なフィールドが舞台なため、基本的にプレイヤーの周囲以外のObjectは描画されません。

しかし、描画されないObjectは止まっているのかというとそうではありません。そのため描画対象外のObjectでも、情報としてObjectの更新は必要です。

そこで以下のように Transform 情報を持つProxyクラスを用意して、基本的なループはこれを更新し、描画対象になったタイミングで初めてObjectをInstantiateしたりGameObject.SetActive（true）を呼ぶことで実体を生成するという方法があります。

このようにしておくことで、最初から全てのObjectを生成せずとも座標情報の更新が行えるというメリットがあります

```GameObjectProxy.cs

using UnityEngine;


public class GameObjectProxy
{
    public Vector3 Position { get; protected set; }
    public Quaternion Rotation { get; protected set; }
    public Vector3 Scale { get; protected set; }
    public bool IsActive { get; protected set; }
    private GameObject m_instance = null;
    private Object m_prefab = null;

    public ObjectProxy(Object prefab)
    {
        m_prefab = prefab;
    }
    
    public void SetPosition(Vector3 pos)
    {
        Position = pos;
        m_instance?.transform.SetPositionAndRotation(Position, Rotation);
    }
    public void SetRotation(Quaternion rot)
    {
        Rotation = rot;
        m_instance?.transform.SetPositionAndRotation(Position, Rotation);
    }
    public void SetScale(Vector3 scale)
    {
        Scale = scale;
        if(m_instance!=null) m_instance.transform.localScale = Scale;
    }

    public void Activate()
    {
        IsActive = true;
        if (m_instance == null) CreateInstance();
        m_instance.SetActive(true);
    }
    
    public void Deactivate()
    {
        IsActive = false;
        m_instance?.SetActive(false);
    }

    protected void CreateInstance()
    {
        m_instance = (GameObject)Object.Instantiate(m_prefab, Position, Rotation);
    }
}


```


### プロテクションプロキシ

例えば、マルチプレイにあたって、自分自身は`パラメータを変更可能` ですが、他プレイヤーのパラメータに関しては変更するのは非常にまずいです。場合によってはチート行為を助長することにもつながりかねません。

そこでキャラクターパラメータにReadOnly と普通のと用意し、それぞれを権限保持状態に応じて渡すことでコード的にアクセスをブロックすることができます。

```CharacterParamProxy.cs

public class CharacterParameter
{
    public string Name;
    public int MaxHP;
    public int CurrentHP;
    public int ATK;
    public int DEF;
}

public interface ICharacterParamOperator
{
    string GetName();
    void SetName(string name);

    int GetMaxHP();
    void SetMaxHP(int hp);

    int GetCurrentHP();
    void SetCurrentHP(int hp);

    int GetATK();
    void SetATK(int atk);

    
    int GetDEF();
    void SetDEF(int def);
}

public class LocalCharaProxy : ICharacterParamOperator
{
    private CharacterParameter m_myParam = new CharacterParameter();

    #region ===== ICharacterParamOperator =====

    string ICharacterParamOperator.GetName() => m_myParam.Name;

    void ICharacterParamOperator.SetName(string name) { m_myParam.Name = name;}

    int ICharacterParamOperator.GetMaxHP() => m_myParam.MaxHP;
    void ICharacterParamOperator.SetMaxHP(int hp){ m_myParam.MaxHP = hp;}

    int ICharacterParamOperator.GetCurrentHP() => m_myParam.CurrentHP;
    void ICharacterParamOperator.SetCurrentHP(int hp){ m_myParam.CurrentHP = hp;}

    int ICharacterParamOperator.GetATK() => m_myParam.ATK;
    void ICharacterParamOperator.SetATK(int atk){ m_myParam.ATK = atk;}

    
    int ICharacterParamOperator.GetDEF() => m_myParam.DEF;
    void ICharacterParamOperator.SetDEF(int def){ m_myParam.DEF = def;}

    #endregion //) ===== ICharacterParamOperator =====
}

public class RemoteCharaProxy : ICharacterParamOperator
{
    private CharacterParameter m_myParam = new CharacterParameter();

    #region ===== ICharacterParamOperator =====

    string ICharacterParamOperator.GetName() => m_myParam.Name;

    void ICharacterParamOperator.SetName(string name) { }

    int ICharacterParamOperator.GetMaxHP() => m_myParam.MaxHP;
    void ICharacterParamOperator.SetMaxHP(int hp){ }

    int ICharacterParamOperator.GetCurrentHP() => m_myParam.CurrentHP;
    void ICharacterParamOperator.SetCurrentHP(int hp){ }

    int ICharacterParamOperator.GetATK() => m_myParam.ATK;
    void ICharacterParamOperator.SetATK(int atk){ }

    
    int ICharacterParamOperator.GetDEF() => m_myParam.DEF;
    void ICharacterParamOperator.SetDEF(int def){ }

    #endregion //) ===== ICharacterParamOperator =====
}
```

このように同じインターフェースでも権限毎に実装を変えたプロキシクラスを用意しておくことで、安全にパラメータ操作を行うことが可能です。

### スマートリファレンスプロキシ

Unityでいえば `Addressables` の管理システムがまさにこれです。
`Addressables` は `AssetBundle` システムをラッパーした仕組みになっているのですが、このAssetBundleというファイルは内部に1つ以上のAssetを内包しています。
このとき、AssetをAssetBundleから取り出すタイミングで、AssetBundleからロードすればいいのですが、1度Open状態になっているAssetBundleファイルに再度Openリクエストを発行すると例外が発生します。
そのためAssetBundleはOpen中なのかどうかを管理する必要があります。

Addressbles登場前はここを自前で管理・設計するため難易度が高かったのですが、Addressablesは参照カウントを公式がサポートしてくれたためにだいぶ楽になりました。

参考：https://qiita.com/Cova8bitdot/items/20e8962ed0ca0544289d

# まとめ

Proxy パターンは非常に多岐にわたって使われるデザインパターンです。
ただ委譲するだけでなく、権限やパフォーマンス稼ぎなどさまざまな用途に利用可能なので、ぜひ習得しましょう！


#  参考

http://marupeke296.com/DP_Proxy.html