FileUtility
February 9, 2024 · View on GitHub
Namespace: Unity.SaveData.Core
概要:
FileUtility は、プラットフォームに適した方法でデータの保存と読み込みを行うためのユーティリティクラスです。JSON 形式でデータを扱い、ローカルファイルシステムまたは PlayerPrefs を使用してデータを永続化します。
機能と操作:
- パスの生成: 指定されたファイル名とパスに基づいて、現在のプラットフォームに適したファイルパスを生成します。
- データの削除: 指定されたパスと名前を持つデータファイルを削除します。
- データの保存: 指定された値を、指定されたパスとファイル名で保存します。保存形式は JSON です。
- データの読み込み: 指定されたパスとファイル名からデータを読み込み、指定された型に逆シリアライズします。データが存在する場合は
trueを返します。
メソッド
| Name | Function |
|---|---|
Save<TValue> | 指定された値を JSON 形式で保存します。 |
Load<TValue> | JSON 形式のデータを読み込み、指定された型に逆シリアライズします。 |
Remove | 指定されたパスと名前を持つデータファイルを削除します。 |
IsExists | 指定されたパスと名前を持つデータが存在するかどうかをチェックします。 |
使用例
- ゲームの設定やプレイヤーの進捗などのデータを保存する際に
Saveメソッドを使用します。 - ゲーム開始時や特定のポイントで設定や進捗を読み込む際に
Loadメソッドを使用します。 - 不要になったデータを削除する際に
Removeメソッドを使用します。 - データの存在確認に
IsExistsメソッドを使用します。
その他の注意事項
UNITY_WEBGLとUNITY_EDITORのディレクティブを使用して、プラットフォームごとの保存方法を分岐しています。WebGL の場合はPlayerPrefsを使用し、それ以外のプラットフォームではローカルファイルシステムを使用します。DataStore<T>構造体は、JsonUtilityが直接リストをシリアライズできない問題を解決するために使用されます。任意の型のデータを JSON 形式でシリアライズ/逆シリアライズすることができます。
FileUtility は、データの保存と読み込みを簡単かつ効率的に行うための便利なツールです。特に、ゲームの設定やユーザーの進捗など、永続的に保持したい情報の管理に役立ちます。