同佳智慧酒店

为了更好的服务体验，客控厂商还需要对接以下接口，完成相关功能实现！

1、入住欢迎语接口

1.1 直接推送欢迎语到房间设备

RCU 厂商/酒店可以调用入住欢迎语接口，在开门或者在插入房卡激活之后，天猫精灵音箱完成音频迎宾播放等操作。

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=PushWelcomeTextAndMusic

• 欢迎语文本：

  • 未配置欢迎语时会直接使用默认的：“尊贵的客人，您好，欢迎入住，我是您的房间智能助理，我可以播放音乐，控制空调、灯光等，也能提供酒店的各种服务，回答酒店相关问题。只需要唤醒后，就能和我开始互动，我的更多能力，可以参考我旁边的立牌使用哦，祝您在本酒店度过一段愉快的入住时光。“

  • 如欢迎语文本中的表达式：${hotelName} 可通过参数映射表的{“hotelName”:”智慧酒店”}替换成“智慧酒店”

• 背景音链接：未配置时会使用默认的：http://ailabsaicloudservice.alicdn.com/tmp/a.wav

1.2 推送欢迎语播报（音箱定制界面配置的内容）

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=PushWelcomeTextAndMusic

2、送物机器人播报接口

送物机器人对接接口，可用于机器人送物到门口，提醒入住客户进行送物和取物的操作，该接口播报内容为固定语料，如果需要自定义播报语料，可以使用1.1的欢迎语接口。

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=InvokeRobotPush

3、退房重置接口

用于入住客户退房后，对房间内音箱进行重置接口；可重置范围包括：闹钟、提醒、订单、账号、播放记录等一系列使用记录信息；

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=CheckoutWithAK

4、红外设备控制接口

对接接口：https://www.aligenie.com/docs/business/4141359

5、设备别名配置接口

5.1 ImportRoomControlDevices接口

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=ImportRoomControlDevices

5.2 发现设备接口

对接接口：https://www.aligenie.com/docs/business/3993041

6、场景触发语料自定义配置接口

6.1 CreateRcuScene创建自定义场景接口

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=CreateRcuScene

6.2 UpdateRcuScene修改自定义场景接口

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=UpdateRcuScene

6.3 发现设备接口

对接接口：https://www.aligenie.com/docs/business/3993041

7、自定义消息推送接口

为了支持更多消息推送需求，我们开放自定义消息推送接口，通过提前创建各种自定义消息模板方式实现各种自定义消息推送。整套消息接口如下：

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=PushHotelMessage

8、远程设闹钟接口

这个功能请谨慎使用，可以远程为客房住户设置起床闹钟，方便实现叫早服务。整套闹钟接口如下：

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=CreateHotelAlarm

9、控制界面状态接口（仅限带屏设备）

天猫精灵酒店版带屏音箱提供控制页面，这里需要跟客控厂商对接控制状态，方便酒店客人更好使用客控服务。

目前带屏音箱端客控界面示意图如下：

里面触屏点击执行接口跟语音触发接口共用，但界面中设备状态需要增加一个接口进行对接。

对接接口：https://open-api.aligenie.com/?version=ip_1.0&apiName=SyncDeviceStatusWithAk