| 修改日期 | 修改人 | 备注 |
| 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.螺丝刀*1
2.电工胶布*1
3.斜口钳*1
4.显示屏*1（配置时需要）
5.鼠标键盘*1（配置时需要）
1.运动打卡网关（与氛围网关为同一设备，已有氛围网关则不需要额外使用），配套电源适配器一个。
网关版本：2026071702
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.（云服务器客户必要操作）提供加密狗编码给运维组（郑力宣），让他帮忙配置SSH。
3. 开通相关界面，需要开通以下界面：
a.潮玩运动任务成就
b.潮玩运动游戏分数查询
面板拆开：
底板固定（注意，底版位置有朝向箭头，请按朝向箭头进行安装）
并入预留的电线正负极：
盖上打卡终端外壳：
拧上固定螺丝，固定面板：
安装完毕：
接入到网络柜，通电，并将网线接入到与服务器同一个交换机中（云服务器则直接接入到主交换机即可）
a.运动打卡网关IP地址需要通过路由器的MAC绑定功能进行固定，避免断电后地址变动造成不能使用
b.系统后台配置正确的运动打卡网关信息。
此步骤中的互动打卡网关主机原则上只需要接入网线和电源即可。但是配置阶段时，还需要接入显示屏、鼠标以及键盘来进行配置。
①接线如下图
正面需要接USB口，用于接鼠标和键盘使用（调试必要，后续运行时可不用）
背面需要接网口（只需要接其中一个，接入到和服务器同一个交换机中）、屏幕视频线（VGA或HDIM其中一个）以及电源接口
②按开机键开机，并进入到互动打卡主机界面
PS：互动打卡主机开机密码为：youcaihua
③记录目前IP地址信息
1.记录硬件地址
2.IP地址（云服务器客户才需要）
3.默认路由地址（云服务器客户才需要）
④选择IPv4页，并在IPv4界面选择【手动】并固定IP地址以及填写DNS地址
要求：
a.IP地址填写为服务器后一位地址（需要确保此地址可用）
如：服务器地址为192.168.110.10，则固定为192.168.110.11
其他子网掩码和网关与服务器保持一致
b.DNS去掉自动，填写为119.29.29.29
a.IP地址填写上一步记录的IP地址以及网关地址（路由器地址）
b.DNS去掉自动，填写为119.29.29.29
登录服务器对应的主路由，找到【静态地址分配】，以TP-Link为例，如下图所示登录对应设置界面。通过上面记录的MAC地址（硬件地址）和互动打卡网关的IP地址，填写到这里来并生效静态地址。
⑥网关编码检验，在跟网关盒子同一网络的电脑（本地服务器则在服务器中打开）上，打开浏览器，http://网关IP/home/index，可看到右上角编码（网关编码），匹配判断是否跟网关盒子上的标签是否一致，若一致，则该网关编码正确。
⑦在娱乐管家系统配置氛围网关主机
路径：【会员】->【运动打卡设置】->【门店配置】->【边缘网关】
核心需要填写的内容：
1.边缘网关编码：填写氛围网关主机上的编码，一般贴在氛围网关主机外观上。
2.业务后台地址：填写本地服务器的服务器地址 业务端口，例如：192.168.110.10:9999；云服务器则填写完整域名，如y5******2.yun.youcaihua.net:88
3.推送门店地址：填写该门店的加密狗编码
4.推送appid：填写A001
5.推送key：填写B002
6.开启本地MQTT：勾选开启
7.自动配置MQTT默认参数：勾选开启
按以上内容填写后，点击保存，并点击【重启边缘网关】（重启时间大概需要3~5分钟，后续修改以上内容均要点击重启边缘网关）。偶尔出现无效的情况时，可手动直接在边缘互动打卡网关主机中手动重启生效。
实际案例效果图：
设置打卡终端所连的AP路由器放出的WIFI信息
该wifi信息为固定WIFI（只支持2.4G网络）：
名称：YOCQijyO2lZBkXZhLGkEKYkAU
密码：SrXo0JlHvQ7J4yDmXSPLIFPbg
进入AP路由器设置该WIFI信息
注意：需要开启DHCP功能，并且有足够的地址池支撑分配给打卡终端
配置成功后，打卡终端会依次显示终端编码，如下图所示
路径：
连锁版：【总部】-【项目分类】
单店版：【终端】-【项目分类】
新增项目功能为“成就终端”的项目分类， 如下图所示：
路径：【门店】-【终端】-【游乐项目】
新增项目类型为“成就终端”的游乐项目，名称为该项目名称（此名称会呈现在任务系统中所显示的关卡名称）
路径：【门店】-【终端】-【游乐项目】
只有项目类型为“打卡终端”的项目才会显示“设置”操作按钮，点击进入【运动终端设置】页面，此处绑定打卡终端。
每个终端会轮放对应的2位数，底部小数点则为顺序，如下图所展示打卡终端编码为104696386
等待连接成功后，打卡终端会显示顺序序号，证明已经连接完成。
注意事项：
1.同一个项目下配置打卡终端时，如果有开始和结束这种项目，务必第一个绑定为开始的打卡终端，最后一个配置是结束终端
2.单个项目可设置到
项目游戏设置用于设定该项目完成的条件和分值计算逻辑，玩家需要满足该逻辑才算游戏结束并获得分数奖励。
打卡得分：开启后，每打一个终端，则直接获得得分
随机打卡：当开启打卡得分后，每个终端可单独设置对应的分数，随机打卡则获得对应的分数。可同时设置最对打多少卡才有分数和封顶能获得多少分数（达到最低要求打卡数后会一次性计算所有的分值）。使用随机打卡是，同一个终端只能获得一次分值。
顺序打卡，分数相加：当开启打卡得分后，每个终端可单独设置对应的分数，需要要求玩家依次打卡才能获得积分，跳过顺序是无法完成打卡并显示X的标识。
去
计时得分：开启后，计算从标记为开始的终端开始，计算到最后一个标记为终点的终端的总时长，根据时长进行得分。（一次性计算）
计时规则：用于设置起点到终点每个等级的具体时间段及对应获得的额外得分。
游戏超时：设置后，超过设置的时间则代表此项目游戏结算，并结算获得得分。后续在打卡也不会再获取得分。
超时没有成绩：勾选后，超时没有成绩（包括打卡得分的成绩），不勾选则会直接结算已有成绩。
特殊设置逻辑
1.如果想设置打卡封顶分值，可设置有效至少打卡数为0，并设置累计封顶多少分。
2.只有1个打卡终端时，不支持设置计时得分和超时没有成绩这两个功能。
案例：迷宫项目，玩家进入迷宫后，需要在迷宫正确路线中打卡，每完成一段迷宫获得分数，并根据用时越短获得额外分数越多。
设置参考：
案例：寻宝项目，玩家进入寻宝区域后，需要区域中找到宝藏，至少找到特定数量的宝藏则代表通关，假如全部找到后，如果满足特定时间还能获得时间得分。
设置参考：
案例：按难度划分的攀爬项目，玩家可挑战不同难度的攀爬项目来获取分值完成挑战。难度越高获得的分值越高。
设置参考：
案例：障碍跑，玩家需要以最快速度通过所有的障碍并到达终点。（时间越短得分越高）；举重，玩家举起杠铃，根据维持举起动作时间长度来计算成绩（时间越长得分越高）。
设置参考：
目前新版互动打卡能获得的奖励分两种，一种是储值类的奖励，通过设置【任务】获得，一种是勋章，通过【成就】获得。每个独立的项目只可以设置一种类型的【任务】和【成就】。
1.我想实现能力值的体现，可以实现吗？
答：如果所有储值都不使用的情况下，可以实现，只要把储值类型的名称改为对应的能力值名称即可，比如【代币】可以更名为【力量】、【金币】更名为【敏捷】等。配合【新运动馆】的小程序界面，玩家就可以清楚看到自己的能力值。
2.如果想实现持续游玩可以获得经验，并形成不同的等级，如【新手】【学徒】【资深】【大宗师】等不同等级。可以实现吗？
答：可以，在设置对应的任务或者成就时，勾选获得成长值即可，配合【会员自动升级】功能即可实现游玩→完成任务→获得经验→累积经验升级这个流程闭环。
3.在问题一中，相关能力值有哪些好用吸引的点？
答：常见的推广方式有：献祭一定能力值可获取神器（礼品兑换）
4.相关的任务以及获得的能力玩家可以从哪里查看到？
答：【新运动馆】的小程序界面中，【任务】功能可以查看到。
路径：
【后台】→【会员】→【潮玩运动任务成就】
设置方法：
点击新增，添加对应游玩项目的任务或成就。
字段说明（任务相关）
项目：选择需要设置的游玩项目，显示所有的项目类型为模拟机、成绩终端。
玩法：设置该任务成就的属性，会体现在任务机和小程序中。其中，游戏得分，根据打卡分数来获取奖励，并在任务机中安分数显示排行；而，计时（秒）根据打卡总时长来获取奖励，在任务机中则按时间显示排行。
任务规则：根据所选项设置“阶梯规则”、“按得分倍数奖励”。填写时，如果选择阶梯规则，前者匹配的是分数，后者匹配的是奖励的储值数量及对应的储值类型。如果选择【按得分倍数奖励】，则代表玩家完的分数会直接按比例转换成奖励的储值数量及储值类型。
奖励同等数量的成长值：勾选项，勾选后，可奖励达成任务规则奖励储值的同等数量的成长值
奖励周期：“每天最多一次”即玩家每天只能获取一次奖励，若最佳成绩更新，会补足满足任务规则奖励和已获得奖励的差额奖励。“每次”即每次达成任务都能获得奖励。
字段说明（成就相关）
总体说明：成就可以是和任务同时获得，除了获取单次任务中的奖励外，还可以根据累积成绩获取成就奖励。
达成条件：一般设置为“总分”条件，其他选项均取值第三方调用我们提供的上报分数接口而获取的分数值。设置总分后，意味只要玩家持续挑战任务，获得总分超过达成条件则视为达成成就，并获得相应奖励
有效期：该成就显示在玩家勋章中的时长。
设置说明：
在新增任务中，玩法设置为游戏得分，并设置好排序即可。如果设置为计时，则将该项目的时间按顺序排行。
呈现效果：
设置说明：
在任务规则中，选择按得分倍数获得奖励，并选择积分即可。
在奖励周期中，选择每天最多一次。选择此规则之后，玩家当天玩同一个项目时，只会获得一次分数奖励，并且多次游玩时，如果下一次成绩比上一次好，则会补送最好一次成绩的奖励。
设置说明：
在任务规则，选择阶梯规则，并设置多个阶梯规则和获得的储值类型。设置后，系统会跟进获得的分数区间给予对应的储值奖励。
而任务周期，选择每次，代表每一次游玩都能获得奖励。
设置说明：
在任务和成就规则中，都有勾选奖励成长值的选项，勾选够，获得多少储值奖励也会同时获得对应数量的成长值。
然后再【会员自动升降级】中设置对应的成长值升级方案即可。
设置说明：
在成就一栏设置达成条件，并且上传对应的勋章图库即可。如有储值类型的奖励，可设置对应的奖励条件。
特别注意：分项得分功能，仅用于特定厂商的对接设备上传分值才支持，常规条件下只支持总分达成功能。
1.游玩分数查询路径
路径：【后台】→【报表】→【运动馆游戏分数查询】
说明：可以查询每一条玩家的打卡明细和任务成就完成情况
1.打卡终端反应不超过1S。
2.打卡终端打卡后无掉线情况。
3.各个项目玩法流程都需要测试一遍，并且每个项目能正常获得分数并显示在排行榜上。
1.打卡项目游玩玩法正确无异常。
2.打卡项目对应的游玩奖励设置正确。
3.打卡终端无掉线、高延迟情况。
4.打卡终端显示颜色符合客户要求。
5.打卡终端安装位置结实，无掉落风险。
6.打卡终端电源位置隐蔽，无漏电或者误触风险。
1. 若打卡成绩无在【运动馆游戏分数查询】中显示
需检查边缘网关状态，心跳恢复正常后会自动重新上报成绩
2. 打卡终端异常或更换绑定门店
需在原绑定的【游乐项目】中删除打卡终端，然后到游智云上解绑该终端后，再进行重置打卡终端流程。
3.新增打卡终端报错提示
22：找不到会员信息
27：该会员找不到套票
30：套票过期
4.按顺序打卡模式下，如果玩家没有按顺序打卡，被打卡终端屏幕会显示玩家应打卡的终
端序号。如：玩家打卡起点后，直接去打卡“03”的终端，“03”终端会报错，并显示
“02”的序号，提示玩家应该去打卡“02”号终端
5.现在玩家可以多次打卡同一打卡终端，但得分和时间只会记录第一次打卡的数据。
