# 如何配置小度音箱（酒店版）？
#1. 客控配置流程图
#2. 配置操作
#2.1. 登录小度开放平台
小度开放平台网址：https://dueros.baidu.com/business/emp/view#/ ；
注册百度账号并登录；
进入「开放平台」，点击「项目管理」的「立即进入」按钮；
#2.2. 新建项目
点击「新建项目」；
在「创建项目」页面填写选择所用的音箱版本;
准确填写项目信息，并提交审核；
提交后需要一定时间，等待官方通过；
可以在「我的项目」里看到项目的审核进度，通过的项目将在卡片上显示“审核通过”字样。
#2.3. 配置客控技能
在「我的项目」中找到项目，点击「管理项目」；
在「项目详情」，找到「开发者配置」下的「接口授权」选项，点击「新增客控技能」；
填写庆科提供的客控技能ID：9b8712a0-4025-03e2-260c-07d238db9941，点击「确定」；
技能名称为飞马智能-客控技能；
注：如果需要配置设备厂商专属小度技能，请联系设备厂商管理员获取专属技能id。
#2.4. 添加音箱配置人员账号
在「项目详情」，找到「平台账号服务」下的「角色管理」选项，点击「+新增角色」；
添加音箱配置人员的角色，赋予“设备列表”和"扫码工具"权限（或者直接赋予管理员权限）；
「项目详情」，找到「平台账号服务」下的「用户管理」选项，点击「+添加用户」；
在窗口填写用户信息，并勾选刚刚创建的角色，点击「确定」保存。
注意：百度用户id参数，通过鼠标移入到百度账号上进行获取，如下图：
#2.5. 激活音箱
#2.5.1. 下载安装小度酒店版APP
扫描下方二维码安装小度酒店版APP，ios系统也可以在应用商城（App store） 搜索【小度酒店版】下载：
#2.5.2. 登录小度酒店版APP
使用百度账号登录小度酒店版APP.
#2.5.3. 扫码激活
在小度酒店版APP界面点击扫码激活音箱；
激活音箱时，勾选“飞马智能-酒店客控”技能；
#2.6. 导出“设备列表”
登录小度开放平台，在「项目详情」页面中的「设备管理」中选中「设备列表」点击页面「下载当前表格」；
下载后的表格如下图，包含了「房间号」「序列号」
#2.7. 在客控系统中添加音箱
#2.7.1. 登录庆科客控平台
庆科客控平台网址：https://hotel.mxchip.com。
通过管理员提供的账号密码登录；
#2.8. 添加小度音箱
进入「音箱配置」，点击「添加音箱设备」；
在窗口选择添加小度音箱，并填写“设备列表”表格中的「序列号」，点击「确定」保存。
#3. 如何控制设备
#3.1. 发现设备
对小度音箱酒店版，发出“发现设备”语音指令，小度音箱会报告发现的设备数量。 注意：在房间的设备或场景发生变化后，均需要对小度音箱发出"发现设备"的指令，以便于小度音箱获取最新的设备和场景信息，进行调用和执行。
#3.2. 控制设备
对小度音箱酒店版，发出控制设备语音指令，执行控制并查看结果。 注：在执行控制设备前，需要先执行“发现设备”。
#4. 支持的控制指令集
目前在酒店场景下，支持以下泛化：
场景模式 | 支持表达泛化 | 客控接收指令 | 场景描述 |
睡眠模式 | 我要睡觉了、晚安、我要睡了 | 打开睡眠模式 | 关闭窗帘、打开夜灯、关闭其他所有灯、空调调到26度 |
起床模式 | 我要起床了 | 打开起床模式 | 打开遮光帘、关闭纱帘、打开所有灯 |
工作模式 | 我要工作了 | 打开工作模式 | 根据房间实际布局场景制定 |
沐浴模式 | 我要洗澡了 | 打开沐浴模式 | 打开浴室灯/卫生间灯、关闭浴室窗帘 |
明亮模式 | 房间好暗啊 | 打开明亮模式 | 根据房间实际布局场景制定 |
柔和模式 | 房间好亮啊 | 打开柔和模式 | 根据房间实际布局场景制定 |
以下是酒店场景下通用的客控设备基本的分组/别名要求：
设备类型 | 建议设备名称 | 建议非套房分组名 | 建议套房分组名 | 建议设备别名 | 小度支持的客控query示例 | 房间期望实现的场景 |
灯 | 所有灯 | 房间 | 全部灯、全部的灯、所有的灯、客房灯、客房所有灯、客房全部灯 | 打开/关闭所有灯 | 打开/关闭客房内所有灯光 | |
客厅灯 | 房间 | 客厅 | 开/关客厅灯 | 打开/关闭客厅所有灯光 | ||
卧室灯 | 房间 | 卧室 | 卧室灯、房间的灯、房间灯、房间里的灯 | 打开/关闭卧室灯 | 打开关闭卧室范围的灯 | |
卫生间灯 | 卫生间 | 卧室/客厅 | 厕所的灯、卫生间的灯、洗手间的灯、洗手间灯、浴室的灯、淋浴间的灯、卫浴灯、浴灯、洗浴灯 | 打开/关闭卫生间灯 | 打开/关闭卫生间的灯、镜前灯、以及床头夜灯亮起/熄灭、打开/关闭卫生间排风扇 | |
阅读灯 | 房间 | 卧室 | 读书灯、阅读的灯 | 打开/关闭阅读灯 | 卧室的左右阅读灯亮起/熄灭(左右需实现独立语音控制) | |
左阅读灯 | 房间 | 卧室 | 左边阅读灯、左侧阅读灯、左边的阅读灯 | 打开/关闭左阅读灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | |
右阅读灯 | 房间 | 卧室 | 右边阅读灯、右侧阅读灯、右边的阅读灯 | 打开/关闭右阅读灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | |
廊灯 | 房间 | 卧室/客厅 | 走廊灯、（或者根据现场情况添加为夜灯） | 打开/关闭廊灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | |
夜灯 | 房间 | 卧室/客厅 | 根据现场情况可添加为廊灯、走廊灯 | 打开/关闭夜灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | |
镜前灯 | 房间/卫生间 | 卧室/客厅 | 镜灯、镜前灯 | 打开/关闭镜前灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | |
落地灯 | 房间 | 卧室/客厅 | 打开/关闭落地灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | ||
吊灯 | 房间 | 卧室 | 顶灯（看现场情况）、床头灯（看现场情况） | 打开/关闭吊灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | |
壁灯 | 房间 | 卧室 | 床头灯（看现场情况） | 打开/关闭壁灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | |
台灯 | 房间 | 卧室 | 打开/关闭台灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | ||
衣帽间灯 | 房间 | 衣帽间 | 打开/关闭衣帽间灯 | 打开/关闭对应的客控灯（根据房间具体客控灯的名字定义） | ||
智能场景 | 睡眠模式 | 房间 | 卧室 | 无别名 | 打开睡眠模式/我要睡觉了/我困了 | 关闭房间所有灯光、打开夜灯(如有)、关闭所有窗帘 |
工作模式 | 房间 | 客厅 | 无别名 | 打开工作模式、我要工作了 | 打开房间所有灯光 | |
沐浴模式 | 卫生间 | 卧室/客厅 | 无别名 | 打开沐浴模式、我要洗澡了 | 打开浴室所有灯(如有区分浴室和卫生间的灯光，单独打开浴室灯光，如未区分，同时打开浴室和卫生间灯光)，关闭浴室卷帘(如有) | |
起床模式 | 房间 | 卧室 | 无别名 | 打开起床模式、我要起床了 | 打开所有灯、打开遮光帘/窗帘、关闭纱帘 | |
柔和模式 | 房间 | 卧室 | 无别名 | 打开柔和模式、房间太亮了 | 1.打开柔和模式 2.如没有柔和模式，打开房间已有灯带(可根据现场情况调试，目的房间柔和的灯光效果) | |
休闲模式 | 房间 | 卧室 | 无别名 | 打开休闲模式 | 打开夜灯，镜前灯 | |
明亮模式 | 房间 | 卧室 | 无别名 | 打开明亮模式、房间太暗了 | 1.打开房间已有的明亮模式；2.如没有，打开房间所有灯； | |
空调控制 | 空调 | 房间 | 卧室/客厅 | 卧室空调/卧室的空调/房间空调/房间的空调/客厅空调（具体命名看现场房型情况定） | 打开房间/卧室/客厅的空调 | 房间空调开启 |
空调 | 房间 | 卧室/客厅 | 卧室空调/卧室的空调/房间空调/房间的空调/客厅空调（具体命名看现场房型情况定） | 关闭空调 | 房间空调关闭 | |
空调 | 房间 | 卧室/客厅 | 卧室空调/卧室的空调/房间空调/房间的空调/客厅空调（具体命名看现场房型情况定） | 调整空调温度至20度 | 空调温度调整对应温度 | |
空调 | 房间 | 卧室/客厅 | 卧室空调/卧室的空调/房间空调/房间的空调/客厅空调（具体命名看现场房型情况定） | 空调温度调高/低一些 | 空调温度调高/低2度（暂定2度） | |
空调 | 房间 | 卧室/客厅 | 卧室空调/卧室的空调/房间空调/房间的空调/客厅空调（具体命名看现场房型情况定） | 空调温度调高/低3度 | 空调温度调高/调低3度 | |
空调 | 房间 | 卧室/客厅 | 卧室空调/卧室的空调/房间空调/房间的空调/客厅空调（具体命名看现场房型情况定） | 空调风速调至1/2/3档 | 不同程度的空调风速吹出 | |
空调 | 房间 | 卧室/客厅 | 卧室空调/卧室的空调/房间空调/房间的空调/客厅空调（具体命名看现场房型情况定） | 空调风速调到最大/最小 | 风速调整至最大或最小 | |
空调 | 房间 | 卧室/客厅 | 卧室空调/卧室的空调/房间空调/房间的空调/客厅空调（具体命名看现场房型情况定） | 空调风速大/小一点 | 空调风速调整 | |
空调 | 房间 | 卧室/客厅 | 卧室空调/卧室的空调/房间空调/房间的空调/客厅空调（具体命名看现场房型情况定） | 空调现在多少度 | 空调温度/开关/风速状态的上报查询 | |
窗帘控制 | 窗帘 | 遮光帘 | 打开/关闭窗帘 | 窗帘被拉开/关闭 | ||
窗纱 | 纱窗/纱帘/帘子 | 打开/关闭纱帘 | 纱帘被拉开/关闭 | |||
浴帘 | 打开/关闭浴帘 | 纱帘被拉开/关闭 | ||||
电视控制 | 电视 | 房间 | 卧室/客厅 | 无别名 | 打开/关闭卧室/房间/客厅的电视 | 电视打开/关闭 |
电视 | 无别名 | 我想看湖南卫视 | 频道跳转至湖南卫视 | |||
电视 | 无别名 | 电视调到中央一台 | 频道跳转至重要一套 | |||
电视 | 无别名 | 打开中央五套 | 频道跳转至中央五套 | |||
电视 | 无别名 | 电视调到上/下一个台/频道 | 电视跳至上/下一个频道 | |||
电视 | 无别名 | 电视音量调高/大/低/小一些 | 电视音量调大/小5格 | |||
电视 | 无别名 | 电视音量调到20 | 电视音量调到20 | |||
电视 | 无别名 | 电视静音 | 电视静音 |
#5. 语音播报设置
在小度行业开放平台项目-用户管理中，添加账号：
添加用户的具体内容为：
在庆科客控平台网址：https://hotel.mxchip.com， 通过管理员提供的账号密码登录；
点击「音箱管理」，选中「欢迎语播报」，勾选所需的触发动作，并输入欢迎语内容，点击「保存」即可。
