using System.Collections.Generic;
using GameLauncher.Engines.Unity;
using GameLauncher.Models;
namespace GameLauncher.Services.Codecs
{
///
/// バイナリ/暗号化セーブデータのGUI編集用デコーダー・エンコーダーインターフェース
///
public interface ISaveDataCodec
{
///
/// コーデックの識別名称(例: "Easy Save 3 (ES3)", "YU-RIS セーブデータ")を取得します。
///
string CodecName { get; }
///
/// このコーデックで指定ファイルを処理可能か判定します。
///
/// 対象のUnityゲーム情報
/// 対象のセーブファイル情報
/// 処理可能な場合は true、それ以外は false
bool CanHandle(UnityGameItem game, SaveFileEntry file);
///
/// セーブファイルからGUI編集用プロパティ一覧をロード・解析します。
///
/// セーブファイルの絶対パス
/// 任意の暗号化パスワード
/// 展開されたセーブデータプロパティのリスト
List LoadProperties(string filePath, string? optionalPassword = null);
///
/// GUI編集されたプロパティ一覧をファイルへ再エンコード・保存します。
///
/// 保存先セーブファイルの絶対パス
/// 編集されたプロパティ一覧
/// 任意の暗号化パスワード
/// 保存に成功した場合は true、それ以外は false
bool SaveProperties(string filePath, List properties, string? optionalPassword = null);
///
/// 復号にパスワードやキーが必要かどうかを取得します。
///
bool RequiresPassword { get; }
///
/// パスワード入力時の案内メッセージを取得します。
///
string? PasswordPromptMessage { get; }
}
}