文档说明

此文档用于指引如何配置新版运动打卡系统使用及功能使用。

功能说明

1.支持随机打卡获得成绩

2.支持按顺序打卡获得成绩

3.支持挑战类打卡，按最高成绩计算打卡成绩

4.支持达成一定成绩获得奖励

5.支持成绩展示在任务机中

所需工具

1.螺丝刀*1

2.电工胶布*1

3.斜口钳*1

4.显示屏*1（配置时需要）

5.鼠标键盘*1（配置时需要）

硬件支持

1.运动打卡网关（与氛围网关为同一设备，已有氛围网关则不需要额外使用），配套电源适配器一个。边缘网关版本：2026071702

2.互动打卡终端，若干，根据现场打卡点配置，需要根据数量配置变压器（电源适配器）

3.任务机（用于查询成绩使用）

硬件安装前置准备工作

1.打卡点位预留24V电源（0.5mm电源线）

方式一（推荐此方式：攀爬区等游客容易接触到的地方不建议直接预留220V电源，容易产生安全隐患）：

方式二：（适合于非攀爬类项目，游客不容易接触到220V的场景）

电线预留没有按标准要求预留，预留的电线电压是直接从总电机出来的220V，需要单独在每个预留的电线处，单独接变压器把电压装换成24V，再接入打卡终端电源正负极（此场景需要额外注意变压器的存放位置）

注意事项：24V电源线建议不超过50m，否则可能有电压衰减引起打卡终端不正常运作。

2.现场部署2.4G无线网络覆盖，需要设置固定的WIFI名称和密码

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配置文件打开直接复制该参数进去）

添加完成后需重启门店服务

3.（云服务器客户必要操作）提供加密狗编码给运维组（郑力宣），让他帮忙配置SSH。

4. 开通相关界面，需要开通以下界面：

a.潮玩运动任务成就

硬件安装流程

运动打卡终端安装说明

面板拆开：

底板固定（注意，底版位置有朝向箭头，请按朝向箭头进行安装）

并入预留的电线正负极：

盖上打卡终端外壳：

拧上固定螺丝，固定面板：

安装完毕：

运动打卡网关安装

接入到网络柜，通电，并将网线接入到与服务器同一个交换机中（云服务器则直接接入到主交换机即可）

硬件配置说明

互动打卡网关配置

设置目标

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

⑤在路由器中，添加MAC地址绑定IP地址功能（非常重要，路由器不设置静态，极有可能断电后IP地址会被乱分配，引起故障）

登录服务器对应的主路由，找到【静态地址分配】，以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：

名称：YOCQijyO2lZBkXZhLGkEKYkAU

密码：SrXo0JlHvQ7J4yDmXSPLIFPbg

进入AP路由器设置该WIFI信息

配置成功后，打卡终端会依次显示终端编码，如下图所示

运动打卡终端配置

第一步、新增【成就终端】功能的项目分类

路径：

连锁版：【总部】-【项目分类】

单店版：【终端】-【项目分类】

新增项目功能为“成就终端”的项目分类， 如下图所示：

第二步：新增游乐项目，项目类型需要设置为“成就终端”

路径：【门店】-【终端】-【游乐项目】

新增项目类型为“成就终端”的游乐项目，名称为该项目名称（此名称会呈现在任务系统中所显示的关卡名称）

第三步：对应项目绑定对应的打卡终端设备

路径：【门店】-【终端】-【游乐项目】

只有项目类型为“打卡终端”的项目才会显示“设置”操作按钮，点击进入【运动终端设置】页面，此处绑定打卡终端。

每个终端会轮放对应的2位数，底部小数点则为顺序，如下图所展示打卡终端编码为104696386

第四步：完成打卡终端配置

等待连接成功后，打卡终端会显示顺序序号，证明已经连接完成。

注意事项：

1.同一个项目下配置打卡终端时，如果有开始和结束这种项目，务必第一个绑定为开始的打卡终端，最后一个配置是结束终端

2.单个项目可设置到

软件场景配置说明

项目游戏设置

总体说明

项目游戏设置用于设定该项目完成的条件和分值计算逻辑，玩家需要满足该逻辑才算游戏结束并获得分数奖励。

字段说明

打卡得分：开启后，每打一个终端，则直接获得得分

随机打卡：当开启打卡得分后，每个终端可单独设置对应的分数，随机打卡则获得对应的分数。可同时设置最对打多少卡才有分数和封顶能获得多少分数（达到最低要求打卡数后会一次性计算所有的分值）。使用随机打卡是，同一个终端只能获得一次分值。

顺序打卡，分数相加：当开启打卡得分后，每个终端可单独设置对应的分数，需要要求玩家依次打卡才能获得积分，跳过顺序是无法完成打卡并显示X的标识。

去

计时得分：开启后，计算从标记为开始的终端开始，计算到最后一个标记为终点的终端的总时长，根据时长进行得分。（一次性计算）

计时规则：用于设置起点到终点每个等级的具体时间段及对应获得的额外得分。

游戏超时：设置后，超过设置的时间则代表此项目游戏结算，并结算获得得分。后续在打卡也不会再获取得分。

超时没有成绩：勾选后，超时没有成绩（包括打卡得分的成绩），不勾选则会直接结算已有成绩。

