机台查卡

机台查卡接口返回一个机台的公开在线、游玩和会话聚合数据。调用前必须拥有对应机台的访问权限。

获取统计

POST /player/queue/get

{
  "token": "<TOKEN>",
  "clientId": "<MACHINE_ID>"
}

响应顶层：

{
  "success": true,
  "msg": "success",
  "playerQueueData": {
    "clientId": "<MACHINE_ID>",
    "statistics": {},
    "currentOnlinePlayers": [],
    "timeRangeStatistics": [],
    "playerActivityAnalysis": {},
    "recentPlayRecords": [],
    "peakHoursAnalysis": {},
    "sessionStatistics": {},
    "recentSessionRecords": [],
    "sessionDurationAnalysis": {},
    "playerSessionFrequencyAnalysis": {},
    "sessionHourlyDistribution": {},
    "generatedAt": "2026-09-10T00:00:00Z"
  }
}

统计字段

statistics

字段	类型	说明
currentOnlineCount	number	当前在线人数
isOnline	boolean	机台是否在线
last30MinutesCount、last1HourCount、last2HoursCount、last3HoursCount、last6HoursCount、last12HoursCount、last24HoursCount	number	对应时间窗口的人数
totalPlayRecords	number	游玩记录总数
totalSessionRecords	number	会话记录总数

当前在线与最近记录

currentOnlinePlayers 的元素包含 userName、loginTime、playDuration、playDurationFormatted。

recentPlayRecords 的元素包含 userName、loginTime、logoutTime、duration、durationFormatted。

recentSessionRecords 额外包含 sessionId。

时段与活跃分析

timeRangeStatistics：timeRange、duration、playerCount、uniquePlayerCount。

playerActivityAnalysis：平均/最大/最小时长及格式化字段，以及 durationGroups。每个分组含 groupName、minDuration、maxDuration、playerCount、percentage。

peakHoursAnalysis：hourlyStatistics、peakHour、peakHourCount、peakTimeRange。每个小时统计包含 hour、playerCount、timeRange。

会话分析

sessionStatistics 包含最近 30 分钟、1/2/3/6/12/24 小时、7 天的会话数量，以及 averageSessionsPerDay、averageSessionsPerUser、totalSessions。

sessionDurationAnalysis 包含时长分组、平均值、中位数、最大值、最小值和格式化字段。

playerSessionFrequencyAnalysis 包含活跃用户、频率分组、回访用户数和回访率。

sessionHourlyDistribution 包含每小时会话统计、峰值小时、峰值数量和时间段。

完整字段索引

下面的字段名与公开响应保持一致，客户端可以按需读取；未知字段应保留而不是删除。

timeRangeStatistics[]

字段	类型	说明
timeRange	string	时间段名称
duration	number	统计时长
playerCount	number	该段活动人数
uniquePlayerCount	number	去重用户数

playerActivityAnalysis

字段	类型	说明
averagePlayDuration	number	平均游玩时长
averagePlayDurationFormatted	string	格式化平均时长
maxPlayDuration	number	最大游玩时长
maxPlayDurationFormatted	string	格式化最大时长
minPlayDuration	number	最小游玩时长
minPlayDurationFormatted	string	格式化最小时长
durationGroups[]	array	时长分组

每个 durationGroups[] 项包含 groupName、minDuration、maxDuration、playerCount 和 percentage。

peakHoursAnalysis

字段	类型	说明
hourlyStatistics[]	array	每小时人数
peakHour	number	峰值小时，范围通常为 0–23
peakHourCount	number	峰值人数
peakTimeRange	string	峰值时间段

每个 hourlyStatistics[] 项包含 hour、playerCount 和 timeRange。

sessionStatistics

字段	类型	说明
last30MinutesSessionCount	number	最近 30 分钟会话数
last1HourSessionCount	number	最近 1 小时会话数
last2HoursSessionCount	number	最近 2 小时会话数
last3HoursSessionCount	number	最近 3 小时会话数
last6HoursSessionCount	number	最近 6 小时会话数
last12HoursSessionCount	number	最近 12 小时会话数
last24HoursSessionCount	number	最近 24 小时会话数
last7DaysSessionCount	number	最近 7 天会话数
averageSessionsPerDay	number	日均会话数
averageSessionsPerUser	number	人均会话数
totalSessions	number	总会话数

sessionDurationAnalysis

包含 averageSessionDuration、maxSessionDuration、minSessionDuration、medianSessionDuration 及对应的 Formatted 字段，并包含 durationGroups[]。

每个会话时长分组包含 groupName、minDuration、maxDuration、sessionCount 和 percentage。

playerSessionFrequencyAnalysis

字段	类型	说明
topActiveUsers[]	array	活跃用户列表
frequencyGroups[]	array	会话频率分组
returningPlayersCount	number	回访用户数
returningPlayersRate	number	回访率

每个 topActiveUsers[] 项包含 userName、sessionCount、totalDuration、totalDurationFormatted、averageDuration、averageDurationFormatted、firstLoginTime 和 lastLoginTime。

每个 frequencyGroups[] 项包含 groupName、minSessions、maxSessions、playerCount 和 percentage。

sessionHourlyDistribution

字段	类型	说明
hourlySessionStats[]	array	每小时会话统计
peakSessionHour	number	会话峰值小时
peakSessionHourCount	number	峰值会话数
peakSessionTimeRange	string	峰值时间段

每个 hourlySessionStats[] 项包含 hour、sessionCount 和 timeRange。

客户端展示建议

• 所有数组都可能为空；
• 时间字段不要按字符串排序，应先解析为时间；
• 时长同时保留原始数值和格式化文本；
• 不要把 userName、sessionId 和完整响应写入公共日志；
• 多机台合并时给每条记录保留来源 clientId。

隐私建议

查卡结果可能包含用户名称和时间信息。只在机台所有者允许的范围内展示，不要把完整响应公开发布。