mirror of
https://github.com/BTMuli/TeyvatGuide.git
synced 2026-03-15 03:53:16 +08:00
📝 更新备份文档
This commit is contained in:
BTMuli
@@ -2,29 +2,31 @@
|
||||
Author: 目棃
|
||||
Description: UIGF v4 Backup
|
||||
Date: 2024-11-11
|
||||
Update: 2024-11-11
|
||||
Update: 2026-02-07
|
||||
---
|
||||
|
||||
> 本文档 [`Frontmatter`](https://github.com/BTMuli/MuCli#Frontmatter) 由 [MuCli](https://github.com/BTMuli/Mucli) 自动生成于 `2024-11-11 11:57:27`
|
||||
>
|
||||
> 更新于 `2024-11-11 11:57:27`
|
||||
> 更新于 `2026-02-07 21:29:27`
|
||||
|
||||
> 本文档为 [UIGF v4.0](https://github.com/UIGF-org/UIGF-org.github.io/blob/main/docs/zh/standards/uigf.md) 的备份，仅供参考。
|
||||
> 本文档为 [UIGF v4.2](https://github.com/UIGF-org/UIGF-org.github.io/blob/main/docs/zh/standards/uigf.md) 的备份，仅供参考。
|
||||
|
||||
# 统一可交换抽卡记录标准 v4.0
|
||||
|
||||
> Uniformed Interchangeable GachaLog Format standard (UIGF) v4.0 <Badge text="Current" type="message" />
|
||||
# 统一可交换抽卡记录标准 v4.2
|
||||
> Uniformed Interchangeable GachaLog Format standard (UIGF) v4.2 <Badge text="Current" type="message" />
|
||||
|
||||
::: warning 中断性更新警告
|
||||
`UIGF v4.0 及更高版本` 对于 `UIGF v3.0 及更低版本` 和 `SRGF v1.0` **不具备向下兼容性**。UIGF/SRGF 合作项目如需适配，需重新认证。
|
||||
:::
|
||||
|
||||
## 更新记录
|
||||
| 版本 | 说明 | 兼容 |
|
||||
|--------|-----------------------------|------------|
|
||||
| `v3.0` | 低版本的更新日志请查看历史版本 | v3.0 及更低版本 |
|
||||
| `v4.0` | 合并 SRGF，新增绝区零抽卡格式支持 | v4.0 |
|
||||
| `v4.1` | 新增对星穹铁道 v3.4 版所引入的新的卡池类型的支持 | v4.1/v4.0* |
|
||||
| `v4.2` | 新增对于千星奇域的支持 | v4.1 |
|
||||
|
||||
| 版本 | 说明 | 兼容 |
|
||||
| ------ | --------------------------------- | --------------- |
|
||||
| `v3.0` | 低版本的更新日志请查看历史版本 | v3.0 及更低版本 |
|
||||
| `v4.0` | 合并 SRGF，新增绝区零抽卡格式支持 | v4.0 |
|
||||
* 对于无需处理星穹铁道的应用，v4.1 与 v4.0 兼容。
|
||||
|
||||
## 前言
|
||||
|
||||
@@ -77,11 +79,11 @@ Update: 2024-11-11
|
||||
},
|
||||
"export_app": {
|
||||
"type": "string",
|
||||
"description": "导出档案的 App 名称"
|
||||
"description": "导出档案的应用名称"
|
||||
},
|
||||
"export_app_version": {
|
||||
"type": "string",
|
||||
"description": "导出档案的 App 版本"
|
||||
"description": "导出档案的应用版本"
|
||||
},
|
||||
"version": {
|
||||
"type": "string",
|
||||
@@ -89,7 +91,12 @@ Update: 2024-11-11
|
||||
"description": "导出档案的 UIGF 版本号，格式为 'v{major}.{minor}'，如 v4.0"
|
||||
}
|
||||
},
|
||||
"required": ["export_timestamp", "export_app", "export_app_version", "version"]
|
||||
"required": [
|
||||
"export_timestamp",
|
||||
"export_app",
|
||||
"export_app_version",
|
||||
"version"
|
||||
]
|
||||
},
|
||||
"hk4e": {
|
||||
"type": "array",
|
||||
@@ -140,12 +147,25 @@ Update: 2024-11-11
|
||||
"uigf_gacha_type": {
|
||||
"type": "string",
|
||||
"description": "UIGF 卡池类型，用于区分卡池类型不同，但卡池保底计算相同的物品",
|
||||
"enum": ["100", "200", "301", "302", "500"]
|
||||
"enum": [
|
||||
"100",
|
||||
"200",
|
||||
"301",
|
||||
"302",
|
||||
"500"
|
||||
]
|
||||
},
|
||||
"gacha_type": {
|
||||
"type": "string",
|
||||
"description": "卡池类型，米哈游 API 返回",
|
||||
"enum": ["100", "200", "301", "302", "400", "500"]
|
||||
"enum": [
|
||||
"100",
|
||||
"200",
|
||||
"301",
|
||||
"302",
|
||||
"400",
|
||||
"500"
|
||||
]
|
||||
},
|
||||
"item_id": {
|
||||
"type": "string",
|
||||
@@ -157,7 +177,8 @@ Update: 2024-11-11
|
||||
},
|
||||
"time": {
|
||||
"type": "string",
|
||||
"description": "抽取物品时对应时区（timezone）下的当地时间"
|
||||
"description": "抽取物品时对应时区（timezone）下的当地时间",
|
||||
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
|
||||
},
|
||||
"name": {
|
||||
"type": "string",
|
||||
@@ -173,14 +194,27 @@ Update: 2024-11-11
|
||||
},
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "记录内部 ID，米哈游 API 返回"
|
||||
"description": "记录内部 ID，米哈游 API 返回",
|
||||
"maxLength": 19,
|
||||
"minLength": 1,
|
||||
"pattern": "^[0-9]+$"
|
||||
}
|
||||
},
|
||||
"required": ["uigf_gacha_type", "gacha_type", "item_id", "time", "id"]
|
||||
"required": [
|
||||
"uigf_gacha_type",
|
||||
"gacha_type",
|
||||
"item_id",
|
||||
"time",
|
||||
"id"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": ["uid", "timezone", "list"]
|
||||
"required": [
|
||||
"uid",
|
||||
"timezone",
|
||||
"list"
|
||||
]
|
||||
}
|
||||
},
|
||||
"hkrpg": {
|
||||
@@ -231,12 +265,19 @@ Update: 2024-11-11
|
||||
"properties": {
|
||||
"gacha_id": {
|
||||
"type": "string",
|
||||
"description": "卡池 Id"
|
||||
"description": "卡池 ID"
|
||||
},
|
||||
"gacha_type": {
|
||||
"type": "string",
|
||||
"description": "卡池类型",
|
||||
"enum": ["1", "2", "11", "12"]
|
||||
"enum": [
|
||||
"1",
|
||||
"2",
|
||||
"11",
|
||||
"12",
|
||||
"21",
|
||||
"22"
|
||||
]
|
||||
},
|
||||
"item_id": {
|
||||
"type": "string",
|
||||
@@ -248,7 +289,8 @@ Update: 2024-11-11
|
||||
},
|
||||
"time": {
|
||||
"type": "string",
|
||||
"description": "抽取物品时对应时区（timezone）下的当地时间"
|
||||
"description": "抽取物品时对应时区（timezone）下的当地时间",
|
||||
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
|
||||
},
|
||||
"name": {
|
||||
"type": "string",
|
||||
@@ -264,14 +306,27 @@ Update: 2024-11-11
|
||||
},
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "记录内部 ID，米哈游 API 返回"
|
||||
"description": "记录内部 ID，米哈游 API 返回",
|
||||
"maxLength": 19,
|
||||
"minLength": 1,
|
||||
"pattern": "^[0-9]+$"
|
||||
}
|
||||
},
|
||||
"required": ["gacha_type", "gacha_id", "time", "item_id", "id"]
|
||||
"required": [
|
||||
"gacha_type",
|
||||
"gacha_id",
|
||||
"time",
|
||||
"item_id",
|
||||
"id"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": ["uid", "timezone", "list"]
|
||||
"required": [
|
||||
"uid",
|
||||
"timezone",
|
||||
"list"
|
||||
]
|
||||
}
|
||||
},
|
||||
"nap": {
|
||||
@@ -322,12 +377,17 @@ Update: 2024-11-11
|
||||
"properties": {
|
||||
"gacha_id": {
|
||||
"type": "string",
|
||||
"description": "卡池 Id"
|
||||
"description": "卡池 ID"
|
||||
},
|
||||
"gacha_type": {
|
||||
"type": "string",
|
||||
"description": "卡池类型",
|
||||
"enum": ["1", "2", "3", "5"]
|
||||
"enum": [
|
||||
"1",
|
||||
"2",
|
||||
"3",
|
||||
"5"
|
||||
]
|
||||
},
|
||||
"item_id": {
|
||||
"type": "string",
|
||||
@@ -339,7 +399,8 @@ Update: 2024-11-11
|
||||
},
|
||||
"time": {
|
||||
"type": "string",
|
||||
"description": "抽取物品时对应时区（timezone）下的当地时间"
|
||||
"description": "抽取物品时对应时区（timezone）下的当地时间",
|
||||
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
|
||||
},
|
||||
"name": {
|
||||
"type": "string",
|
||||
@@ -355,17 +416,132 @@ Update: 2024-11-11
|
||||
},
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "记录内部 ID，米哈游 API 返回"
|
||||
"description": "记录内部 ID，米哈游 API 返回",
|
||||
"maxLength": 19,
|
||||
"minLength": 1,
|
||||
"pattern": "^[0-9]+$"
|
||||
}
|
||||
},
|
||||
"required": ["gacha_type", "item_id", "time", "id"]
|
||||
"required": [
|
||||
"gacha_type",
|
||||
"item_id",
|
||||
"time",
|
||||
"id"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": ["uid", "timezone", "list"]
|
||||
"required": [
|
||||
"uid",
|
||||
"timezone",
|
||||
"list"
|
||||
]
|
||||
}
|
||||
},
|
||||
"hk4e_ugc": {
|
||||
"type": "array",
|
||||
"properties": {
|
||||
"uid": {
|
||||
"oneOf": [
|
||||
{
|
||||
"type": "string"
|
||||
},
|
||||
{
|
||||
"type": "integer"
|
||||
}
|
||||
],
|
||||
"description": "UID"
|
||||
},
|
||||
"timezone": {
|
||||
"type": "integer",
|
||||
"description": "时区偏移，由米哈游 API 返回，若与服务器时区不同请注意 list 中 time 的转换"
|
||||
},
|
||||
"lang": {
|
||||
"type": "string",
|
||||
"description": "语言代码",
|
||||
"enum": [
|
||||
"de-de",
|
||||
"en-us",
|
||||
"es-es",
|
||||
"fr-fr",
|
||||
"id-id",
|
||||
"it-it",
|
||||
"ja-jp",
|
||||
"ko-kr",
|
||||
"pt-pt",
|
||||
"ru-ru",
|
||||
"th-th",
|
||||
"tr-tr",
|
||||
"vi-vn",
|
||||
"zh-cn",
|
||||
"zh-tw"
|
||||
]
|
||||
},
|
||||
"list": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "记录内部 ID，米哈游 API 返回",
|
||||
"maxLength": 19,
|
||||
"minLength": 1,
|
||||
"pattern": "^[0-9]+$"
|
||||
},
|
||||
"schedule_id": {
|
||||
"type": "string",
|
||||
"description": "卡池排期 ID，米哈游 API 返回",
|
||||
"minLength": 1,
|
||||
"pattern": "^[0-9]+$"
|
||||
},
|
||||
"item_type": {
|
||||
"type": "string",
|
||||
"description": "物品类型，米哈游 API 返回"
|
||||
},
|
||||
"item_id": {
|
||||
"type": "string",
|
||||
"description": "物品 ID，米哈游 API 返回",
|
||||
"minLength": 1,
|
||||
"pattern": "^[0-9]+$"
|
||||
},
|
||||
"item_name": {
|
||||
"type": "string",
|
||||
"description": "物品名称，米哈游 API 返回"
|
||||
},
|
||||
"rank_type": {
|
||||
"type": "string",
|
||||
"description": "物品等级，米哈游 API 返回",
|
||||
"minLength": 1,
|
||||
"pattern": "^[0-9]+$"
|
||||
},
|
||||
"time": {
|
||||
"type": "string",
|
||||
"description": "抽取物品时对应时区（timezone）下的当地时间",
|
||||
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
|
||||
},
|
||||
"op_gacha_type": {
|
||||
"type": "string",
|
||||
"description": "卡池类型，米哈游 API 返回",
|
||||
"enum": [
|
||||
"1000",
|
||||
"2000",
|
||||
"20011",
|
||||
"20012",
|
||||
"20021",
|
||||
"20022"
|
||||
]
|
||||
}
|
||||
},
|
||||
"required": ["id","schedule_id","item_type","item_id","item_name","rank_type","time","op_gacha_type"]
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": ["uid", "timezone", "list"]
|
||||
}
|
||||
},
|
||||
"required": ["info"]
|
||||
"required": [
|
||||
"info"
|
||||
]
|
||||
}
|
||||
```
|
||||
```
|
||||
Reference in New Issue
Block a user