32 lines
1.1 KiB
C#
32 lines
1.1 KiB
C#
using System.Collections.Generic;
|
||
|
||
namespace BaseGames.Equipment
|
||
{
|
||
/// <summary>
|
||
/// 装备管理服务接口。UI 层通过此接口读取护符状态并驱动装备操作，
|
||
/// 与 EquipmentManager 具体实现解耦，便于独立测试和跨场景复用。
|
||
/// </summary>
|
||
public interface IEquipmentService
|
||
{
|
||
/// <summary>已使用的 Notch 数量（缓存值，避免每帧 LINQ Sum）。</summary>
|
||
int UsedNotches { get; }
|
||
|
||
/// <summary>Notch 总容量。</summary>
|
||
int TotalNotches { get; }
|
||
|
||
/// <summary>当前已装备护符列表（只读视图）。</summary>
|
||
IReadOnlyList<CharmSO> Equipped { get; }
|
||
|
||
/// <summary>已收集护符列表（只读视图）。</summary>
|
||
IReadOnlyList<CharmSO> Collected { get; }
|
||
|
||
/// <summary>
|
||
/// 装备护符。返回 null 表示成功；返回错误描述字符串表示失败原因。
|
||
/// </summary>
|
||
string TryEquipCharm(CharmSO charm);
|
||
|
||
/// <summary>卸下指定护符。</summary>
|
||
void UnequipCharm(CharmSO charm);
|
||
}
|
||
}
|