Skip to content

Commit b1e2ace

Browse files
BTMuliBTMuli
committed
📝 更新备份文档
1 parent 9be8c78 commit b1e2ace

1 file changed

Lines changed: 209 additions & 33 deletions

File tree

‎docs/standards/UIGF.md‎

Lines changed: 209 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -2,29 +2,31 @@
22
Author: 目棃
33
Description: UIGF v4 Backup
44
Date: 2024-11-11
5-
Update: 2024-11-11
5+
Update: 2026-02-07
66
---
77

88
> 本文档 [`Frontmatter`](https://github.com/BTMuli/MuCli#Frontmatter) 由 [MuCli](https://github.com/BTMuli/Mucli) 自动生成于 `2024-11-11 11:57:27`
99
>
10-
> 更新于 `2024-11-11 11:57:27`
10+
> 更新于 `2026-02-07 21:29:27`
1111
12-
> 本文档为 [UIGF v4.0](https://github.com/UIGF-org/UIGF-org.github.io/blob/main/docs/zh/standards/uigf.md) 的备份，仅供参考。
12+
> 本文档为 [UIGF v4.2](https://github.com/UIGF-org/UIGF-org.github.io/blob/main/docs/zh/standards/uigf.md) 的备份，仅供参考。
1313
14-
# 统一可交换抽卡记录标准 v4.0
15-
16-
> Uniformed Interchangeable GachaLog Format standard (UIGF) v4.0 <Badge text="Current" type="message" />
14+
# 统一可交换抽卡记录标准 v4.2
15+
> Uniformed Interchangeable GachaLog Format standard (UIGF) v4.2 <Badge text="Current" type="message" />
1716
1817
::: warning 中断性更新警告
1918
`UIGF v4.0 及更高版本` 对于 `UIGF v3.0 及更低版本` 和 `SRGF v1.0` **不具备向下兼容性**。UIGF/SRGF 合作项目如需适配，需重新认证。
2019
:::
2120

2221
## 更新记录
22+
| 版本 | 说明 | 兼容 |
23+
|--------|-----------------------------|------------|
24+
| `v3.0` | 低版本的更新日志请查看历史版本 | v3.0 及更低版本 |
25+
| `v4.0` | 合并 SRGF，新增绝区零抽卡格式支持 | v4.0 |
26+
| `v4.1` | 新增对星穹铁道 v3.4 版所引入的新的卡池类型的支持 | v4.1/v4.0* |
27+
| `v4.2` | 新增对于千星奇域的支持 | v4.1 |
2328

24-
| 版本 | 说明 | 兼容 |
25-
| ------ | --------------------------------- | --------------- |
26-
| `v3.0` | 低版本的更新日志请查看历史版本 | v3.0 及更低版本 |
27-
| `v4.0` | 合并 SRGF，新增绝区零抽卡格式支持 | v4.0 |
29+
* 对于无需处理星穹铁道的应用，v4.1 与 v4.0 兼容。
2830

2931
## 前言
3032

@@ -77,19 +79,24 @@ Update: 2024-11-11
7779
},
7880
"export_app": {
7981
"type": "string",
80-
"description": "导出档案的 App 名称"
82+
"description": "导出档案的应用名称"
8183
},
8284
"export_app_version": {
8385
"type": "string",
84-
"description": "导出档案的 App 版本"
86+
"description": "导出档案的应用版本"
8587
},
8688
"version": {
8789
"type": "string",
8890
"pattern": "^v\\d+\\.\\d+$",
8991
"description": "导出档案的 UIGF 版本号，格式为 'v{major}.{minor}'，如 v4.0"
9092
}
9193
},
92-
"required": ["export_timestamp", "export_app", "export_app_version", "version"]
94+
"required": [
95+
"export_timestamp",
96+
"export_app",
97+
"export_app_version",
98+
"version"
99+
]
93100
},
94101
"hk4e": {
95102
"type": "array",
@@ -140,12 +147,25 @@ Update: 2024-11-11
140147
"uigf_gacha_type": {
141148
"type": "string",
142149
"description": "UIGF 卡池类型，用于区分卡池类型不同，但卡池保底计算相同的物品",
143-
"enum": ["100", "200", "301", "302", "500"]
150+
"enum": [
151+
"100",
152+
"200",
153+
"301",
154+
"302",
155+
"500"
156+
]
144157
},
145158
"gacha_type": {
146159
"type": "string",
147160
"description": "卡池类型，米哈游 API 返回",
148-
"enum": ["100", "200", "301", "302", "400", "500"]
161+
"enum": [
162+
"100",
163+
"200",
164+
"301",
165+
"302",
166+
"400",
167+
"500"
168+
]
149169
},
150170
"item_id": {
151171
"type": "string",
@@ -157,7 +177,8 @@ Update: 2024-11-11
157177
},
158178
"time": {
159179
"type": "string",
160-
"description": "抽取物品时对应时区（timezone）下的当地时间"
180+
"description": "抽取物品时对应时区（timezone）下的当地时间",
181+
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
161182
},
162183
"name": {
163184
"type": "string",
@@ -173,14 +194,27 @@ Update: 2024-11-11
173194
},
174195
"id": {
175196
"type": "string",
176-
"description": "记录内部 ID，米哈游 API 返回"
197+
"description": "记录内部 ID，米哈游 API 返回",
198+
"maxLength": 19,
199+
"minLength": 1,
200+
"pattern": "^[0-9]+$"
177201
}
178202
},
179-
"required": ["uigf_gacha_type", "gacha_type", "item_id", "time", "id"]
203+
"required": [
204+
"uigf_gacha_type",
205+
"gacha_type",
206+
"item_id",
207+
"time",
208+
"id"
209+
]
180210
}
181211
}
182212
},
183-
"required": ["uid", "timezone", "list"]
213+
"required": [
214+
"uid",
215+
"timezone",
216+
"list"
217+
]
184218
}
185219
},
186220
"hkrpg": {
@@ -231,12 +265,19 @@ Update: 2024-11-11
231265
"properties": {
232266
"gacha_id": {
233267
"type": "string",
234-
"description": "卡池 Id"
268+
"description": "卡池 ID"
235269
},
236270
"gacha_type": {
237271
"type": "string",
238272
"description": "卡池类型",
239-
"enum": ["1", "2", "11", "12"]
273+
"enum": [
274+
"1",
275+
"2",
276+
"11",
277+
"12",
278+
"21",
279+
"22"
280+
]
240281
},
241282
"item_id": {
242283
"type": "string",
@@ -248,7 +289,8 @@ Update: 2024-11-11
248289
},
249290
"time": {
250291
"type": "string",
251-
"description": "抽取物品时对应时区（timezone）下的当地时间"
292+
"description": "抽取物品时对应时区（timezone）下的当地时间",
293+
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
252294
},
253295
"name": {
254296
"type": "string",
@@ -264,14 +306,27 @@ Update: 2024-11-11
264306
},
265307
"id": {
266308
"type": "string",
267-
"description": "记录内部 ID，米哈游 API 返回"
309+
"description": "记录内部 ID，米哈游 API 返回",
310+
"maxLength": 19,
311+
"minLength": 1,
312+
"pattern": "^[0-9]+$"
268313
}
269314
},
270-
"required": ["gacha_type", "gacha_id", "time", "item_id", "id"]
315+
"required": [
316+
"gacha_type",
317+
"gacha_id",
318+
"time",
319+
"item_id",
320+
"id"
321+
]
271322
}
272323
}
273324
},
274-
"required": ["uid", "timezone", "list"]
325+
"required": [
326+
"uid",
327+
"timezone",
328+
"list"
329+
]
275330
}
276331
},
277332
"nap": {
@@ -322,12 +377,17 @@ Update: 2024-11-11
322377
"properties": {
323378
"gacha_id": {
324379
"type": "string",
325-
"description": "卡池 Id"
380+
"description": "卡池 ID"
326381
},
327382
"gacha_type": {
328383
"type": "string",
329384
"description": "卡池类型",
330-
"enum": ["1", "2", "3", "5"]
385+
"enum": [
386+
"1",
387+
"2",
388+
"3",
389+
"5"
390+
]
331391
},
332392
"item_id": {
333393
"type": "string",
@@ -339,7 +399,8 @@ Update: 2024-11-11
339399
},
340400
"time": {
341401
"type": "string",
342-
"description": "抽取物品时对应时区（timezone）下的当地时间"
402+
"description": "抽取物品时对应时区（timezone）下的当地时间",
403+
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
343404
},
344405
"name": {
345406
"type": "string",
@@ -355,17 +416,132 @@ Update: 2024-11-11
355416
},
356417
"id": {
357418
"type": "string",
358-
"description": "记录内部 ID，米哈游 API 返回"
419+
"description": "记录内部 ID，米哈游 API 返回",
420+
"maxLength": 19,
421+
"minLength": 1,
422+
"pattern": "^[0-9]+$"
359423
}
360424
},
361-
"required": ["gacha_type", "item_id", "time", "id"]
425+
"required": [
426+
"gacha_type",
427+
"item_id",
428+
"time",
429+
"id"
430+
]
362431
}
363432
}
364433
},
365-
"required": ["uid", "timezone", "list"]
434+
"required": [
435+
"uid",
436+
"timezone",
437+
"list"
438+
]
366439
}
440+
},
441+
"hk4e_ugc": {
442+
"type": "array",
443+
"properties": {
444+
"uid": {
445+
"oneOf": [
446+
{
447+
"type": "string"
448+
},
449+
{
450+
"type": "integer"
451+
}
452+
],
453+
"description": "UID"
454+
},
455+
"timezone": {
456+
"type": "integer",
457+
"description": "时区偏移，由米哈游 API 返回，若与服务器时区不同请注意 list 中 time 的转换"
458+
},
459+
"lang": {
460+
"type": "string",
461+
"description": "语言代码",
462+
"enum": [
463+
"de-de",
464+
"en-us",
465+
"es-es",
466+
"fr-fr",
467+
"id-id",
468+
"it-it",
469+
"ja-jp",
470+
"ko-kr",
471+
"pt-pt",
472+
"ru-ru",
473+
"th-th",
474+
"tr-tr",
475+
"vi-vn",
476+
"zh-cn",
477+
"zh-tw"
478+
]
479+
},
480+
"list": {
481+
"type": "array",
482+
"items": {
483+
"type": "object",
484+
"properties": {
485+
"id": {
486+
"type": "string",
487+
"description": "记录内部 ID，米哈游 API 返回",
488+
"maxLength": 19,
489+
"minLength": 1,
490+
"pattern": "^[0-9]+$"
491+
},
492+
"schedule_id": {
493+
"type": "string",
494+
"description": "卡池排期 ID，米哈游 API 返回",
495+
"minLength": 1,
496+
"pattern": "^[0-9]+$"
497+
},
498+
"item_type": {
499+
"type": "string",
500+
"description": "物品类型，米哈游 API 返回"
501+
},
502+
"item_id": {
503+
"type": "string",
504+
"description": "物品 ID，米哈游 API 返回",
505+
"minLength": 1,
506+
"pattern": "^[0-9]+$"
507+
},
508+
"item_name": {
509+
"type": "string",
510+
"description": "物品名称，米哈游 API 返回"
511+
},
512+
"rank_type": {
513+
"type": "string",
514+
"description": "物品等级，米哈游 API 返回",
515+
"minLength": 1,
516+
"pattern": "^[0-9]+$"
517+
},
518+
"time": {
519+
"type": "string",
520+
"description": "抽取物品时对应时区（timezone）下的当地时间",
521+
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
522+
},
523+
"op_gacha_type": {
524+
"type": "string",
525+
"description": "卡池类型，米哈游 API 返回",
526+
"enum": [
527+
"1000",
528+
"2000",
529+
"20011",
530+
"20012",
531+
"20021",
532+
"20022"
533+
]
534+
}
535+
},
536+
"required": ["id","schedule_id","item_type","item_id","item_name","rank_type","time","op_gacha_type"]
537+
}
538+
}
539+
},
540+
"required": ["uid", "timezone", "list"]
367541
}
368542
},
369-
"required": ["info"]
543+
"required": [
544+
"info"
545+
]
370546
}
371-
```
547+
```

0 commit comments

Comments
 (0)