现象一:音箱回复“肿么办?智能家居控制暂时使用不了,要不一会儿再试试?”
问题原因:设备控制接口,客控系统返回状态码500,且返回响应消息为空,详见下图
解决方案:客控系统问题,此类问题建议先联系客控厂商排查服务日志,先确保返回给猫精的响应消息是正确的
现象二:音箱回复提示错误,但设备实际控制成功
问题原因一:设备控制接口,客控系统返回状态码200,但是返回耗时超过2000ms,导致超时
解决方案:客控系统问题,建议联系客控厂商排查:当前设备控制接口的总超时时间是2s,客控返回耗时需要控制在1800ms以内(正常该接口返回耗时为几百ms)
问题原因二:设备控制接口,客控系统返回状态码500异常
解决方案:客控接口需要确保返回的状态码为200,success为true
现象三:音箱回复“哎呀,您还没有绑定设备呢,请先去天猫精灵APP添加设备吧”
问题原因一:检查酒店平台对应房型配置中是否正常配置设备,详见下图;
如果近期有重新触发“发现设备”接口,需要确认客控接口返回的设备信息是否为空导致设备信息被覆盖清除,详见下图
解决方案:首先确保酒店平台的房型中正确添加设备信息;如果此前已添加设备信息突然消失,可以确认下最近是否有触发“发现设备”接口,并联系客控厂商确认是否返回完整的设备信息
注意:云云对接项目,发现设备接口(https://www.aligenie.com/docs/business/3993041)或者批量导入设备接口(https://open-api.aligenie.com/?version=ip_1.0&apiName=ImportRoomControlDevices)都会导致设备信息被覆盖
问题原因二:如果确认平台上设备信息已添加,此类现象可能是存在语音识别问题,语义识别不准确导致
解决方案:有屏音箱可以通过语音字幕判断是否语音识别问题;无屏音箱可以通过降低语速尝试是否可以解决,如果还是异常,可以提供设备uuid和异常时间,猫精负责完成语音识别优化
现象四:酒店平台上的红外设备信息突然消失
问题原因:需要确认“发现设备”接口返回的enableInfraredDeviceImport字段,设置为true时会覆盖已配置的红外设备信息
解决方案:该消息为客控系统返回,建议联系客控厂商确认“发现设备”接口返回的具体响应消息
现象五:语音触发“打开xx”,音箱回复“正在打开xx设备”(其它品类设备)
问题原因:举例,语音触发打开空调,音箱回复正在开灯;用户配置了灯的别名为空调,可以通过openapi的查询设备接口(https://open-api.aligenie.com/?version=ip_1.0&apiName=QueryRoomControlDevices)确认当前的设备别名信息
解决方案:删除别名设备,需要注意的是,设备删除后,当前策略需要第二天才能生效