| 修改日期 | 修改人 | 备注 |
| 2026-07-29 16:24:57[当前版本] | 梁建宁 | 内容更新 |
| 2026-07-29 16:11:31 | 梁建宁 | 内容更新 |
| 2026-07-24 17:39:39 | 梁建宁 | 内容更新 |
| 2026-07-24 14:06:22 | 梁建宁 | 内容更新 |
此文档用于指引如何配置新版运动打卡系统使用及功能使用。
1.支持随机打卡获得成绩
2.支持按顺序打卡获得成绩
3.支持挑战类打卡，按最高成绩计算打卡成绩
4.支持达成一定成绩获得奖励
5.支持成绩展示在任务机中
1.运动打卡网关（与氛围网关为同一设备，已有氛围网关则不需要额外使用），配套电源适配器一个。
2.互动打卡终端，若干，根据现场打卡点配置，需要根据数量配置变压器（电源适配器）
3.任务机（用于查询成绩使用）
方式一（推荐此方式：攀爬区等游客容易接触到的地方不建议直接预留220V电源，容易产生安全隐患）：
电线预留按标准预留， 预留的电线电压在总电房/天花顶部电箱通过变压器转换成24V，打卡终端直接直接接正负极通电使用。
方式二：（适合于非攀爬类项目，游客不容易接触到220V的场景）
电线预留没有按标准要求预留，预留的电线电压是直接从总电机出来的220V，需要单独在每个预留的电线处，单独接变压器把电压装换成24V，再接入打卡终端电源正负极（此场景需要额外注意变压器的存放位置）
注意事项：24V电源线建议不超过50m，否则可能有电压衰减引起打卡终端不正常运作。
WIFI名称：YOC53Y0597E06NozOBJ40negx
WIFI密码：BcUOsuZqBa9QIBJUTzy7L7NE
要求：需要DHCP功能，只支持2.4G网络
3.需要互动打卡网关接入到与服务器和打卡终端同一局域网内。
注意事项：旧版互动打卡云服务器是不需要网关，但此版本的互动打卡无论是云服务器还是本地服务器，都需要网光。
1.版本升级到以下版本
国内：10.4.3246以上
东南亚：20.1.2535
欧美：暂不支持
2.需要在门店服务器settings文件中添加参数字段，可通过技术后台直接添加
路径：【门店】-【技术后台】（需要油菜花授权）-【Setting管理】新增参数
YZYProjectModelID=5f3f7b71-938a-4558-ba2c-81d89382e56a
（也可以直接找到settings配置文件打开直接复制该参数进去）
添加完成后需重启门店服务
面板拆开：
底板固定（注意，底版位置有朝向箭头，请按朝向箭头进行安装）
并入预留的电线正负极：
盖上打卡终端外壳：
拧上固定螺丝，固定面板：
安装完毕：
接入到网络柜，通电，并将网线接入到与服务器同一个交换机中（云服务器则直接接入到主交换机即可）
1. 在【总部】-【项目分类】新增项目功能为“成就终端”的项目分类
2. 需要在门店服务器settings文件中添加参数字段，可通过技术后台直接添加
路径：【门店】-【技术后台】-【Setting管理】新增参数
YZYProjectModelID=5f3f7b71-938a-4558-ba2c-81d89382e56a
（也可以直接找到settings配置文件打开直接复制该参数进去）
添加完成后需重启门店服务
3. 【门店】-【游乐项目】，新增项目类型为“成就终端”的游乐项目
4. 【门店】-【游乐项目】，只有项目类型为“打卡终端”的项目才会显示“设置”操作按钮，点击进入【运动终端设置】页面，此处绑定打卡终端。
5. 【打卡得分】开启后才能设置每一个打卡终端的打卡分数，分别可选“随机打卡，分数相加”、“顺序打开，分数相加”、“取最高的一个打卡点数”
其中：
1. 随机打卡：支持设置有效打卡个数（可设置为0），累计封顶分数，需达到有效打卡数量才有分数。
2. 顺序打卡：必须是按“打卡终端”列表的“打卡顺序”进行打卡，否则会报错。
3. 取最高的一个打卡点分数：会在已打卡的得分项中选取最高分数的一个成绩
4. 当只有一个打卡点时，不能设置“计时得分”
6. 【计时得分】开启后能设置不同时间阶梯完成打卡的得分，当只有一个打卡终端时，无法勾选“超时没有成绩”
7. 【潮玩运动任务成就】新菜单，需在【运维平台】开通
8. 新增潮玩运动任务成就
项目：显示所有的项目类型为模拟机、成绩终端
玩法：游戏得分，根据打卡分数来获取奖励；计时（秒）根据打卡总时长来获取奖励
任务规则：根据所选项设置“阶梯规则”、“按得分倍数奖励”
奖励同等数量的成长值：勾选项，勾选后，可奖励达成任务规则奖励储值的同等数量的成长值
奖励周期：“每天最多一次”即玩家每天只能获取一次奖励，若最佳成绩更新，会补足满足任务规则奖励和已获得奖励的差额奖励。“每次”即每次达成任务都能获得奖励。
任务成就
达成条件：一般设置为“总分”条件，其他选项均取值第三方调用我们提供的上报分数接口而获取的分数值。
9. 【运动馆游戏分数查询】新菜单，需在【运维平台】开通
1. 门店路由器需配置芸苔wifi，（YOC开头的wifi名称）打卡终端自动连接
2. 打卡终端放置一张会员卡片在上面，通电开机即重置打卡终端，重置后打卡终端屏幕会显示该终端的设备编号，用于后台绑定
3. 成功连上wifi，终端会显示笑脸状态，此时处于待绑定。
4. 绑定成功的打卡终端，会显示后台【游乐项目】-【运动终端设置】中终端列表的“打卡顺序”号码。
5. 打卡终端需结合边缘网关使用，门店需配置网关盒子相关设置方能使用。
6. 边缘网关版本：2026071702
1. 打卡终端刷卡时显示“22”报错
需检查门店后台是否已添加参数：YZYProjectModelID=5f3f7b71-938a-4558-ba2c-81d89382e56a
2. 若打卡成绩无在【运动馆游戏分数查询】中显示
需检查边缘网关状态，心跳恢复正常后会自动重新上报成绩
3. 打卡终端异常或更换绑定门店
需在原绑定的【游乐项目】中删除打卡终端，然后到游智云上解绑该终端后，再进行重置打卡终端流程。
