79 lines
2.5 KiB
C#
79 lines
2.5 KiB
C#
using System;
|
|
using System.Collections;
|
|
using UnityEngine;
|
|
|
|
namespace AibisDream.SaveSystem
|
|
{
|
|
/// <summary>
|
|
/// 快照提供者契约：将某一子系统的运行时状态转换为纯数据 DTO。
|
|
/// 还原侧由同步 / 异步子接口显式声明，避免 Provider 内部 fire-and-forget。
|
|
/// </summary>
|
|
public interface ISnapshotProvider
|
|
{
|
|
/// <summary>
|
|
/// 稳定显式 id，用作 <see cref="SaveSnapshot.sections"/> 的 key。
|
|
/// 见 <see cref="SnapshotProviderIds"/>，不使用 C# 类型全名。
|
|
/// </summary>
|
|
string SaveId { get; }
|
|
|
|
/// <summary>
|
|
/// 同阶段内的读档还原顺序。数值越小越先执行。
|
|
/// </summary>
|
|
int RestoreOrder { get; }
|
|
|
|
/// <summary>从当前运行时捕获该子系统的快照 DTO；无可存内容时可返回 null。</summary>
|
|
object Capture();
|
|
}
|
|
|
|
/// <summary>
|
|
/// 同步快照还原 Provider。实现中不得启动 fire-and-forget 协程。
|
|
/// </summary>
|
|
public interface ISyncSnapshotProvider : ISnapshotProvider
|
|
{
|
|
void Restore(object dto, SnapshotRestoreContext context);
|
|
}
|
|
|
|
/// <summary>
|
|
/// 异步快照还原 Provider。所有必须等待的加载 / 状态切换须通过此协程暴露给编排层。
|
|
/// </summary>
|
|
public interface IAsyncSnapshotProvider : ISnapshotProvider
|
|
{
|
|
IEnumerator RestoreAsync(object dto, SnapshotRestoreContext context);
|
|
}
|
|
|
|
/// <summary>
|
|
/// 单次读档还原流程上下文。
|
|
/// </summary>
|
|
public sealed class SnapshotRestoreContext
|
|
{
|
|
public SnapshotRestoreContext(SaveSnapshot snapshot, bool strictMode = false, Action<string> logStep = null)
|
|
{
|
|
Snapshot = snapshot;
|
|
StrictMode = strictMode;
|
|
LogStep = logStep;
|
|
}
|
|
|
|
public SaveSnapshot Snapshot { get; }
|
|
public bool StrictMode { get; }
|
|
public Action<string> LogStep { get; }
|
|
|
|
public void Log(string message)
|
|
{
|
|
LogStep?.Invoke(message);
|
|
Debug.Log($"[SnapshotRestore] {message}");
|
|
}
|
|
|
|
public void Warn(string message)
|
|
{
|
|
LogStep?.Invoke($"WARN: {message}");
|
|
Debug.LogWarning($"[SnapshotRestore] {message}");
|
|
}
|
|
|
|
public void Error(string message)
|
|
{
|
|
LogStep?.Invoke($"ERROR: {message}");
|
|
Debug.LogError($"[SnapshotRestore] {message}");
|
|
}
|
|
}
|
|
}
|