Joywayer
f74d7f1877
- Round 8 report highlights improvements in architecture, editor usability, and data robustness, with a total score of 80/100. - Round 9 report focuses on editor extension capabilities, identifying issues with room data indexing and layout editing, resulting in a score of 76/100. - Round 26 report evaluates the system against commercial standards, noting new issues and confirming previous fixes, with a score of 95.8/100.
70 lines
3.1 KiB
C#
70 lines
3.1 KiB
C#
namespace BaseGames.World.Map
|
||
{
|
||
/// <summary>
|
||
/// IMapService 无状态扩展方法，集中可复用的查询逻辑。
|
||
/// MapPanel、MinimapHUD 等所有消费方均调用此处，避免分散的重复实现。
|
||
/// <para>
|
||
/// RegionNameEntry 字典构建与解析逻辑（BuildRegionDict / ResolveRegionDisplayName）
|
||
/// 也集中在此，供 RegionNameDisplay 和 MapProgressDisplay 共享，消除 DRY 违反。
|
||
/// </para>
|
||
/// </summary>
|
||
public static class MapServiceExtensions
|
||
{
|
||
/// <summary>
|
||
/// 将 RegionNameEntry 数组构建为 O(1) 查询字典。
|
||
/// RegionNameDisplay / MapProgressDisplay 共享此实现，避免重复代码。
|
||
/// </summary>
|
||
public static System.Collections.Generic.Dictionary<string, RegionNameEntry> BuildRegionDict(
|
||
RegionNameEntry[] entries)
|
||
{
|
||
var dict = new System.Collections.Generic.Dictionary<string, RegionNameEntry>();
|
||
if (entries == null) return dict;
|
||
foreach (var e in entries)
|
||
if (!string.IsNullOrEmpty(e.RegionId))
|
||
dict[e.RegionId] = e;
|
||
return dict;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 将 regionId 解析为玩家可读的显示名。
|
||
/// 优先读 LocKey，其次 DisplayName，最后回退到 regionId 本身。
|
||
/// </summary>
|
||
public static string ResolveRegionDisplayName(
|
||
System.Collections.Generic.Dictionary<string, RegionNameEntry> dict,
|
||
string regionId)
|
||
{
|
||
if (dict != null && dict.TryGetValue(regionId, out var e))
|
||
return e.GetDisplayName();
|
||
return regionId;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 根据探索状态推导房间三级可见性（Explored > Mapped > Unknown）。
|
||
/// </summary>
|
||
public static RoomVisibility GetVisibility(this IMapService svc, string roomId)
|
||
{
|
||
if (svc == null) return RoomVisibility.Unknown;
|
||
if (svc.IsExplored(roomId)) return RoomVisibility.Explored;
|
||
if (svc.IsMapped(roomId)) return RoomVisibility.Mapped;
|
||
return RoomVisibility.Unknown;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 在指定世界坐标处创建地图标记。
|
||
/// 通过 <see cref="IPlayerPositionProvider.TryGetRoomAtWorldPos"/> 将世界坐标转换为
|
||
/// 房间 ID 和归一化位置；坐标不在任何已知房间内时返回 null。
|
||
/// </summary>
|
||
public static BaseGames.Core.Save.MapPin CreatePinAtWorldPos(
|
||
this IPinService pinSvc,
|
||
IPlayerPositionProvider playerProvider,
|
||
UnityEngine.Vector3 worldPos,
|
||
BaseGames.Core.Save.PinType type = BaseGames.Core.Save.PinType.Marker,
|
||
string note = "")
|
||
{
|
||
if (pinSvc == null || playerProvider == null) return null;
|
||
if (!playerProvider.TryGetRoomAtWorldPos(worldPos, out var roomId, out var normPos)) return null;
|
||
return pinSvc.CreatePin(roomId, normPos.x, normPos.y, type, note);
|
||
}
|
||
}
|
||
}
|