shoes-doc/运动数据/步数统计.md

添加日常步数记录

stepRecord/addDaily

参数

• 传单条记录

参数	类型	必须	备注
step	int	是
distance	int	是	距离 米
time	string	是	日期时间 如 2020-01-01 00:00:00

• 传多条记录

参数	类型	必须	备注
data	json	是	每一条记录是一个数组，存 [步数,距离,时间戳]

如 [[100,200,1603261671]]

---

日常步数请求条件

• 打开 app

打开 app 时 一年内 未汇报的数据 按小时 分条上报。如果超过一个月，则每个月发一次请求（一次请求有 24 * 30 条左右）

• 用户查看数据图表

立即汇报所有未汇报的数据，不用按小时分条

• 每分钟

如果未汇报步数记录超过了 5，则汇报一次

备注

• 如果批量上传记录超过 100 条，则会转为任务进程处理，读取相关表格数据时 is_synchronizing 为 true，表示有数据正在同步
• 后端会丢弃步数少于 5 的记录
• 后端会将多条记录按 小时 粒度合成一条记录

一天

stepRecord/listOneDay

参数

参数	类型	必须	备注
date	string	否	日期 如 2020-01-01 不传默认当天

返回

{
    "result":1,
    "code":0,
    "msg":"成功",
    "data":{
	"steps": [ // 24 个元素的数组，一天的 24 个小时的步数
		0,
		100,
	],
        "records":[
            {
				"type": "game",
				"record_id": 938,
				"consume": 9,
				"duration": 277,
				"step": 401,
				"distance": 120,
				"step_rate": "86.9",
				"created_at": "2021-03-29 02:00:00",
            }
        ],
        "sum":{
            "step":10747,               // 总步数
            "distance":5382,
            "step_game":9813,           // 游戏步数
            "step_daily":934,           // 日常步数
			"step_jog": 1000            // 跑步步数
            "step_rate_game": 95.4,     // 游戏步频
			"step_rate_game_max": 109.8 // 游戏最高步频
        },
		"is_synchronizing": false       // 后台是否正在同步数据
    }
}

---

按天

stepRecord/listByDay

参数

参数	类型	必须	备注
begin	string	是	开始日期 如 2020-01-01
end	string	是	结束日期 如 2020-01-01

返回

{
    "result":1,
    "code":0,
    "msg":"成功",
    "data":{
        "records":[
            {
				"consume": 154,
				"consume_game": 67,
				"consume_jog": 87,
				"duration": 2669,
				"duration_game": 2154,
				"duration_jog": 515,
				"step": 6932,
				"step_game": 3740,
				"step_jog": 2484,
				"step_daily": 708,
				"distance": 3477,
				"distance_game": 1810,
				"distance_jog": 1242,
				"distance_daily": 425,
				"created_at": "2021-03-01",
            }
        ],
        "sum":{
			"distance": 187141,
			"step_day_avg": 17134,
			"step": 376958,
			"step_game": 64545,
			"step_daily": 22201,
			"step_jog": 290212,
			"step_rate_game": 99.9,
			"step_rate_game_max": 120
        },
		"is_synchronizing": false  // 后台是否正在同步数据
    }
}

按月

stepRecord/listByMonth

参数

参数	类型	必须	备注
year	int	是	年份 如 2020

返回

{
    "result":1,
    "code":0,
    "msg":"成功",
    "data":{
        "records":[
            {
				"consume": 2958,
				"consume_game": 343,
				"consume_jog": 2615,
				"duration": 28160,
				"duration_game": 11091,
				"duration_jog": 17069,
				"step": 101172,
				"step_game": 18382,
				"step_jog": 74704,
				"step_daily": 8086,
				"distance": 50216,
				"distance_game": 9563,
				"distance_jog": 37352,
				"distance_daily": 3301,
				"year": 2021,
				"month": 2,
            }
        ],
        "sum":{
			"distance": 244706,
			"step_day_avg": 16428,
			"step": 492845,
			"step_game": 85714,
			"step_daily": 30287,
			"step_jog": 376844,
			"step_rate_game": 99.6,
			"step_rate_game_max": 120
        },
		"is_synchronizing": false
    }
}