文档说明

氛围系统功能核心包含以下内容：影音功能、灯光功能以及彩票竞技赛等相关功能。该功能配置教程说明如下。

氛围系统图链接参考图

前期准备

客户准备阶段

参考文档如下：

《氛围系统前期准备工作说明》

实施安装准备阶段

1.联系销售，开通系统氛围功能

2.升级软硬件版本

娱乐管家：V10.4.2190或以上
边缘网关版本：2026031701以上

影音盒子：V1.1.8以上

抽奖机版本：V1.0.5以上

抽奖机卡头版本：V1.0.0以上
卡头版本：目前只支持钻石V9，V321及以上版本

3.开通氛围设置的账号以及开通游乐掌柜设置功能

建议施工时间

工作日白天时间（需要授权开通部分功能）

安装调试说明（氛围主机）必要设置

第一步，开启系统的氛围系统功能

①联系助理开通对应的氛围系统功能，如果已经确认开通后，将门店编码发送给实施组组长或者其他有权限卡通该功能的人员进行开通

②确认氛围系统的界面是否已经齐全

界面包括【彩票竞技赛】【摇一摇】

第二步，娱乐管家系统开起氛围功能

①进入【技术支持设置界面】

路径：后台→右上角→选择系统信息

在下图位置连续点鼠标5~10次

② 在娱乐管家后台系统添加settings参数

路径：技术支持专用界面→settings管理→增加

点击该界面，点击增加，并输入：

key输入OpenServerEvents

Value输入1

注意：除此方法外，也可以直接在系统安装目录下找到settings配置文件，并直接在配置文件中添加参数为 

OpenServerEvents=1

上图为直接在【技术支持】网站中添加的图，下图为settings配置文件中添加的图（2选1来执行即可）

③开启SSE通讯

路径：技术支持界面→网关设置→开启SSE通讯

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

⑤等待运维配置完毕后，重启娱乐管家服务。

第三步，接入氛围网关主机

说明：此步骤中的氛围网关主机原则上只需要接入网线和电源即可。但是配置阶段时，还需要接入显示屏、鼠标以及键盘来进行配置。

①接线如下图

正面需要接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：如何验证氛围网关主机是否正常

a.下载Xshell安装包
在本地服务器电脑或者跟任意一台跟网关盒子同一局域网的电脑上，下载安装Xshell程序
下载链接：https://pulic.oss.youcaihua.net/高晓钦/Xmanager_Enterprise_5.zip

其中安装时，产品密钥输入压缩包里面的注册码，然后按默认选项来安装即可。

b.安装成功后，打开程序Xshell。

C.点击【新建】

d.输入主机，主机填氛围网关IP地址

e.选择左边的用户身份验证，输入对应的账号密码,并点击确定

账号：nk343

密码：youcaihua

f.在会话界面，选择刚刚新增的会话，并点击【连接】

g.依次输入以下命令

1. 输入：sudo su 回车

2. 输入密码：youcaihua 回车

3. 校验日志：tail -f /usr/local/ych/yzygame/catalina.out   注意 -f 之后有个空格

4. 出现：“心跳包发送成功”字样为成功

常见问题2：异常报错常用命令

a) 关闭服务：killall EdgeGameApp
b) 启用服务：bash /usr/local/ych/yzygame/check.sh
c) 查看日志：!tail
d) 停止日志滚动：按Ctrl C 

常见问题3：提示SSE通讯关闭

若是本地服务器，检查【运动打卡设置】-【门店配置】的“业务后台地址”是否填写了域名。

若是云服务器，检查技术后台【网关设置】是否开启SSE通讯，开启后需重启门店服务，或者是尚未联系运维同事在nginx上配置SSE服务。

常见问题4：网关盒子更换过位置和网线端口

需在门店后台【运动打卡设置】-【门店配置】重新保存，且点击重启边缘网关。

安装调试说明（影音盒子）

影音盒子外观

接线说明

1.影音盒子接入局域网网线，网线需要接入到与氛围网关主机同一个交换机（推荐使用），如无条件则可以通过链接WIFI使用。

2.视频输出（HDMI接口）接入到电视中。

注意：部分场地可能需要同一个内容显示在不同电视上时，可根据现场情况使用分屏器来分屏复制显示。

3.音频输出（3.5mm音频接口）接入到场地功放中。

注意：当未接入音频输出端时，氛围系统声音默认从HDMI中输出，并在电视上播放。

4.电源线接电。

5.（调试时可接）USB接入键盘和鼠标，用于调试时使用，非必要，也可以直接通过遥控器进行遥控。

6.（非必要）分屏器说明：目前使用的分屏器有两款，一种是一拖七，HDMI线转网线进行传输，末端再从网线转回HDMI接入电视，可获取更远的分屏范围（注意网线最大不超过60米）；另一种是一拖四，一根HDMI线分四根HDMI线。

一拖七优势：传输距离远，最大可以分7个电视来接。

一拖四优势：简单易接，最大可接4台电视，但是适用距离较近。

安装固定说明

1.如果使用WIFI连接时，需要WIFI天线尽量外漏，并且不要碰到金属。

2.遥控接收端尽量往外对，方便遥控来进行控制

影音盒子放置建议

1.由于影音盒子需要控制声音，所以建议音影盒子放置在门店的音箱功放控制器中，因为音频线一般无法接太远。

2.氛围系统虽然支持上传MP3文件来进行播放背景音乐，但是使用体验较差，一般会搭配混响器一起使用（需要客户额外购买），推荐购买链接：【淘宝-混响器】

3.如果确实视频显示和音频分隔距离太远，那就只能分别通过2个影音盒子来进行控制。

影音盒子调试步骤

请参考此文档《氛围系统-影音盒子配置》

安装调试说明（灯光盒子）

请参考《氛围系统-灯光盒子配置》

功能说明

1.彩票竞技赛

请参考《彩票竞技赛》

2.摇一摇活动

支持版本：

请参考《摇一摇活动》

其他功能明细待补充中......