统一可交换祈愿记录标准 v2.2

Uniformed Interchangeable GachaLog Format standard (UIGF)

前言

由于原神的祈愿卡池与记录越来越多，越来越复杂，各个App间进行数据交换的代价越来越大，于是 我们

• biuuu/genshin wish export
• DGP Studio/Snap.Genshin
• Scighost/KeqingNiuza
• sunfkny/genshin gacha export
• TremblingMoeNew/DodocoTales
• voderl/genshin gacha analyzer

（上述名称以字典顺序排序，不代表其他任何意义）
在此一起，制定了此项标准，旨在加强各个原神相关的App间的数据可交换性
如果今后出现了新的需要在各App间交换的数据，我们也会进行规范

注意事项

在采用此格式时，需要特别注意某些字段名称中可能存在的下划线 _ 或空格字符
此格式仅适用于简体中文环境

Id

原神的祈愿记录物品内包含了一项较为特殊的字段: id ，该值在 1.3版本后加入
所以先前查询出的物品若无特殊兼容性修改则不会包含相应的 id
导出时

• 需要确保每个物品的 id 的有效性。
• 推荐从最后一个自带有效 id 的物品开始，向前（相对于时间）依次递减 id 的值,每次递减的值应保持为 1
• 生成的 id 值不应大于 1612303200000000000
• App不应假设所有的 gacha_item 都有有效的 id 值
• App应具有处理 id 字段为 null或 `` 空字符串的能力

GachaType

祈愿包含了会共享保底与概率的卡池，所以需要一个额外的字段来界定
我们在UIGF的所有格式中注入了uigf_gacha_type字段
在导出到UIGF格式时需要注意添加对应的uigf_gacha_type字段

uigf_gacha_type 映射关系

Excel 工作簿 (Workbook Format)

Uniformed Interchangeable GachaLog Format standard of Workbook (UIGF.W)

文件的名称

我们建议：

• 在名称中包含导出数据所属用户的 uid
• 用户在导出操作发生前应具有修改文件名称的权力

单元格的格式

• 在填充单元格内的数据时，应统一转换到String字符串类型后填入

表名及内容

• 表的顺序可以是任意的
• 可以隐藏部分表，防止用户随意篡改数据
• Sheet 的名称应与游戏内祈愿记录页面显示的名称保持一致

App间应依据 原始数据表 的内容，来进行数据互通

祈愿表结构

本节内容是为了规范兼容分析类App

• 表头对应的内容填充顺序需要严格按照下方说明排布
• 共享保底的卡池按祈愿类型 (gacha_type) 区分
• 此类 Sheet 存在的目的，是为了便于用户观看与祈愿分析工具的分析

如果你认为有必要的话，可以额外增加其他表头，但请确保表头的前几列为上表规范的内容
表内的数据通常按祈愿Id升序或降序排列，分析App不应假设表内的顺序为特定的升序与降序

gacha_type 转义名称

示例

原始数据表结构

导出时

• App 在导出时应尽可能询问用户是否应包含原始数据表
• 一旦在工作簿内包含了名为 原始数据 的表，即表示支持本格式
• 该表内的内容应严格按照本格式所述填充
• 表头的顺序需严格按照下表设置。
• 现有的字段采用字典顺序递增排序，后续新增的字段依添加的顺序排在后侧。
• 若无特殊需求，我们建议导出所有json 数据内包含的字段

导入时

• 强烈建议您编写不依赖于列的顺序位置便可实现导入的程序，以达到最大化的兼容。
• 如果省略了其中某些非必要字段的值，请保持表头存在，对应的列则空置。

示例

Json 格式

Uniformed Interchangeable GachaLog Format standard of Json (UIGF.J)

Json 格式 由于 与从官方接口获取到的格式一致
更便于各App的导入与导出，我们也在此做出规范
该格式应仅用于各App间的数据互通

导出的格式

以同值字段提取至上层的思想，我们拟定了以下json格式

{
    "info" : {
        "uid" : "000000000",
        "lang" : "zh-cn",
        ...
    },
    "list" : [
        {
            "gacha_type": "000",
            "item_id": "",
            "count": "1",
            "time": "yyyy-MM-dd HH:mm:ss",
            "name": "以理服人",
            "item_type": "武器",
            "rank_type": "3",
            "id": "1600099200004770203",
            "uigf_gacha_type": "000",
        },
        ...
    ]
}

info

除了从 {gacha_item} 中提取的 uid,lang字段，还可以包含我们认可的以下字段

uigf_version

合法值

export_app

未实现导出支持的以 - 代替