崩坏：星穹铁道 抽卡记录导入导出格式

[LaoshuBaby]

目前收集到的项目有如下：

• DancingSnow0517/StarRail-gacha
• TremblingMoeNew/StarRailWarpObserve
• Scighost/StarRailTool
• cntvc/star-rail-tools
• vikiboss/star-rail-gacha-export
• lgou2w/HoYo.Gacha
• BoxCatTeam/SRCat
• biuuu/star-rail-warp-export

[TremblingMoeNew]

熟人？但怎么某游群里找不到你了
要搞统一格式的话，我的建议是直接放弃Excel导入，只用JSON。
Excel导出是用来给人看的，不是给程序看的

StaRWO（咦这么缩写挺顺口的，以后就叫它STARWO了.jpg）目前设计的导出格式（还没Release）大致基于UIGF.J V2.1，info里增加game（值仅为Honkai_Star_Rail）、game_biz（hkrpg_cn和hkrpg_global）以及region_time_zone，记录项那边就是敲掉uid和lang的原始数据。uigf_gacha_type的类似物还没加上，最终名字不确定嘛。

[DancingSnow0517]

uigf_gacha_type我觉得直接用原来的字符串数字？1，2，11，12？
以及我认为uid可以保留

[TremblingMoeNew]

uigf_gacha_type我觉得直接用原来的字符串数字？1，2，11，12？

