文档说明

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

功能说明

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

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

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

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

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

所需工具

1.螺丝刀*1

2.电工胶布*1

3.斜口钳*1

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

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

硬件支持

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

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。

硬件安装流程

运动打卡终端安装说明

面板拆开：

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

并入预留的电线正负极：

盖上打卡终端外壳：

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

安装完毕：

运动打卡网关安装

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

硬件配置说明

互动打卡网关配置

设置目标

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个打卡终端时，不支持设置计时得分和超时没有成绩这两个功能。

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

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

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

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

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. 打卡终端异常或更换绑定门店

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