文档说明

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

功能支持

1.支持电视显示控制，可播放视频、图片等功能。

2.支持灯光控制，包括闪烁、流水、常亮等模式选择

3.支持播放背景音乐

4.支持定时广播和插播广播功能，并支持AI文字自动转化成播报语音功能。

5.支持按不同区域划分来展现不同风格的视频、音频、图片、灯光效果等。

6.支持彩票竞技赛。

7.支持展示特定的本地会员任务功能。

8.支持展示大额充值展示功能。

9.支持摇一摇功能。

10.支持播报高级会员到店提醒

11.支持玩家抓到娃娃播报新讯功能

氛围系统图链接参考图

前期准备

客户准备阶段

参考文档如下：

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

实施安装准备阶段

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口，用于接鼠标和键盘使用（特殊情况调试时才需要，后续运行时可不用）

背面需要接网口（只需要接其中一个，接入到和服务器同一个交换机中）以及电源接口即可。

②按开机键开机

注意：目前只需要等网关自动获取IP地址即可，不需要固定IP了

第四步，在娱乐管家系统配置氛围网关主机

路径：【会员】->【运动打卡设置】->【门店配置】->【边缘网关】

核心需要填写的内容

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服务。

③检查门店后台的隐藏后台【Setting管理】参数OpenServerEvents=1 是否已新增，新增后是否有重启服务器。

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

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

常见问题5：Xshell显示：获取不到业务系统地址

检查门店后台【运动打卡设置】【门店配置】【边缘网关】的“业务后台地址”被修改

这个问题很常见，氛围系统有异常可优先查看这个位置“业务后台地址”是否被修改，本地服务器需修改为 IP + 端口，云服务器需修改为 域名 + 端口。

修改完成后，需要点击保存，和重启边缘网关按钮

若是本地服务器，建议清空【卡头wifi通讯设置】【重新设置通讯网络】弹窗中的“外场”域名和端口，这里的信息保存会影响到【边缘网关】的设置

常见问题6：Xshell上一直显示：收到MQ消息……

这个问题会在影音盒子断电重启或手动重启后概率出现。该消息为影音盒子重启后推送消息给网关，但网关没有响应导致，且会在链接影音盒子的屏幕上显示“氛围主机未推送节目”的报错提示

a. 确认云服务器的门店是否已联系运维同事在 Nginx 上已配置SSE通讯

b. 在【卡头wifi通讯设置】【重新设置通讯网络】中，清空内场的IP 和端口，随后返回至【边缘网关】，点击重启边缘网关按钮

开通氛围系统账号功能

1. 需要在系统新建好账号

2. 开通游乐展柜功能，并且在游乐掌柜功能中开启氛围系统权限

3. 微信小程序搜索游乐掌柜，若使用的微信手机号是已经分配了该权限，则直接授权登录，在游乐掌柜页面点击【氛围系统】

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

影音盒子外观

接线说明

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

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

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

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

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

4.电源线接电。

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

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

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

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

接线原理图如下：

安装固定要求

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

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

3.如有条件，影音盒子用自攻螺丝进行固定，或者使用3M双面胶进行固定，务必确保影音盒子不能掉落。

影音盒子放置建议

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

2.氛围系统虽然支持上传MP3文件来进行播放背景音乐，但是使用体验较差（一方面因为版权问题MP3格式的音乐文件很难找，另一方面是上传比较麻烦），一般会搭配混响器一起使用（需要客户额外购买），使用混响器就可以实现同时输出电脑音频和影音盒子音频，推荐购买链接：【淘宝-混响器】

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

影音盒子调试步骤

1.影音盒子联网

情况一：影音盒子端有预留网线，直接接网线即可（推荐接网线）

情况二：影音盒子端没有预留网线，需要接入无线（请按下面步骤进行无线联网）

①准备一个显示屏幕， 用HDMI线连上影音盒子，影音盒子接上键盘鼠标，在影音盒子待机桌面鼠标右键点3次，跳转到影音盒子桌面程序

②连接屏幕后，进入到应用菜单界面，选择“设置”应用

③点击“网络和互联网”，进入Wifi连接配置，并链接到局域网无线网络。

注意：影音盒子的网络必须与氛围网关同一个网络下，并且可以互相通讯。

2.配置绑定影音盒子

进入到手机端的氛围系统界面，按下面操作进行绑定

常见问题

《氛围系统影音盒子开机时会出现死机情况解决方法》

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

灯光控制盒外观

①灯光控制盒主体外观

②灯带信号放大器外观

如何判断是什么灯带

说明：灯带种类主要看灯节与灯节之间的接口。如下面说明：

灯带相关说明

灯带控制原理

单色灯带

因单色灯只有电源正极（12V/24V）和电源负极（GND），所以此类灯带只有开启和关闭的状态，通过快速变换开启和关闭实现闪烁功能。

