GFScenePreloadEntry¶
API Reference / Standard / 类索引
- 路径：
addons/gf/standard/utilities/scene/gf_scene_preload_entry.gd - 模块：
Standard - 继承：
Resource - API：
public - 类别：资源定义 (
resource_definition) - 首次版本：
3.17.0
场景预加载图谱中的单个节点。 描述一个场景与相邻场景的关系，以及该场景是否应进入固定缓存。 它只表达资源关系，不假设关卡、地图、菜单或玩法语义。
成员概览¶
| 类型 | 名称 | 签名 |
|---|---|---|
| 属性 | scene_path |
var scene_path: String = "" |
| 属性 | adjacent_scene_paths |
var adjacent_scene_paths: PackedStringArray = PackedStringArray() |
| 属性 | fixed |
var fixed: bool = false |
| 属性 | metadata |
var metadata: Dictionary = {} |
| 方法 | get_scene_path |
func get_scene_path() -> String: |
| 方法 | get_adjacent_scene_paths |
func get_adjacent_scene_paths() -> PackedStringArray: |
| 方法 | describe_entry |
func describe_entry() -> Dictionary: |
属性¶
scene_path¶
- API：
public
当前场景资源路径。
adjacent_scene_paths¶
- API：
public
与当前场景相邻、可能被提前预热的场景资源路径。
fixed¶
- API：
public
是否建议将该场景放入固定缓存。
metadata¶
- API：
public
项目自定义元数据。框架不解释该字段。
结构：
metadata: Dictionary[String, Variant]，会复制到 describe_entry() 结果中。
方法¶
get_scene_path¶
- API：
public
获取规范化后的场景路径。
返回：去除首尾空白后的场景路径。
get_adjacent_scene_paths¶
- API：
public
获取去重后的相邻场景路径。
返回：相邻场景路径列表。
describe_entry¶
- API：
public
描述当前条目。
返回：条目描述字典。
结构：
return: Dictionary，包含 scene_path、adjacent_scene_paths、fixed 和 metadata。