76 lines
2.4 KiB
C#
76 lines
2.4 KiB
C#
|
using Sirenix.OdinInspector;
|
|||
|
|
using UnityEngine;
|
|||
|
|
|
|||
|
|
namespace SLSUtilities.Narrative
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 通用剧情触发器基类。
|
|||
|
|
/// 仅负责管理触发状态（oneShot, hasFired）与全局故事 ID（storyId）。
|
|||
|
|
/// 具体触发的时机与条件由派生类（子类）自行重写并定义。
|
|||
|
|
/// </summary>
|
|||
|
|
public abstract class NarrativeTrigger : MonoBehaviour
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 全局静态触发事件。当任何剧情触发器被激活时触发。
|
|||
|
|
/// 用于彻底解耦 SLSUtilities 核心程序集与 MainGame 层的 StoryDirector。
|
|||
|
|
/// </summary>
|
|||
|
|
public static System.Action<string> OnNarrativeTriggerFired;
|
|||
|
|
|
|||
|
|
[TitleGroup("Trigger Settings", "剧情触发器核心配置", Alignment = TitleAlignments.Centered)]
|
|||
|
|
|
|||
|
|
[SerializeField]
|
|||
|
|
[Required]
|
|||
|
|
[Tooltip("要触发的 NarrativeEntry 的 storyId")]
|
|||
|
|
protected string storyId;
|
|||
|
|
|
|||
|
|
[SerializeField]
|
|||
|
|
[Tooltip("是否仅能触发一次")]
|
|||
|
|
protected bool oneShot = true;
|
|||
|
|
|
|||
|
|
[ShowInInspector]
|
|||
|
|
[ReadOnly]
|
|||
|
|
[Tooltip("该触发器当前是否已经激活过")]
|
|||
|
|
protected bool hasFired;
|
|||
|
|
|
|||
|
|
/// <summary>获取触发的目标故事 ID。</summary>
|
|||
|
|
public string StoryId => storyId;
|
|||
|
|
|
|||
|
|
/// <summary>是否是一次性触发器。</summary>
|
|||
|
|
public bool OneShot => oneShot;
|
|||
|
|
|
|||
|
|
/// <summary>该触发器是否已经激活过。</summary>
|
|||
|
|
public bool HasFired => hasFired;
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 激活触发器，通知订阅者启动剧情。
|
|||
|
|
/// </summary>
|
|||
|
|
[Button("测试触发 (Fire)", ButtonSizes.Small)]
|
|||
|
|
[GUIColor(0.3f, 0.8f, 1f)]
|
|||
|
|
public virtual void Fire()
|
|||
|
|
{
|
|||
|
|
if (oneShot && hasFired)
|
|||
|
|
{
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (string.IsNullOrEmpty(storyId))
|
|||
|
|
{
|
|||
|
|
Debug.LogWarning($"[NarrativeTrigger] {gameObject.name} 触发失败：未配置 storyId。");
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
hasFired = true;
|
|||
|
|
OnNarrativeTriggerFired?.Invoke(storyId);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 重置触发状态（允许在 oneShot 模式下重新触发）。
|
|||
|
|
/// </summary>
|
|||
|
|
[Button("重置激活状态 (Reset)", ButtonSizes.Small)]
|
|||
|
|
public virtual void ResetTrigger()
|
|||
|
|
{
|
|||
|
|
hasFired = false;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|