游玩记录
游玩记录接口按范围返回当前账号的历史记录。范围采用从 0 开始的半开区间 [start, end)。
获取记录
http
POST /playlog/getjson
{
"token": "<TOKEN>",
"start": 0,
"end": 50
}响应：
json
{
"success": true,
"msg": "success",
"total": 1234,
"playlogList": []
}end 不应远大于 start；建议分页读取并在失败时从上一次成功位置继续。
记录字段
基本信息
| 字段 | 类型 | 说明 |
|---|---|---|
userId | number | 用户编号 |
orderId | number | 记录序号 |
playlogId | number | 游玩记录编号 |
version | number | 数据版本编号 |
placeId | number | 地点编号 |
placeName | string | 地点名称 |
loginDate | number | 登录时间数值 |
playDate | string | 游玩时间 |
userPlayDate | string | 用户侧游玩时间 |
type | number | 记录类型 |
musicId | number | 曲目编号 |
level | number | 难度索引 |
trackNo | number | Track 序号 |
对战与伙伴
| 字段 | 类型 | 说明 |
|---|---|---|
vsMode | number | 对战模式 |
vsUserName | string | 对手名称 |
vsStatus | number | 对战状态 |
vsUserRating | number | 对手 Rating |
vsUserAchievement | number | 对手达成率 |
vsUserGradeRank | number | 对手等级排名 |
vsRank | number | 对战排名 |
playerNum | number | 同局玩家数量 |
playedUserId1-3 | number | 同局其他玩家编号 |
playedUserName1-3 | string | 同局其他玩家名称 |
playedMusicLevel1-3 | number | 同局其他玩家难度 |
characterId1-5 | number | 伙伴编号 |
characterLevel1-5 | number | 伙伴等级 |
characterAwakening1-5 | number | 伙伴觉醒等级 |
成绩与判定
| 字段 | 类型 | 说明 |
|---|---|---|
achievement | number | 放大后的达成率整数，除以 10000 得到百分比 |
deluxscore | number | DX 分数 |
scoreRank | number | 评级索引 |
maxCombo / totalCombo | number | 最大连击 / 总连击 |
maxSync / totalSync | number | 最大同步 / 总同步 |
tap* | number | TAP 各等级判定数量 |
hold* | number | HOLD 各等级判定数量 |
slide* | number | SLIDE 各等级判定数量 |
touch* | number | TOUCH 各等级判定数量 |
break* | number | BREAK 各等级判定数量 |
fastCount / lateCount | number | Fast / Late 数量 |
每一组 tap*、hold*、slide*、touch*、break* 都可能包含 CriticalPerfect、Perfect、Great、Good、Miss 五类字段。
标记与状态
| 字段 | 类型 | 说明 |
|---|---|---|
isTap / isHold / isSlide / isTouch / isBreak | boolean | 是否包含对应音符类型 |
isCriticalDisp | boolean | 是否显示 Critical |
isFastLateDisp | boolean | 是否显示 Fast/Late |
isAchieveNewRecord | boolean | 是否刷新达成率记录 |
isDeluxscoreNewRecord | boolean | 是否刷新 DX 分数记录 |
comboStatus | number | 连击状态索引 |
syncStatus | number | 同步状态索引 |
isClear | boolean | 是否通关 |
isPlayTutorial | boolean | 是否教程记录 |
isEventMode | boolean | 是否活动模式 |
isFreedomMode | boolean | 是否自由模式 |
playMode | number | 游玩模式 |
isNewFree | boolean | 是否新自由模式 |
trialPlayAchievement | number | 试玩达成率 |
Rating 与扩展字段
| 字段 | 类型 | 说明 |
|---|---|---|
beforeRating / afterRating | number | 游玩前后 Rating |
beforeGrade / afterGrade | number | 游玩前后等级 |
afterGradeRank | number | 游玩后等级排名 |
beforeDeluxRating / afterDeluxRating | number | 游玩前后 DX Rating |
extNum1 / extNum2 / extNum4 | number | 扩展数字字段 |
extBool1 | boolean | 扩展布尔字段 |
playCount | number | 游玩次数，可能缺省 |
数据处理建议
- 保留原始整数，不要把达成率四舍五入后再上传；
- 未知字段应原样保留，以兼容后续版本；
- 处理时间时注明时区；
- 不要在公开页面显示完整用户编号和地点信息。