文档说明

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

功能说明

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

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

硬件安装流程

运动打卡终端安装说明

面板拆开：

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

并入预留的电线正负极：

盖上打卡终端外壳：

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

安装完毕：

运动打卡网关安装

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

配置说明

互动打卡网关配置

设置目标

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分钟，后续修改以上内容均要点击重启边缘网关）。偶尔出现无效的情况时，可手动直接在边缘互动打卡网关主机中手动重启生效。

实际案例效果图：

运动打卡终端配置及娱乐管家后台设置

娱乐管家

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

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