问题在“uigf”前缀不在值上(

毕竟只是给自己的软件整的导出格式，uigf毕竟目前只是个原神的祈愿记录导出格式标准

以及我认为uid可以保留

info里有uid和lang啊

[TremblingMoeNew]

我的看法：

1. 仅保留JSON格式标准，放弃用Excel进行数据交换
2. info部分和UIGF.J v2.1一样放上uid、lang、export_time、export_timestamp、export_app、export_app_version，以及一个标识协议版本号的uigf_version。标记用户时区的region_time_zone有加入的必要。个人建议把game_biz也加进去。
3. 跃迁记录项就还是除uid和lang外的原始数据，gacha_id，gacha_type，item_id、count、time、name、item_type，rank_type，id，这几项全部保留原始数据，不作任何改动。和UIGF.J v2.1一样向记录项中注入uigf_gacha_type，以备双池子之需。如果要和UIGF.J v2.3一样考虑item_type的国际化问题，我认为应该注入新的uigf_item_type属性而不是修改原始数据，或者在UIGF翻译API里直接把item_id对应的item_type发下去不就完了
4. 有在info部分加入游戏标识以及协议标识的必要（其中uigf_version已经在一定程度上起到了后者的作用）。万一有人拿原的UIGF甚至UIAF往星铁的工具里导入呢2333333，而且也需要考虑同时兼容两个游戏的工具的识别问题。加个game还是很有必要的。

@Lightczx @DancingSnow0517 @biuuu @Scighost @cntvc @vikiboss @lgou2w @Masterain98

[TremblingMoeNew]

所以卡池类型目前有对应的id么

gacha_type还是，1是常驻2是新手11是角色12是光锥

我刚才说的是gacha_id。主要是不知道如果开双池子，那会是同样的type不同的id还是连type都和原神一样换了

[TremblingMoeNew]

所以卡池类型目前有对应的id么

应该是有的，api有返回个gacha_id，到时候就看看景元池这个是啥

……你用的gacha_id区分的？

[DancingSnow0517]

所以卡池类型目前有对应的id么

应该是有的，api有返回个gacha_id，到时候就看看景元池这个是啥

……你用的gacha_id区分的？

那肯定是gacha_type, gacha_id以后可以用去每个卡池的抽卡分析吧

[MoRanYue]

所以卡池类型目前有对应的id么

应该是有的，api有返回个gacha_id，到时候就看看景元池这个是啥

……你用的gacha_id区分的？

那肯定是gacha_type, gacha_id以后可以用去每个卡池的抽卡分析吧

gacha_id竟然有用，我还以为它没用呢

[AuroraZiling]

有关gacha_id:

{
      "count": "1",
      "gacha_id": "2003",
      "gacha_type": "11",
      "id": "1682845800003953620",
      "item_id": "1102",
      "item_type": "角色",
      "name": "希儿",
      "rank_type": "5",
      "time": "2023-04-30 17:18:41",
      "uigf_gacha_type": "11"
},
{
      "count": "1",
      "gacha_id": "2004",
      "gacha_type": "11",
      "id": "1684318200015555520",
      "item_id": "1204",
      "item_type": "角色",
      "name": "景元",
      "rank_type": "5",
      "time": "2023-05-17 18:01:06",
      "uigf_gacha_type": "11"
}

[Lightczx]

新 spec 就叫 SRGF 吧
谁赞成，谁反对？

[cntvc]

赞同 SRGF

[LaoshuBaby]

Star Rail Gacha Format?

Star Rail GachaLog Format

对标 Uniformed Interchangeable GachaLog Format

那“UI”就会显得很名不副实，明明只是原的格式，却顶上了Uniformed的字样，在只有原的时候自然没啥问题

[cntvc]

1. 格式缩写应该尽量简洁明了，6个字母稍微有点长
2. UI 字母我认为去掉也不影响他的语义和实际作用，推动让各个程序都接受的话自然就是 UI 了

[Masterain98]

其实具体标准的名称是随意的，可以把 UIGF-Org 中的 G 理解为 Game 就好了（

[zzpro]

SRGF，可行

[TremblingMoeNew]

region有没有保留的需要🤔

[cntvc]

@TremblingMoeNew 请问 region_time_zone 是具体有什么作用呢，和 game_biz 有映射关系吗？

如果不从抽卡链接返回的结果拿这个值，是否可以从其他方式获取或者生成呢？

[DancingSnow0517]

@TremblingMoeNew 请问 region_time_zone 是具体有什么作用呢，和 game_biz 有映射关系吗？

如果不从抽卡链接返回的结果拿这个值，是否可以从其他方式获取或者生成呢？

api给的time是一个格式化的时间字符串，而且没有时区信息，需要region_time_zone来得到正确的时间戳，以免出现时间错位

[TremblingMoeNew]

@TremblingMoeNew 请问 region_time_zone 是具体有什么作用呢，和 game_biz 有映射关系吗？

region_time_zone标识了用户所属服务器的时区。跃迁记录项里的time就是按服务器时间来的。在需要对跃迁记录项时间进行时区转换时就用上了比如我的就依赖时区数据。与game_biz没有映射关系，hkrpg_global又不是一个服务器，是好几个。

[DancingSnow0517]

@TremblingMoeNew 请问 region_time_zone 是具体有什么作用呢，和 game_biz 有映射关系吗？

region_time_zone标识了用户所属服务器的时区。跃迁记录项里的time就是按服务器时间来的。在需要对跃迁记录项时间进行时区转换时就用上了比如我的就依赖时区数据。与game_biz没有映射关系，hkrpg_global又不是一个服务器，是好几个。

我的也依赖了时区数据，不然时间的换算有点麻烦（

[cntvc]

服务器间和本地可能不一致，所以需要还需要时区信息来转换为本地时间，这样理解可以吗

[Masterain98]

UIGF API 生成的星轨数据预览

uigf_dict_sql.zip
uigf_dict_json.zip

[Lightczx]

目前我建议的格式：

{
  "info": {
    "uid": "xxxxxxxxx",
    "lang": "zh-cn",
    "region_time_zone": "xxxx",
    "export_timestamp": 1684124992,
    "export_app": "xxx",
    "export_app_version": "xxxxx",
    "srgf_version": "v1.0"
  },
  "list": [
    {
      "gacha_id": "2003",
      "gacha_type": "200",
      "item_id": "10000065",
      "count": "1",
      "time": "2023-05-07 10:47:00",
      "name": "xxx",
      "item_type": "xxxx",
      "rank_type": "4",
      "id": "1683425160001357994"
    }
  ]
}

类似 srgf_gacha_type的字段暂时不添加吧

[TremblingMoeNew]

region_time_zone 我认为应该加进info里

[Lightczx]

region_time_zone 我认为应该加进info里

加了

[Bill-Haku]

插个眼，我们的App 星铁披萨小助手 / HSR Pizza Helper也会支持新标准

[AuroraZiling]

++插个眼，star-rail-asta项目也支持

[Lightczx]

@UIGF-org/srgf-update-audience UIGF-org/UIGF-org.github.io#16

[Lightczx]

https://uigf.org/standards/SRGF.html