RGB灯带

RGB灯带有较多种类，常用的种类接口为W、R、G、B、12V。通过不同接口发出不同的灯光颜色以及灯光亮度实现彩色效果。如红色灯+蓝色灯同时亮就可以产生紫色灯的效果。

对应接口说明：

12V/24V：为整个灯带的供电接口。有5V/12V/24V三种规格。（灯光氛围盒子必接）

W：为白光的负极接口，同时接通12V和W，则灯带显示白光。（部分特殊灯带会额外有WW和CW，指代的是暖白和正白效果灯）（灯光氛围盒子不需要接）

R：为红光的负极接口，同时接通12V和R，则灯带显示红光。（灯光氛围盒子必接）

G：为绿灯的负极接口，同时接通12V和G，则灯带显示绿光。（灯光氛围盒子必接）

B：为蓝灯的负极接口，同时接通12V和B，则灯带显示蓝光。（灯光氛围盒子必接）

幻彩灯带

幻彩灯带每一颗灯珠自带驱动 IC，可单独设置颜色、亮度，能实现流水、渐变、动画、文字、图案、声控律动等复杂效果，统称幻彩像素灯。常见的幻彩灯接口有VCC-GND-C0/C1-D0/D1，对应接口说明如下：

VCC：电源正极（常见为12V/24V）

GND：电源负极（灯光氛围盒子必接）

D0/D1：信号输入，用于接入信号源，用于控制灯的效果（灯光氛围盒子必接）

C0/C1：备用信号源

接线原理

单色灯带

RGB灯带

幻彩灯带

注意事项：灯带电源盒需要合理结算灯带所需电源盒功率，避免功率不足导致异常。一般5~10米之间增加电源盒进行补电。计算功率/电流时，需要在灯带所需的额带功率基础上乘以1.3倍以上作为冗余，避免在使用灯带效果时引功率不足导致无法实现相应效果。

灯光盒子绑定系统配置方式

1. 登录游乐掌柜，并打开氛围系统

2. 手机打开蓝牙功能

3. 按照下图操作，给灯光盒子进行联网

功能说明

场景一：希望电视可以显示门店的推广套餐，或者播放宣传视频

效果图

操作说明

第一步：将素材都存放到手机中（支持图片素材、视频素材以及音频素材）

a 如果是其他同事处理好的素材通过微信转发给你，建议可以保存到手机中（这样可以进来保存原图，清晰度更高）

b 如果是电脑文件，建议可以通过微信的文件传输助手功能，传输到手机微信中。

无论哪种情况，后续操作都是通过微信直接上传上去。

第二步：在微信搜索游乐掌柜，并登录进去，依次打开【店务】→【氛围系统】

第三步：点击氛围系统中的【素材】，点【上传】，将素材上传上去

注意事项

1.上传的素材，仅只有你自己的手机能看到，其他的手机是无法看到已上传的素材

2.素材可以重复使用，只要不删除，可以一直引用素材

3.删除素材库是不影响已经在轮播的内容。

第四步：点击【设备】，选择你要展示图片/视频的区域，并选择【节目】，在节目点击【图片】【视频】【榜单】任意一个添加你要播放的内容，点进去后，就可以选择刚上传的素材，点击对应素材，完成设置。

注意事项

1.图片是可以设置每张图片显示多少秒。

2.如果是视频，可以设置有声音还是无声音，如果是需要有声音，点一下“屏幕轮播”傍边的喇叭即可切换。

场景二：门店想设置每隔一段时间播放安全须知等内容。

常见应用案例

电玩城：每隔30分钟播放一次禁止吸烟提醒。

儿童乐园：每隔30分钟播放一次提醒家长看管小孩注意事项。

操作说明（以AI生成播报语音为案例进行说明）

第一步 点击【设备】，选择播放区域并点击【音乐】，进入到设置界面

第二步，点击【添加】，并点击【AI语音合成】

第三步 输入你要合成的语音播报的内容，并选择音色进行合成

第四步 等待合成结束，并试听效果，确认无误后，点击确定保存素材。

第五步 点击选中生成的素材，并设置播报间隔，完成设置

其他额外功能：背景影音播放

在音乐这个界面，可以在【音乐】一栏添加MP3音乐用于背景播放

MP3文件可使用以此网址免费下载：明月浩空音乐 - 免费多站合一音乐搜索

注意事项：

1.生成后的素材，在素材库可以重复调用，但只能是生成人才能调用

2.删除素材库的记录不会影响已经设置好的语音播报功能。

3.支持自己录制语音（即不适用AI语音生成功能）然后上传播报。

场景三：门店想插播寻人启示或实物认领等临时播报。

常见使用案例

小孩自己走丢，需要工作人员帮忙喊麦找父母。

