GFAssetHandle¶
API Reference / Standard / 类索引
- 路径：
addons/gf/standard/utilities/assets/gf_asset_handle.gd - 模块：
Standard - 继承：
RefCounted - API：
public - 类别：运行时句柄 (
runtime_handle) - 首次版本：
3.17.0
GFAssetUtility 创建的资源所有权句柄。 句柄只表达“某个调用方正在持有某个资源路径”，不规定资源业务语义。 调用 release() 会把引用归还给 GFAssetUtility；句柄释放前，对应缓存路径不会被 LRU 淘汰。
成员概览¶
| 类型 | 名称 | 签名 |
|---|---|---|
| 属性 | path |
var path: String = "" |
| 属性 | type_hint |
var type_hint: String = "" |
| 属性 | group_id |
var group_id: StringName = &"" |
| 属性 | resource |
var resource: Resource = null |
| 方法 | get_resource |
func get_resource() -> Resource: |
| 方法 | get_owner_id |
func get_owner_id() -> int: |
| 方法 | is_released |
func is_released() -> bool: |
| 方法 | is_valid |
func is_valid() -> bool: |
| 方法 | release |
func release() -> bool: |
属性¶
path¶
- API：
public
资源路径。
type_hint¶
- API：
public
请求时使用的类型提示。
group_id¶
- API：
public
可选资源分组。
resource¶
- API：
public
资源实例。
方法¶
get_resource¶
- API：
public
获取资源实例。
返回：资源实例；句柄已释放时返回 null。
get_owner_id¶
- API：
public
获取拥有者实例 ID。
返回：拥有者实例 ID；未绑定 owner 时为 0。
is_released¶
- API：
public
检查句柄是否已释放。
返回：已释放返回 true。
is_valid¶
- API：
public
检查句柄当前是否仍能访问资源。
返回：可访问资源返回 true。
release¶
- API：
public
释放句柄持有的资源引用。
返回：成功释放返回 true。