463 lines
17 KiB
C#
463 lines
17 KiB
C#
|
using System;
|
|||
|
|
using System.Collections.Generic;
|
|||
|
|
using System.Reflection;
|
|||
|
|
using Cielonos.MainGame;
|
|||
|
|
using Cielonos.Settings;
|
|||
|
|
using Cielonos.Settings.UI;
|
|||
|
|
using SLSUtilities.UI;
|
|||
|
|
using TMPro;
|
|||
|
|
using UnityEngine;
|
|||
|
|
using UnityEngine.InputSystem;
|
|||
|
|
using UnityEngine.UI;
|
|||
|
|
|
|||
|
|
namespace Cielonos.UI
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 设置界面页面（单页滚动式 + 右侧面板）。
|
|||
|
|
/// <para>
|
|||
|
|
/// <b>左侧：</b>所有设置分类在同一页面中按顺序展示，每个分类前插入标题。
|
|||
|
|
/// 通过反射读取各设置类的公共字段，按类型自动选择 Entry Prefab 实例化。
|
|||
|
|
/// 同时支持手动添加的按钮条目（如"Key Bindings"按钮）。
|
|||
|
|
/// </para>
|
|||
|
|
/// <para>
|
|||
|
|
/// <b>右侧：</b>包含两种面板状态：
|
|||
|
|
/// <list type="number">
|
|||
|
|
/// <item>说明面板（<see cref="descriptionPanel"/>）：鼠标悬停条目时显示说明文本，离开后隐藏。</item>
|
|||
|
|
/// <item>详情页面（如 <see cref="keyBindingPage"/>）：点击按钮后打开的二级 UIPage，
|
|||
|
|
/// 打开期间悬停说明被抑制，需手动关闭。</item>
|
|||
|
|
/// </list>
|
|||
|
|
/// </para>
|
|||
|
|
/// </summary>
|
|||
|
|
public class SettingsUIPage : UIPageBase
|
|||
|
|
{
|
|||
|
|
// ──────────────────── Entry Prefabs ──────────────────
|
|||
|
|
|
|||
|
|
[Header("Entry Prefabs")]
|
|||
|
|
[Tooltip("bool 字段使用的 Toggle 条目预制体，需挂载 SettingsEntryToggle。")]
|
|||
|
|
[SerializeField] private GameObject toggleEntryPrefab;
|
|||
|
|
|
|||
|
|
[Tooltip("带 [Range] 的 int 字段使用的 Slider 条目预制体，需挂载 SettingsEntrySlider。")]
|
|||
|
|
[SerializeField] private GameObject sliderEntryPrefab;
|
|||
|
|
|
|||
|
|
[Tooltip("enum 字段使用的 Dropdown 条目预制体，需挂载 SettingsEntryDropdown。")]
|
|||
|
|
[SerializeField] private GameObject dropdownEntryPrefab;
|
|||
|
|
|
|||
|
|
[Tooltip("按钮条目预制体，需挂载 SettingsEntryButton。")]
|
|||
|
|
[SerializeField] private GameObject buttonEntryPrefab;
|
|||
|
|
|
|||
|
|
// ──────────────────── Section Header ──────────────────
|
|||
|
|
|
|||
|
|
[Header("Section Header")]
|
|||
|
|
[Tooltip("分类标题预制体，需包含 TMP_Text 组件。")]
|
|||
|
|
[SerializeField] private GameObject sectionHeaderPrefab;
|
|||
|
|
|
|||
|
|
// ──────────────────── Left Content ────────────────────
|
|||
|
|
|
|||
|
|
[Header("Left Content")]
|
|||
|
|
[Tooltip("条目的父容器，应挂载 VerticalLayoutGroup 和 ContentSizeFitter。")]
|
|||
|
|
[SerializeField] private RectTransform contentContainer;
|
|||
|
|
|
|||
|
|
// ──────────────────── Right Panel ─────────────────────
|
|||
|
|
|
|||
|
|
[Header("Right Panel - Description")]
|
|||
|
|
[Tooltip("右侧悬停说明面板，显示条目的标题和说明文本。")]
|
|||
|
|
[SerializeField] private SettingsDescriptionPanel descriptionPanel;
|
|||
|
|
|
|||
|
|
[Header("Right Panel - Detail Pages")]
|
|||
|
|
[Tooltip("键位绑定二级页面。")]
|
|||
|
|
[SerializeField] private KeyBindingPage keyBindingPage;
|
|||
|
|
|
|||
|
|
// ──────────────────── Input ───────────────────────────
|
|||
|
|
|
|||
|
|
[Header("Input")]
|
|||
|
|
[Tooltip("用于键位绑定页面的 InputActionAsset。为空时从 Player 获取。")]
|
|||
|
|
[SerializeField] private InputActionAsset inputActionAsset;
|
|||
|
|
|
|||
|
|
// ──────────────────── 底部按钮 ────────────────────
|
|||
|
|
|
|||
|
|
[Header("Bottom Buttons")]
|
|||
|
|
[SerializeField] private Button resetButton;
|
|||
|
|
[SerializeField] private Button backButton;
|
|||
|
|
|
|||
|
|
// ──────────────────── 运行时状态 ──────────────────
|
|||
|
|
|
|||
|
|
private readonly List<SettingsEntryBase> activeFieldEntries = new();
|
|||
|
|
private readonly List<SettingsEntryButton> activeButtonEntries = new();
|
|||
|
|
private readonly List<GameObject> spawnedObjects = new();
|
|||
|
|
|
|||
|
|
/// <summary>是否有详情页面处于打开状态（抑制悬停说明）。</summary>
|
|||
|
|
private bool isDetailPageOpen;
|
|||
|
|
|
|||
|
|
// ──────────────────── 分类定义 ────────────────────
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 分类定义：显示名称、设置实例、Apply/Reset 回调、附加按钮列表。
|
|||
|
|
/// </summary>
|
|||
|
|
private struct SectionDefinition
|
|||
|
|
{
|
|||
|
|
public string displayName;
|
|||
|
|
public object settingsInstance;
|
|||
|
|
public Action applyAction;
|
|||
|
|
public Action resetAction;
|
|||
|
|
public List<ButtonDefinition> buttons;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 手动添加的按钮条目定义。
|
|||
|
|
/// </summary>
|
|||
|
|
private struct ButtonDefinition
|
|||
|
|
{
|
|||
|
|
public string label;
|
|||
|
|
public string description;
|
|||
|
|
public Action onClick;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ──────────────────── 生命周期 ────────────────────
|
|||
|
|
|
|||
|
|
protected override void Start()
|
|||
|
|
{
|
|||
|
|
base.Start();
|
|||
|
|
|
|||
|
|
resetButton?.onClick.AddListener(OnResetClicked);
|
|||
|
|
backButton?.onClick.AddListener(OnBackClicked);
|
|||
|
|
|
|||
|
|
// 监听详情页面的开关状态
|
|||
|
|
if (keyBindingPage != null)
|
|||
|
|
{
|
|||
|
|
keyBindingPage.PageOpened += OnDetailPageOpened;
|
|||
|
|
keyBindingPage.PageClosed += OnDetailPageClosed;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
protected override void OnPageOpened()
|
|||
|
|
{
|
|||
|
|
BuildAllSections();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
protected override void OnPageClosed()
|
|||
|
|
{
|
|||
|
|
// 先关闭可能打开的详情页面
|
|||
|
|
if (isDetailPageOpen && keyBindingPage != null && keyBindingPage.IsOpen)
|
|||
|
|
keyBindingPage.Close();
|
|||
|
|
|
|||
|
|
ClearAll();
|
|||
|
|
descriptionPanel?.Hide();
|
|||
|
|
GameSettingsManager.Instance?.Save();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ──────────────────── 详情页面状态 ────────────────
|
|||
|
|
|
|||
|
|
private void OnDetailPageOpened()
|
|||
|
|
{
|
|||
|
|
isDetailPageOpen = true;
|
|||
|
|
descriptionPanel?.Hide();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void OnDetailPageClosed()
|
|||
|
|
{
|
|||
|
|
isDetailPageOpen = false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ──────────────────── 悬停回调 ────────────────────
|
|||
|
|
|
|||
|
|
private void HandleHoverEnter(string title, string description)
|
|||
|
|
{
|
|||
|
|
if (isDetailPageOpen) return;
|
|||
|
|
descriptionPanel?.Show(title, description);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void HandleHoverExit()
|
|||
|
|
{
|
|||
|
|
if (isDetailPageOpen) return;
|
|||
|
|
descriptionPanel?.Hide();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ──────────────────── 分类定义构建 ────────────────
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 构建所有分类定义。扩展时在此处追加。
|
|||
|
|
/// </summary>
|
|||
|
|
private List<SectionDefinition> BuildSectionDefinitions()
|
|||
|
|
{
|
|||
|
|
var manager = GameSettingsManager.Instance;
|
|||
|
|
if (manager == null) return null;
|
|||
|
|
|
|||
|
|
return new List<SectionDefinition>
|
|||
|
|
{
|
|||
|
|
new()
|
|||
|
|
{
|
|||
|
|
displayName = "Gameplay",
|
|||
|
|
settingsInstance = manager.gameplay,
|
|||
|
|
applyAction = manager.ApplyGameplay,
|
|||
|
|
resetAction = manager.ResetGameplayToDefault
|
|||
|
|
},
|
|||
|
|
new()
|
|||
|
|
{
|
|||
|
|
displayName = "Graphics",
|
|||
|
|
settingsInstance = manager.graphics,
|
|||
|
|
applyAction = manager.ApplyGraphics,
|
|||
|
|
resetAction = manager.ResetGraphicsToDefault
|
|||
|
|
},
|
|||
|
|
new()
|
|||
|
|
{
|
|||
|
|
displayName = "Sound",
|
|||
|
|
settingsInstance = manager.sound,
|
|||
|
|
applyAction = manager.ApplySound,
|
|||
|
|
resetAction = manager.ResetSoundToDefault
|
|||
|
|
},
|
|||
|
|
new()
|
|||
|
|
{
|
|||
|
|
displayName = "Controls",
|
|||
|
|
settingsInstance = manager.controls,
|
|||
|
|
applyAction = manager.ApplyControls,
|
|||
|
|
resetAction = manager.ResetControlsToDefault,
|
|||
|
|
buttons = new List<ButtonDefinition>
|
|||
|
|
{
|
|||
|
|
new()
|
|||
|
|
{
|
|||
|
|
label = "Key Bindings",
|
|||
|
|
description = "Customize keyboard and mouse bindings for all game actions.",
|
|||
|
|
onClick = OpenKeyBindingPage
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ──────────────────── 条目生成 ────────────────────
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 构建所有分类的标题、字段条目和按钮条目。
|
|||
|
|
/// </summary>
|
|||
|
|
private void BuildAllSections()
|
|||
|
|
{
|
|||
|
|
ClearAll();
|
|||
|
|
|
|||
|
|
var sections = BuildSectionDefinitions();
|
|||
|
|
if (sections == null)
|
|||
|
|
{
|
|||
|
|
Debug.LogError("[SettingsUIPage] GameSettingsManager not found.");
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
foreach (var section in sections)
|
|||
|
|
{
|
|||
|
|
BuildSection(section);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 构建单个分类的标题、字段条目和按钮条目。
|
|||
|
|
/// </summary>
|
|||
|
|
private void BuildSection(SectionDefinition section)
|
|||
|
|
{
|
|||
|
|
FieldInfo[] fields = section.settingsInstance.GetType()
|
|||
|
|
.GetFields(BindingFlags.Public | BindingFlags.Instance);
|
|||
|
|
|
|||
|
|
// 预扫描：确认该分类至少有一个可显示的字段或按钮
|
|||
|
|
bool hasVisibleContent = section.buttons is { Count: > 0 };
|
|||
|
|
|
|||
|
|
if (!hasVisibleContent)
|
|||
|
|
{
|
|||
|
|
foreach (FieldInfo field in fields)
|
|||
|
|
{
|
|||
|
|
if (field.GetCustomAttribute<SettingsIgnoreAttribute>() == null
|
|||
|
|
&& ResolvePrefab(field) != null)
|
|||
|
|
{
|
|||
|
|
hasVisibleContent = true;
|
|||
|
|
break;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (!hasVisibleContent) return;
|
|||
|
|
|
|||
|
|
// 插入分类标题
|
|||
|
|
SpawnSectionHeader(section.displayName);
|
|||
|
|
|
|||
|
|
// 生成字段条目
|
|||
|
|
Action applyAction = section.applyAction;
|
|||
|
|
|
|||
|
|
foreach (FieldInfo field in fields)
|
|||
|
|
{
|
|||
|
|
if (field.GetCustomAttribute<SettingsIgnoreAttribute>() != null)
|
|||
|
|
continue;
|
|||
|
|
|
|||
|
|
GameObject prefab = ResolvePrefab(field);
|
|||
|
|
if (prefab == null)
|
|||
|
|
{
|
|||
|
|
Debug.LogWarning(
|
|||
|
|
$"[SettingsUIPage] No matching prefab for field '{field.Name}' " +
|
|||
|
|
$"(type: {field.FieldType.Name}). Skipping.");
|
|||
|
|
continue;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
GameObject entryObj = Instantiate(prefab, contentContainer);
|
|||
|
|
var entry = entryObj.GetComponent<SettingsEntryBase>();
|
|||
|
|
if (entry == null)
|
|||
|
|
{
|
|||
|
|
Debug.LogError(
|
|||
|
|
$"[SettingsUIPage] Prefab for field '{field.Name}' " +
|
|||
|
|
"is missing a SettingsEntryBase component.");
|
|||
|
|
Destroy(entryObj);
|
|||
|
|
continue;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
entry.Initialize(section.settingsInstance, field, () => applyAction?.Invoke());
|
|||
|
|
RegisterFieldEntryHover(entry);
|
|||
|
|
activeFieldEntries.Add(entry);
|
|||
|
|
spawnedObjects.Add(entryObj);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 生成按钮条目
|
|||
|
|
if (section.buttons != null)
|
|||
|
|
{
|
|||
|
|
foreach (var btnDef in section.buttons)
|
|||
|
|
{
|
|||
|
|
SpawnButtonEntry(btnDef);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 为字段条目注册悬停回调。
|
|||
|
|
/// </summary>
|
|||
|
|
private void RegisterFieldEntryHover(SettingsEntryBase entry)
|
|||
|
|
{
|
|||
|
|
entry.OnHoverEnter = HandleHoverEnter;
|
|||
|
|
entry.OnHoverExit = HandleHoverExit;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 实例化按钮条目。
|
|||
|
|
/// </summary>
|
|||
|
|
private void SpawnButtonEntry(ButtonDefinition def)
|
|||
|
|
{
|
|||
|
|
if (buttonEntryPrefab == null)
|
|||
|
|
{
|
|||
|
|
Debug.LogWarning("[SettingsUIPage] buttonEntryPrefab is not assigned.");
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
GameObject entryObj = Instantiate(buttonEntryPrefab, contentContainer);
|
|||
|
|
var buttonEntry = entryObj.GetComponent<SettingsEntryButton>();
|
|||
|
|
if (buttonEntry == null)
|
|||
|
|
{
|
|||
|
|
Debug.LogError("[SettingsUIPage] buttonEntryPrefab is missing SettingsEntryButton.");
|
|||
|
|
Destroy(entryObj);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
buttonEntry.Initialize(def.label, def.description, def.onClick);
|
|||
|
|
buttonEntry.OnHoverEnter = HandleHoverEnter;
|
|||
|
|
buttonEntry.OnHoverExit = HandleHoverExit;
|
|||
|
|
activeButtonEntries.Add(buttonEntry);
|
|||
|
|
spawnedObjects.Add(entryObj);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 实例化分类标题预制体。
|
|||
|
|
/// </summary>
|
|||
|
|
private void SpawnSectionHeader(string title)
|
|||
|
|
{
|
|||
|
|
if (sectionHeaderPrefab == null)
|
|||
|
|
{
|
|||
|
|
Debug.LogWarning("[SettingsUIPage] sectionHeaderPrefab is not assigned.");
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
GameObject headerObj = Instantiate(sectionHeaderPrefab, contentContainer);
|
|||
|
|
var headerText = headerObj.GetComponentInChildren<TMP_Text>();
|
|||
|
|
if (headerText != null)
|
|||
|
|
headerText.text = title;
|
|||
|
|
|
|||
|
|
spawnedObjects.Add(headerObj);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 根据字段类型选择对应的预制体。
|
|||
|
|
/// </summary>
|
|||
|
|
private GameObject ResolvePrefab(FieldInfo field)
|
|||
|
|
{
|
|||
|
|
Type fieldType = field.FieldType;
|
|||
|
|
|
|||
|
|
if (fieldType == typeof(bool))
|
|||
|
|
return toggleEntryPrefab;
|
|||
|
|
|
|||
|
|
if (fieldType == typeof(int))
|
|||
|
|
return sliderEntryPrefab;
|
|||
|
|
|
|||
|
|
if (fieldType.IsEnum)
|
|||
|
|
return dropdownEntryPrefab;
|
|||
|
|
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ──────────────────── 详情页面入口 ────────────────
|
|||
|
|
|
|||
|
|
private void OpenKeyBindingPage()
|
|||
|
|
{
|
|||
|
|
if (keyBindingPage == null)
|
|||
|
|
{
|
|||
|
|
Debug.LogWarning("[SettingsUIPage] keyBindingPage is not assigned.");
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 优先使用配置的 InputActionAsset，否则尝试从 Player 获取
|
|||
|
|
InputActionAsset asset = inputActionAsset;
|
|||
|
|
if (asset == null)
|
|||
|
|
{
|
|||
|
|
var player = MainGameManager.Player;
|
|||
|
|
if (player != null)
|
|||
|
|
asset = player.inputSc.inputActions.asset;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (asset != null)
|
|||
|
|
{
|
|||
|
|
keyBindingPage.Open(asset);
|
|||
|
|
}
|
|||
|
|
else
|
|||
|
|
{
|
|||
|
|
Debug.LogError("[SettingsUIPage] No InputActionAsset available for KeyBindingPage.");
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ──────────────────── 底部按钮回调 ────────────────
|
|||
|
|
|
|||
|
|
private void OnResetClicked()
|
|||
|
|
{
|
|||
|
|
GameSettingsManager.Instance?.ResetAllToDefault();
|
|||
|
|
BuildAllSections();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void OnBackClicked()
|
|||
|
|
{
|
|||
|
|
Close();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ──────────────────── 清理 ────────────────────────
|
|||
|
|
|
|||
|
|
private void ClearAll()
|
|||
|
|
{
|
|||
|
|
foreach (var obj in spawnedObjects)
|
|||
|
|
{
|
|||
|
|
if (obj != null)
|
|||
|
|
Destroy(obj);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
activeFieldEntries.Clear();
|
|||
|
|
activeButtonEntries.Clear();
|
|||
|
|
spawnedObjects.Clear();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private void OnDestroy()
|
|||
|
|
{
|
|||
|
|
if (keyBindingPage != null)
|
|||
|
|
{
|
|||
|
|
keyBindingPage.PageOpened -= OnDetailPageOpened;
|
|||
|
|
keyBindingPage.PageClosed -= OnDetailPageClosed;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|