具体操作步骤

第一步，在氛围系统【设备】界面，点击【插播】

第二步 通过AI生成插播的内容（也支持直接上传语音）

第三步 可选择模板生成插播内容，也可以手工输入插播内容。模板生成需要修改相关的内容后再生成。

第四步 试听插播内容是否正确后，选择播放次数以及播报间隔，点击马上插播即可完成。

注意事项：

1.插播内容不会生成素材库，所以每次插播都是一次性素材；

2.插播优先级比较高，所以直接插播会直接广播相关内容。

3.AI语音的好处是咬字清晰，效果较好，除非门店有专业的广播员，否则都建议用AI语音生成。

4.门店的影音盒子必须接入门店音箱中的音频线，否则无法实现相关播报功能

场景四：门店希望在人流高峰期通过摇一摇功能炒热气氛

功能说明

摇一摇功能可以在特定时间，通过屏幕显示摇一摇活动并对活动进行广播，让玩家在游玩之余参加摇一摇小游戏，赢取丰厚的储值奖励或实物奖励。通常建议在举办某一些活动前开启该功能，以此来吸引玩家注意力，提高接下来的活动的参与度。

活动效果图

报名阶段的电视画面

活动中的电视画面

活动结束的结算电视画面

参与者的手机画面

建议活动流程

流程核心：①提前预热；②现场造势；③延续热度。

注意事项

设置注意点： 【防止薅羊毛】、【活动奖励】、【语音播放内容】、【门店定位】

具体操作步骤

第一步，登录游乐掌柜，并打开氛围系统功能，选择【场景】，开启摇一摇功能，并设置摇一摇活动每隔环节与现场哪些灯光进行联动（需要有灯光盒子硬件支持）

勾选所需要显示摇一摇活动的氛围区域，可配合【灯光盒子】设置摇一摇活动各阶段的灯光氛围。

第二步，新增摇一摇活动

路径：【小程序】-->【营销活动】-->【氛围摇一摇】-->【新增】

第三步，设置摇一摇具体内容

字段说明

活动名称：可设置重复的活动名称。

开始时间：设置开始时间，到点后自动开始摇一摇活动，因定时任务为1分钟执行一次，所以建议设置的活动开始时间与当前时间间隔大于1分钟。

防止薅羊毛：可设置每个手机号参与每天一次（默认勾选），会判断同一手机号是否在历史活动中有参与；距离门店X米，根据【小程序】-【门店资料维护】中设定的门店定位来作圆心判定玩家当前距离。

报名限时：氛围大屏上会显示活动报名阶段，该限时为参与人员扫码报名期限。

比赛时长：氛围大屏上会显示活动开始阶段的活动结束倒计时。

活动排名显示：氛围大屏上会显示活动结束后的获奖排名页面，页面显示倒计时。

奖品：弹窗设置每个排名或排名区间的奖品，排名不可重复。

氛围语音：已接入AI语音包，可根据所填内容生成摇一摇活动各阶段对应的语音播报。

注意： 当会员获得排名时，奖励是会自动下发的，包括实物商品

第四步，完成设置，等待活动开始

活动创建成功后，应显示如下状态，且根据设置的“开始时间”会自动开始活动。

其他列表功能说明

1.如何查看哪些会员参与活动以及奖励发放情况

答：摇一摇活动结束后所有参与活动的会员数据均记录在【营销】-->【摇一摇活动】-->【活动详情】

奖励发放情况状态分别为：处理中、已发放、发放失败，其中，处理中状态为系统自动发放奖励任务执行中，发放失败状态会有相应失败原因文案记录在“错误信息”中，且可进行手动“重发”操作。

2.如何在活动前进行广播

答：参考场景二的内容。

3.设置内容太多，我是否可以复用上一次设置的活动内容，修改一下开始时间即可再次举行？

答：可以的，在上一个活动操作一栏点复制即可。

场景五：门店希望通过举办彩票竞技赛来提升彩票机游玩率

功能说明

门店可创建彩票竞技赛，玩家游玩指定彩票机台即可参与活动，在规定活动时间范围内，玩家从彩票机台获取的彩票数越多，排名就越高。活动结束后，玩家可根据活动结束时的排名名次获取对应的名次奖励，期间无需额外支付任何储值，其本质就是一个冲榜活动。

注意事项

1. 彩票竞技赛是基于卡头获取彩票的数据进行统计，因此不建议出奖率特别大的机台进行比赛。因为出奖率大的机台在活动开始前可能已经在出彩票，此时举行比赛实际只是在比较机台的出彩票速度，没有太大意义；

2. 彩票竞技赛比赛机台，建议取用出票速度相近机台，公平性会更好。

活动效果图

报名阶段电视显示

报名阶段卡头显示