特殊设置逻辑

1.如果想设置打卡封顶分值，可设置有效至少打卡数为0，并设置累计封顶多少分。

2.只有1个打卡终端时，不支持设置计时得分和超时没有成绩这两个功能。

场景一：每到一个打卡点获得固定分数奖励，并根据完成速度获得额外分数加成，并且每个打卡点路径是固定，玩家需要依次寻找打卡点进行打卡。

案例：迷宫项目，玩家进入迷宫后，需要在迷宫正确路线中打卡，每完成一段迷宫获得分数，并根据用时越短获得额外分数越多。

设置参考：

场景二：要求玩家在一个环境内寻找打卡点，并且要求至少完成多少打卡点才算通关，全部打卡成功后，可额外计算时间成绩。

案例：寻宝项目，玩家进入寻宝区域后，需要区域中找到宝藏，至少找到特定数量的宝藏则代表通关，假如全部找到后，如果满足特定时间还能获得时间得分。

设置参考：

场景三：游玩区域有多个打卡点，不同打卡点的因位置不同难易度也不同，玩家只需要尽能力打力所能及的打卡点即可获取相应分值

案例：按难度划分的攀爬项目，玩家可挑战不同难度的攀爬项目来获取分值完成挑战。难度越高获得的分值越高。

设置参考：

场景四：玩家打卡第一个点开始计时，然后开始闯关，直到终点打卡成功为结束，按照时间成绩计算得分。

案例：障碍跑，玩家需要以最快速度通过所有的障碍并到达终点。（时间越短得分越高）；举重，玩家举起杠铃，根据维持举起动作时间长度来计算成绩（时间越长得分越高）。

设置参考：

得分后奖励设置

总体说明

目前新版互动打卡能获得的奖励分两种，一种是储值类的奖励，通过设置【任务】获得，一种是勋章，通过【成就】获得。每个独立的项目只可以设置一种类型的【任务】和【成就】。

常见玩法问题

1.我想实现能力值的体现，可以实现吗？

答：如果所有储值都不使用的情况下，可以实现，只要把储值类型的名称改为对应的能力值名称即可，比如【代币】可以更名为【力量】、【金币】更名为【敏捷】等。配合【新运动馆】的小程序界面，玩家就可以清楚看到自己的能力值。

2.如果想实现持续游玩可以获得经验，并形成不同的等级，如【新手】【学徒】【资深】【大宗师】等不同等级。可以实现吗？

答：可以，在设置对应的任务或者成就时，勾选获得成长值即可，配合【会员自动升级】功能即可实现游玩→完成任务→获得经验→累积经验升级这个流程闭环。

3.在问题一中，相关能力值有哪些好用吸引的点？

答：常见的推广方式有：献祭一定能力值可获取神器（礼品兑换）

4.相关的任务以及获得的能力玩家可以从哪里查看到？

答：【新运动馆】的小程序界面中，【任务】功能可以查看到。

设置说明

路径：

【后台】→【会员】→【潮玩运动任务成就】

设置方法：

点击新增，添加对应游玩项目的任务或成就。

字段说明（任务相关）

项目：选择需要设置的游玩项目，显示所有的项目类型为模拟机、成绩终端。

玩法：设置该任务成就的属性，会体现在任务机和小程序中。其中，游戏得分，根据打卡分数来获取奖励，并在任务机中安分数显示排行；而，计时（秒）根据打卡总时长来获取奖励，在任务机中则按时间显示排行。

任务规则：根据所选项设置“阶梯规则”、“按得分倍数奖励”。填写时，如果选择阶梯规则，前者匹配的是分数，后者匹配的是奖励的储值数量及对应的储值类型。如果选择【按得分倍数奖励】，则代表玩家完的分数会直接按比例转换成奖励的储值数量及储值类型。

奖励同等数量的成长值：勾选项，勾选后，可奖励达成任务规则奖励储值的同等数量的成长值

奖励周期：“每天最多一次”即玩家每天只能获取一次奖励，若最佳成绩更新，会补足满足任务规则奖励和已获得奖励的差额奖励。“每次”即每次达成任务都能获得奖励。

字段说明（成就相关）

总体说明：成就可以是和任务同时获得，除了获取单次任务中的奖励外，还可以根据累积成绩获取成就奖励。

达成条件：一般设置为“总分”条件，其他选项均取值第三方调用我们提供的上报分数接口而获取的分数值。设置总分后，意味只要玩家持续挑战任务，获得总分超过达成条件则视为达成成就，并获得相应奖励

有效期：该成就显示在玩家勋章中的时长。

其他功能说明

1.游玩分数查询路径

路径：【后台】→【报表】→【运动馆游戏分数查询】

说明：可以查询每一条玩家的打卡明细和任务成就完成情况

异常情况

1. 打卡终端刷卡时显示“22”报错

需检查门店后台是否已添加参数：YZYProjectModelID=5f3f7b71-938a-4558-ba2c-81d89382e56a

2. 若打卡成绩无在【运动馆游戏分数查询】中显示

需检查边缘网关状态，心跳恢复正常后会自动重新上报成绩

3. 打卡终端异常或更换绑定门店

需在原绑定的【游乐项目】中删除打卡终端，然后到游智云上解绑该终端后，再进行重置打卡终端流程。