R3の機能を活用した実装例� �ReactiveProperty
最終更新：
orika_ex_miyako 2026年03月28日(土) 13:26:46履歴
Unity でリアクティブプログラミングを行う際、従来は UniRx が主流でしたが、現在は後継ライブラリである R3 を利用するケースが増えてきています。
この記事では、R3 の基本的な導入から、ReactiveProperty(リアクティブプロパティ) の使い方、シリアライズ対応、そしてゲームでの実践的な活用例まで解説します。
特に R3 では扱える内容が豊富ですが、最初は ReactiveProperty から入って、その後、理解を深めながら他の機能を実装していくとわかりやすいです。
R3 の導入
R3 は NuGet ベースのライブラリです。Unity では以下の方法で導入できます。
この辺りの手順については、下記の記事を参考にしてみてください。
参考サイト
方法� �NuGet for Unity
ProjectSettings の PackageManager から NuGet for Unity を導入し、「R3」で検索してインストールします。
方法�◆�GitHub から導入
ReactiveProperty(リアクティブプロパティ) とは？
ReactiveProperty(リアクティブプロパティ) は、「値の変更を監視できる変数」です。
通常の変数と違い、「値が変わった瞬間」にイベントのように通知を受け取ることができます。
基本的な使い方
この処理のポイントは、
この例であれば、Hp 変数の値が変化するたびに、Debug.Log が実行されますので、
この部分を画面更新処理に変更すれば、Hp の値が変わると自動的に UI が更新される仕組みを作成できます。
そのため、通常であれば、「�（竸�変更 → ��UI更新」と、２つの処理を書く必要がある所を
「�（竸�変更 → 自動的に UI更新」となり、処理が１つでよい形になります。
ReactiveProperty の主な機能
�� 値変更の通知
値が変わるたびに呼ばれます。
�� 初期値も即時通知
Subscribe した瞬間に現在の値が流れるのも特徴です。
�� Where / Select などのオペレータによるLINQ的操作
R3 には UniRx 同様、オペレータが用意されており、メソッドチェーンすることにより、LINQ のような書き心地で処理を実装できます。
この例であれば、Where オペレータにより、条件付きでイベントを受け取れます。
�� 他のReactivePropertyと連携
CombineLatest オペレータは複数のIObservableをまとめられる機能を持ちます。
こちらを利用することで、複数の ReactiveProperty をまとめることができます。
参考サイト
ReactiveProperty のシリアライズ方法（R3版）
R3 では、ReactiveProperty をそのまま使うと Inspector に表示されませんが、
SerializableReactiveProperty を使うことで簡単にシリアライズ対応が可能です。
SerializableReactiveProperty の基本
これだけで「Inspector で値を編集可能＋値変更時に自動通知」が両立できます。
値の取得と変更
通常の ReactiveProperty と同じ感覚で扱えます。
Subscribe もそのまま使える
こちらも同じです。
null チェック不要
SerializableReactiveProperty はインスタンスとして保持されるため、
そのまま安全に呼べます。
初期値の扱い
この値が Inspector にも反映されます。
ScriptableObject とも相性が良い
👉 データ駆動設計とも相性がよいです。
ゲームでの実装例
HP管理 ＋ UI連動
HpView クラスで Player クラスの ReactiveProperty を購読し、Hp の変化に合わせて自動的に UI 表示を更新させる方法です。
最も一般的であり、かつ利用価値の高い処理の１つになります。
ダメージ処理 ＋ 生存判定
実践的な設計ポイント
先ほどの実装における、設計ポイントを上げます。
�� 「状態」と「表示」を分離する
・Player：状態管理
・View：表示更新
👉 MVC / MVVM に近い構造になる
�� イベントよりも安全
👉 呼び忘れがなくなる
�� 依存関係が見えやすい
デリゲートなどに比べて、どこで何が監視されているかが明確になります。
まとめ
ReactiveProperty を使うことで、以下のメリットが得られます。
特にゲーム開発では、
など、ほぼすべての状態管理に応用可能です。
この記事では、R3 の基本的な導入から、ReactiveProperty(リアクティブプロパティ) の使い方、シリアライズ対応、そしてゲームでの実践的な活用例まで解説します。
特に R3 では扱える内容が豊富ですが、最初は ReactiveProperty から入って、その後、理解を深めながら他の機能を実装していくとわかりやすいです。
R3 の導入 
R3 は NuGet ベースのライブラリです。Unity では以下の方法で導入できます。
この辺りの手順については、下記の記事を参考にしてみてください。
参考サイト
Qiita @toRisouP 様
【Unityユーザー向け】 R3入門 導入編
https://qiita.com/toRisouP/items/25ab6dbf5efbbc13e...
ササミテック 様
【Unity】個人的によく使うパッケージの導入方法まとめ【R3/UniTask/VContainer/DOTween】
https://www.sasami-tech.com/unity-package-installa...
方法� �NuGet for Unity
ProjectSettings の PackageManager から NuGet for Unity を導入し、「R3」で検索してインストールします。
方法�◆�GitHub から導入
ReactiveProperty(リアクティブプロパティ) とは？
ReactiveProperty(リアクティブプロパティ) は、「値の変更を監視できる変数」です。
通常の変数と違い、「値が変わった瞬間」にイベントのように通知を受け取ることができます。
基本的な使い方
using R3;
ReactiveProperty<int> hp = new ReactiveProperty<int>(100);
// 値変更の監視
hp.Subscribe(value =>
{
Debug.Log($"HPが変更されました: {value}");
});
// 値変更
hp.Value = 80;
この処理のポイントは、
・Value を変更すると自動で通知される
・Subscribe の処理を記述することで、上記の通知で変更を監視できる
・特に UI 更新や状態管理と相性が良い
この例であれば、Hp 変数の値が変化するたびに、Debug.Log が実行されますので、
この部分を画面更新処理に変更すれば、Hp の値が変わると自動的に UI が更新される仕組みを作成できます。
そのため、通常であれば、「�（竸�変更 → ��UI更新」と、２つの処理を書く必要がある所を
「�（竸�変更 → 自動的に UI更新」となり、処理が１つでよい形になります。
ReactiveProperty の主な機能
�� 値変更の通知
ReactiveProperty<int> hp = new ReactiveProperty<int>(100); hp.Subscribe(x => Debug.Log(x));
値が変わるたびに呼ばれます。
�� 初期値も即時通知
Subscribe した瞬間に現在の値が流れるのも特徴です。
�� Where / Select などのオペレータによるLINQ的操作
R3 には UniRx 同様、オペレータが用意されており、メソッドチェーンすることにより、LINQ のような書き心地で処理を実装できます。
hp
.Where(x => x <= 0) // hp の値が 0 以下になったら
.Subscribe(_ => Debug.Log("死亡")); // ログを出す
この例であれば、Where オペレータにより、条件付きでイベントを受け取れます。
�� 他のReactivePropertyと連携
CombineLatest オペレータは複数のIObservableをまとめられる機能を持ちます。
こちらを利用することで、複数の ReactiveProperty をまとめることができます。
ReactiveProperty<int> attack = new(10);
ReactiveProperty<int> buff = new(5);
var totalAttack = attack.CombineLatest(buff, (a, b) => a + b);
totalAttack.Subscribe(x => Debug.Log($"合計攻撃力: {x}"));
参考サイト
Qiita @toRisouP 様
R3 オペレーター/ファクトリーメソッド まとめ
https://qiita.com/toRisouP/items/3d045aa248824571b...
ReactiveProperty のシリアライズ方法（R3版）
R3 では、ReactiveProperty をそのまま使うと Inspector に表示されませんが、
SerializableReactiveProperty を使うことで簡単にシリアライズ対応が可能です。
SerializableReactiveProperty の基本
using R3;
using UnityEngine;
public class Player : MonoBehaviour
{
[SerializeField]
public SerializableReactiveProperty<int> Hp = new(100);
}
これだけで「Inspector で値を編集可能＋値変更時に自動通知」が両立できます。
値の取得と変更
// 取得 int hp = player.Hp.Value; // 変更 player.Hp.Value = 50;
通常の ReactiveProperty と同じ感覚で扱えます。
Subscribe もそのまま使える
player.Hp.Subscribe(x =>
{
Debug.Log($"HP: {x}");
});
こちらも同じです。
null チェック不要
SerializableReactiveProperty はインスタンスとして保持されるため、
Hp.Subscribe(...)
そのまま安全に呼べます。
初期値の扱い
public SerializableReactiveProperty<int> Hp = new(100);
この値が Inspector にも反映されます。
ScriptableObject とも相性が良い
[CreateAssetMenu]
public class PlayerData : ScriptableObject
{
public SerializableReactiveProperty<int> hp;
}
👉 データ駆動設計とも相性がよいです。
ゲームでの実装例
HP管理 ＋ UI連動
public class Player : MonoBehaviour
{
public ReactiveProperty<int> Hp = new(100);
}
public class HpView : MonoBehaviour
{
[SerializeField] private Player player;
[SerializeField] private Text hpText;
void Start()
{
player.Hp.Subscribe(x =>
{
hpText.text = $"HP: {x}";
});
}
}
HpView クラスで Player クラスの ReactiveProperty を購読し、Hp の変化に合わせて自動的に UI 表示を更新させる方法です。
最も一般的であり、かつ利用価値の高い処理の１つになります。
ダメージ処理 ＋ 生存判定
public void Damage(int value)
{
Hp.Value -= value;
}
Player クラス
Hp
.Where(x => x <= 0)
.Subscribe(_ =>
{
Debug.Log("プレイヤーがやられた");
});
実践的な設計ポイント
先ほどの実装における、設計ポイントを上げます。
�� 「状態」と「表示」を分離する
・Player：状態管理
・View：表示更新
👉 MVC / MVVM に近い構造になる
�� イベントよりも安全
// 従来 OnHpChanged?.Invoke(); // Reactive Hp.Value = 50;
👉 呼び忘れがなくなる
�� 依存関係が見えやすい
デリゲートなどに比べて、どこで何が監視されているかが明確になります。
まとめ
ReactiveProperty を使うことで、以下のメリットが得られます。
状態変更の自動通知 UIとの連動の簡略化 バグの減少
特にゲーム開発では、
HP / MP ステータス UI更新 フラグ管理
など、ほぼすべての状態管理に応用可能です。
コメントをかく