比赛阶段电视显示

比赛阶段卡头显示

活动结束电视显示

活动结束卡头显示

具体操作步骤

第一步，新增彩票竞技赛活动

在【营销】-->【彩票竞技赛】-->【新增】

第二步，设置具体活动内容

字段说明

活动名称：活动名称可重复。

开始时间：设置活动开始时间，到点自动开始大赛，两活动之间开始时间间隔需大于1小时。

适用机台：读取所有机台类型为彩票机，状态为开启的机台。

参与条件：需会员在卡头投币多少数量才能参与活动，例如：设置数量为10，则会员需在卡头上刷卡、实物币等方式投币数量达到10，参与成功会点亮氛围大屏幕对应的机台P位。

报名时限：参与活动报名倒计时，会显示在氛围大屏幕，若倒计时结束没有会员达成“参与条件”，活动自动结束。

获胜条件：活动获取第一名的条件，一旦达到即结束活动，若无人达成将持续保持活动进行中。例如：设置累计存票>=1000，会员累计存票或出票达到1000，即会结束比赛。

奖品：可按单独或范围排名设置对应奖品，比赛结束后需手动派发。其中，设置“获奖最低票数”，即会员需存票或出票达到该数量，才能有派发奖品资格。“实物商品”非系统配置的商品，一般是线下商品派发，不参与系统库存等统计。

报名阶段、比赛开始、获奖语音：已接入AI语音包，可根据所填内容生成语音播报。“报名人数”、“获奖机台”填写后会自动填充活动报名成功的总人数，和获取第一名的机台名称与P位。

奖励设置：可设置对应的名次奖励、达到对应名次的彩票数量

第三步。完成活动设置

活动创建成功后显示如下：

注意观察活动方案的活动状态，正常情况应显示进行中。

场景六：门店希望重要VIP玩家到店有播报提醒

功能说明

指定VIP会员在各个设备终端登录即会触发播报提醒 （如收银台登录、卡头登录、自助设备登录等），服务人员以此为提醒针对性对指定VIP客户到店提供专属服务。

效果图

具体设置步骤

第一步，通过游乐掌柜打开氛围系统，并依次点击【场景】→开启【VIP会员到店】

第二步，设置VIP到店规则

在设置界面，可设置对应的区域播报范围，以及哪些会员等级会触发欢迎语。并设置相关欢迎语文案用于播报。以及灯光效果（建议灯光效果使用闪烁效果，效果更佳）

注意事项

使用VIP会员到店功能建议只针对最高等级会与进行播报，减少过多播报而导致效果降低。另外建议门店搭配会员升降级功能配合使用，提高门店高质量会员的粘性。参考操作：如何设置会员自动升降级？

场景七：门店希望玩家捉到娃娃时全场播报并联动灯光进行闪烁

触发前提

1. 场地礼品机需要安装油菜花卡头，且有接入礼品线

2. 场地有接入影音盒子，影音盒子同时接入电视和广播

3. 场地有接入灯光盒子，配合灯光氛围效果更加好（非必要）

触发机制

当客户在装有卡头的娃娃机上抓到娃娃时，即可触发。散客、会员均可触发。

具体设置步骤

第一步，提前准备好抓中娃娃播报视频，可自己制作，或下载默认模板。建议下载到手机中，方便后续上传。

默认模板下载链接如下：抓娃娃效果视频.mp4

注意：升级到10.4.2346以上的版本会自动带有默认视频

第二步，通过游乐掌柜打开氛围系统，并依次点击【场景】→开启【玩家捉到娃娃】

第三步，设置抓到娃娃的相关氛围设置

在【设置】里面，我们则可以根据现场情况，选择抓到娃娃后联动的氛围设备区域范围，并可设置哪些机台才会触发播报。

播报时，需要选择一个夹中娃娃时的播放视频，可采用步骤一中的模板视频，也可以自定义制作视频。

最后选择对应联动的灯光氛围效果（建议选择闪烁，效果较佳）

第四步，如果想设置不同机台抓中播报不同的效果，可在底部选择增加新规则， 按照步骤三的方式再设置一个。

步骤五，全部规则设置后，点击保存完成设置。

场景八：氛围系统联动抽奖机实现全场播报

功能说明

抽奖机是可以联动全场氛围系统，当玩家通过抽奖机抽到奖项时，全场电视、音箱及灯光可以联动播报恭喜玩家。

展示效果

具体操作步骤

第一步，配置好抽奖机

参考文档：抽奖机操作说明

第二步，通过游乐掌柜打开氛围系统，并依次点击【场景】→开启【抽奖机中奖】

第三步，点击【设置】，对播报效果进行设置

设置播报的氛围设备范围，以及灯光效果，点击保存即可。（建议使用闪烁效果，氛围感更好）

测试标准