VRC Udon Persistence Sync
役割
UdonSharp システムにおける状態保存と同期の責務を分ける。local state、synced state、Player Data、Player Object、Persistence のどれを使うかを判断し、混線を防ぐ。
この Skill を使う場面
- local / sync / Player Data / Player Object / Persistence を使い分けたい
- key 設計や復元順を決めたい
- 保存責務と同期責務を分けたい
この Skill を使わない場面
- networking 文書を先に固定したいだけの場合:
vrc-udon-networking-rules - モジュール構造設計から始める場合:
vrc-udon-core-module
進め方
references/sync-decision-guide.mdを読む。- Persistence も使うなら
references/persistence-notes.mdを読む。 - 状態ごとに分類する。
- 復元順を決める。
- key 命名規則を決める。
- Networking 全体の仕様が未整理なら
$vrc-udon-networking-rulesも併用する。
担当範囲
- 保存方式の選択
- 復元順の整理
- key 設計の整理
- PlayerObject と Persistence の関係整理
注意点
- Persistence はリアルタイム同期の代わりにしない
- 復元前提の値を Awake 相当で即参照しない
- 保存キーは後方互換を考えて決める
- 破棄できる状態まで永続化しない