API 参考 / capability 包：服务、状态与游玩访问

StoryNode

剧情节点只读视图，由 StoryAccess.currentNode() 返回，用于判断当前剧情进度。

方法速览

java

public interface StoryNode {

    String id();

    String title();

    boolean isActive();
}

签名：

java

String id();

行为：节点唯一标识（即剧情场景正在播放的故事 id）。

示例：

java

String id = node.id();

签名：

java

String title();

行为：节点标题（宿主取自剧情场景当前节点的标题文本）。只有 currentNode() 返回的节点才有意义。

示例：

java

ctx.getLogger().info(node.title());

签名：

java

boolean isActive();

行为：是否当前激活。宿主实现中对 currentNode() 返回的视图恒为 true。

示例：

java

if (node.isActive()) {
    // 正在播放
}

线程：只读视图，源码未声明额外线程约束。

稳定性：2.0 起冻结：2.x 内只增不破。