GFDeterministicVariantSerializer¶

路径：addons/gf/standard/foundation/deterministic/gf_deterministic_variant_serializer.gd
模块：Standard
继承：RefCounted
API：public
类别：运行时服务 (runtime_service)
首次版本：5.0.0

纯 Variant 数据的确定性规范编码器。该类型为锁步、回放、黄金测试和内容 hash 提供稳定的 canonical value、JSON、 UTF-8 bytes 与 SHA-256。它不读取文件，不处理存档 metadata、压缩、混淆或对象图。

成员概览¶

类型	名称	签名
方法	`to_canonical_value`	`static func to_canonical_value(value: Variant, options: Dictionary = {}) -> Variant:`
方法	`to_canonical_json`	`static func to_canonical_json(value: Variant, options: Dictionary = {}) -> String:`
方法	`to_canonical_bytes`	`static func to_canonical_bytes(value: Variant, options: Dictionary = {}) -> PackedByteArray:`
方法	`sha256`	`static func sha256(value: Variant, options: Dictionary = {}) -> String:`

static func to_canonical_value(value: Variant, options: Dictionary = {}) -> Variant:

将 Variant 转换为 JSON 兼容的规范值。

参数：

名称	说明
`value`	待编码的 Variant。应为纯数据结构；Object、Resource、Callable、RID 和循环引用会失败。
`options`	可选项。`allow_floats` 默认为 false；`max_depth` 默认为 256。

返回：规范化后的 JSON 兼容 Variant；失败时返回 null 并输出错误。

结构：

value: Variant value made from nil, bool, int, String, StringName, NodePath, integer vectors, arrays, dictionaries and packed scalar arrays. Float-based values require options.allow_floats = true.
options: Dictionary with optional allow_floats: bool and max_depth: int.
return: Typed marker Dictionary using __gf_deterministic_variant__, or null when unsupported input is detected.

static func to_canonical_json(value: Variant, options: Dictionary = {}) -> String:

将 Variant 编码为规范 JSON 文本。

参数：

名称	说明
`value`	待编码的 Variant。
`options`	可选项。

返回：规范 JSON 文本；失败时返回空字符串。

结构：

static func to_canonical_bytes(value: Variant, options: Dictionary = {}) -> PackedByteArray:

将 Variant 编码为规范 UTF-8 字节。

参数：

名称	说明
`value`	待编码的 Variant。
`options`	可选项。

返回：规范 JSON 文本的 UTF-8 bytes；失败时返回空数组。

结构：

static func sha256(value: Variant, options: Dictionary = {}) -> String:

计算 Variant 规范编码的 SHA-256。

参数：

名称	说明
`value`	待编码的 Variant。
`options`	可选项。

返回：SHA-256 hex 字符串；失败时返回空字符串。

结构：