小度行业版FAQ知识库
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/c1f3db3a19ba07a823b5a41234bdc4b1" alt="" /></p>
<h1>小度酒店FAQ知识库</h1>
<ul>
<li><a href="#1">一、音箱使用问题</a></li>
<li><a href="#1.3">1.3 音箱基础功能</a></li>
<li><a href="#1.4">1.4 酒店音箱特有功能</a></li>
<li><a href="#1.4">1.5 云云接入方案语音控制问题</a></li>
<li><a href="#1.5">1.6 蓝牙mesh方案语音控制问题</a></li>
<li><a href="#1.6">1.7 小度红外控制问题</a></li>
<li><a href="#2">二、酒店平台问题</a></li>
<li><a href="#3">三、客控技能接入问题</a></li>
<li><a href="#4">四、蓝牙mesh接入问题</a></li>
</ul>
<h2 id="1"> 一、音箱使用问题</h2>
<h4 id="1.1"> 1.1 音箱激活</h4>
<p>酒店版app下载以及激活引导参考：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Fhotel-device-activation%2Fhotel-app.md">酒店版app下载</a></p>
<p>激活常见问题参考：<a href="https://www.showdoc.com.cn/833078369209673/7828803982382419#4">激活问题排查</a></p>
<h4 id="1.2"> 1.2 音箱联网</h4>
<p>音箱联网失败，请按文档排查：<a href="https://www.showdoc.com.cn/833078369209673/7828803982382419#4.5">4.5、无屏音箱激活提示网络连接失败</a></p>
<h4 id="1.3"> 1.3 音箱基础功能</h4>
<h5>1.3.1 恢复出厂</h5>
<p>参考：<a href="https://www.showdoc.com.cn/833078369209673/4567105554732514">恢复出厂</a></p>
<p>注意：无屏音箱请一定先重新上电，等音箱完全开机后再按键恢复，并且每次按键时间要<strong>超过 5秒</strong>，一次不行，就重新上电再多试几次</p>
<h5>1.3.2 设备升级</h5>
<p>音箱默认空闲时，会升级到最新版本。 </p>
<p>如果是新项目调试：1、有屏音箱可以打开【设置-本机信息-软件版本】点升级 2、无屏音箱打开【行业平台-设备管理-版本管理】，点全部升级即可</p>
<h5>1.3.3 音量设置</h5>
<p>酒店版音箱支持批量设置音箱的最大可设置音量，具体参考：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Femp-hotel-setting%2Fhotel-device-list.md#3">三、批量配置</a></p>
<p>备注：批量设置的音量不会影响有屏音箱的欢迎语音量</p>
<h5>1.3.4 日志上传</h5>
<ul>
<li>有屏音箱点【设置-本机信息】右上角（上传小度日志）</li>
<li>无屏音箱，先对小度说【打开设备调试模式】，然后复现您的问题，保持音箱在线，10分钟后，小度会自动上传日志</li>
</ul>
<h5>1.3.5 切换网络</h5>
<p>备注:1、酒店版音箱除【酒店版中控屏外】,都支持2.4G的wifi，不支持5G </p>
<ul>
<li>有屏音箱在【设置-无线网络】中切换，管理员密码是：**<em>baiduAI</em></li>
<li>无屏音箱不支持待认证的wifi，解决办法是需要wifi供应方协助添加小度的mac地址到白名单中，免认证（需要联系wifi的技术方）</li>
<li>无屏音箱需要先<a href="https://www.showdoc.com.cn/833078369209673/4567105554732514">恢复</a>，再<a href="https://www.showdoc.com.cn/833078369209673/7828803982382419">激活</a></li>
</ul>
<h5>1.3.6 夜间模式</h5>
<p>夜间模式：指的是打开后，音箱屏幕熄灭，音箱减小，避免打扰客人休息</p>
<p>酒店版支持批量设置音箱在某一个时间段（例如22:00-7:00）进入夜间模式，配置方法参考：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Femp-hotel-setting%2Fhotel-device-list.md#3">三、批量配置</a></p>
<h5>1.3.7 音箱唤醒</h5>
<ul>
<li>
<p>如果遇到音箱无法唤醒,请参考文档排查：<a href="https://www.showdoc.com.cn/833078369209673/4662930017321437">无法唤醒</a></p>
</li>
<li>x8酒店版支持快捷指令，直接对小度说【打开快捷指令】，然后就可以直接说【小度开灯】，而不需要先小度小度唤醒</li>
</ul>
<h5>1.3.8 音色设置</h5>
<p>小度支持：萝莉音、少女音、女神音等音色</p>
<p>如果现场遇到小度声音变了，可以对小度说：【切换音色】 或者说 【设备重置】</p>
<h4 id="1.4"> 1.4 酒店音箱特有功能</h4>
<h5>1.4.1 欢迎语问题</h5>
<ul>
<li>欢迎语不播报</li>
</ul>
<p>酒店版音箱支持客控通过【<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2FpublicConnectin%2Fopen-api-content-push.md">欢迎语接口</a>】推送欢迎语，如果插卡取电后，音箱不播报，按以下方法检查</p>
<ul>
<li>欢迎语播报把自己唤醒</li>
</ul>
<p>目前无法避免自唤醒问题，建议欢迎词中不要包含关键字【小度小度】</p>
<ul>
<li><a href="https://www.showdoc.com.cn/833078369209673/4852078729888435">欢迎语不播报</a></li>
</ul>
<h5>1.4.2 酒店通话功能</h5>
<ul>
<li>
<p>酒店通话是付费项目，收费标准、开通和调试请参考：<a href="https://www.showdoc.com.cn/833078369209673/4721474903668158">通话开通</a></p>
</li>
<li>通话使用和调试过程中遇到问题，优先联系<strong>话机代理商</strong>协助排查，或者根据文档自查：<a href="https://www.showdoc.com.cn/833078369209673/7482941696901459">通话问题汇总</a></li>
</ul>
<h5>1.4.3 点餐服务、补充用品</h5>
<p>客需配置参考：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Femp-hotel-setting%2Femp-infos-srvs-setting.md">二、酒店服务配置</a></p>
<p>客需对接酒店PMS和送餐机器人参考：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2FcustomerNeeds%2Fcsr-need-connected.md">酒店客需接入流程</a></p>
<ul>
<li>
<p>遇到配置补充用品不支持，参考：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2FcustomerNeeds%2Fsupplement-name.md">补充用品名称支持</a></p>
</li>
<li>遇到菜品不支持，参考：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2FcustomerNeeds%2Fdish-name.md">餐品名称添加</a></li>
</ul>
<h4 id="1.4"> 1.5 云云接入方案语音控制问题</h4>
<h5>1.5.1 音箱发现不到设备</h5>
<p>请按以下文档处理：<a href="https://www.showdoc.com.cn/833078369209673/6868900154713676">发现不到设备</a></p>
<h5>1.5.2 设备控制失败</h5>
<p>现象：打开房间设备后，小度回复成功，失败或者还不支持这样控制等</p>
<p>请参考文档处理：<a href="https://www.showdoc.com.cn/833078369209673/4589125612437954">控制设备失败</a></p>
<h5>1.5.3 技能接入的电视控制问题</h5>
<p>和设备控制一样，小度回复成功，失败或者还不支持这样控制等，都先参照文档处理</p>
<p>请参考文档处理：<a href="https://www.showdoc.com.cn/833078369209673/4589125612437954">控制设备失败</a></p>
<h5>1.5.4 小度提示授权失败</h5>
<p>需要音箱重新激活，重新绑定技能:<a href="https://www.showdoc.com.cn/833078369209673/4567105554732514">恢复出厂</a>、<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Fhotel-device-activation%2Fhotel-app.md">音箱激活</a></p>
<h5>1.5.5 音箱激活时，未绑定技能</h5>
<p>需要按文档，补充绑定客控技能：<a href="https://www.showdoc.com.cn/833078369209673/7828803982382419#3">已激活设备补充客控</a></p>
<h5>1.5.6 音箱半夜放音乐</h5>
<p>半夜放音乐一般有两种情况：闹钟、欢迎语播报，建议先清除音箱的使用记录（小度小度，设备重置），再观察是否会复现</p>
<p>有条件的，可以先检查下客控的推送欢迎语记录，看是否是推送了欢迎语导致</p>
<h5>1.5.7 音箱半夜打开设备（开灯、开窗帘等）</h5>
<ul>
<li>
<p>检查客控技能日志，看技能是否收到了小度打开设备的指令，如果没收到，则是客控自身问题</p>
</li>
<li>如果收到了指令，很可能是小度设置了定时任务导致，建议先清除音箱的使用记录（小度小度，设备重置），再观察是否会复现</li>
</ul>
<h5>1.5.8 开关灯，技能收到了多条指令</h5>
<p>小度支持技能接入时，query开灯/关灯时，只发一条指令给技能，避免客控收到多条指令时，响应不及时，具体参考以下方案：<a href="https://www.showdoc.com.cn/833078369209673/4547803299445015">所有灯逻辑</a></p>
<h5>1.5.9 打开某一个灯时，打开了所有灯</h5>
<p>常见于设备名称识别出错，或者打开了一个不存在的灯，小度此时会兜底打开所有类型是（LIGHT）的设备</p>
<p>解决方案：给设备添加别名，需要联系客控厂商协助：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Frcu-new%2Fbot-connect-requires.md">2.客控设备分组与别名对接须知</a></p>
<h4 id="1.6"> 1.6 蓝牙mesh方案语音控制问题</h4>
<h5>1.6.1 mesh设备配网，提示网关付费</h5>
<p>音箱直连mesh设备是付费项目，需要付费开通，收费标准、开通参考：<a href="https://www.showdoc.com.cn/833078369209673/4811511761180980">mesh直连开通</a></p>
<p>开通时效：购买后，一个工作日开通</p>
<h5>1.6.2 付费后，用mesh厂商的管理软件远程控制，提示收费</h5>
<ul>
<li>
<p>远程控制需购买*<strong>135套餐</strong>（基础服务+增值服务），如果购买的是120元套餐，请补交费用</p>
</li>
<li>请确保<strong>项目管理-开发者配置-蓝牙mesh设备许可</strong>，已经给对应房间点了开通</li>
</ul>
<h4 id="1.7"> 1.7 小度红外控制问题</h4>
<h5>1.7.1 红外配置</h5>
<ul>
<li>
<p>小度是用的第三方公司【酷控】提供的红外码表，所以红外问题，一定要按文档，用带红外的手机先验证</p>
</li>
<li>小度酒店版音箱配置红外的方法和家庭版音箱不同，请<strong>一定按酒店的文档配置</strong>，参考：【<a href="https://www.showdoc.com.cn/833078369209673/7854455739993007">酒店版小度控制红外设备</a>】</li>
</ul>
<h5>1.7.2 删除红外遥控器</h5>
<p>酒店版删除小度红外遥控器分两种情况</p>
<ul>
<li>
<p>如果音箱开通了mesh直连，可以按文档，在app设备管理页面删除：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Fhotel-device-activation%2Fmesh-equipment-configuration.md">mesh设备配置</a></p>
</li>
<li>如果没有开通mesh直连，则只能音箱恢复，重新激活</li>
</ul>
<h5>1.7.3 连接网络机顶盒</h5>
<p>小度只支持运营商（移动、电信、联通、广电、华数）提供的标准机顶盒，其他网络机顶盒不支持</p>
<h2 id="2"> 二、酒店平台问题</h2>
<h4 id="2.1"> 2.1 项目创建</h4>
<ul>
<li>正式项目请务必填写<strong>正式的酒店名称</strong>，测试项目申请时，请选择<strong>样板间</strong>，否则审核时会被打回</li>
<li>审核时效：<strong>一个工作日</strong></li>
</ul>
<h4 id="2.1"> 2.1 项目创建</h4>
<h2 id="3"> 三、客控技能接入问题</h2>
<h4 id="3.1"> 3.1 酒店版技能和家居版技能区别</h4>
<ul>
<li>
<p>由于音箱账号体系不同，技能授权方式不同，具体酒店版一定要参考酒店的文档配置授权认证：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Frcu-new%2Fbot-create.md">2.2 技能参数配置</a></p>
</li>
<li>
<p>辨别音箱的唯一参数不同，酒店版以<strong>cuid</strong>为准（小度发给技能的json携带），家庭版以<strong>openuid</strong>为准</p>
</li>
<li>酒店版技能无法进行真机测试，提交上线需要参考<strong>3.4技能上线</strong>，发邮件给小度团队审核</li>
</ul>
<h4 id="3.2"> 3.2 技能创建</h4>
<p>参照酒店版技能文档：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Frcu-new%2Fbot-create.md">酒店客控技能创建</a></p>
<h4 id="3.3"> 3.3 技能开发</h4>
<h5>3.3.1 关于服务授权（token）</h5>
<ul>
<li>
<p>服务授权申请入口 <a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2FpublicConnectin%2Fopen-api-authorize.md">服务授权</a></p>
</li>
<li>
<p>有效期一个月，到期后需要刷新token</p>
</li>
<li>申请服务授权的百度账号，必须拥有酒店音箱的管理权限，即该账号必须是酒店项目的管理员</li>
</ul>
<h5>3.3.2 技能授权失败</h5>
<p>一般是技能参数配置填写不对，请仔细核对：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Frcu-new%2Fbot-create.md">2.2 技能参数配置</a></p>
<p>报错截图如下：
<img src="https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-11/1667557395496/1667557281941.jpg" alt="" /></p>
<h4 id="3.4"> 3.4 技能上线</h4>
<h6>3.4.1 发邮件提交上线</h6>
<p>请务必按文档给小度酒店团队发邮件提交上线：<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Frcu-new%2Fbot-create.md">2.4 发送酒店客控技能审批邮件</a></p>
<p>审核后，技能会在<strong>两个工作日</strong>后上线完成，请耐心等待，技能上线是自动化=任务，无法人工干预，请提前预留时间</p>
<h6>3.4.2</h6>
<p>请参考文档排查:<a href="https://www.showdoc.com.cn/833078369209673/7915902962325201">技能提交上线报错</a></p>
<h4 id="3.5"> 3.5 技能更新版本</h4>
<p>参照下图，新建版本，然后提交上线，并参照 3.4.1节，发邮件
<img src="https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-11/1667908006774/3c26aef7736d209369c99d71a.png" alt="" /></p>
<h4 id="3.6"> 3.6 技能下线</h4>
<p>当由于种种原因（例如 技能不可用，服务将不被支持和维护等等），第三方技能的开发者可以要求DBP 平台下线该技能，具体操作流程如下：</p>
<p>1）技能所有者（开发者）发送邮件到 <strong>duer-tob-service@baidu.com、DBP-service@baidu.com</strong>邮件模版如下：</p>
<pre><code>标题：【开发者名称】的【XXX技能】申请下线
内容：
技能名称：XXX
技能ID：YYY
技能所有者名称：ZZZ，如果技能所有者名称与技能开发者的名称不一致，需要提供相关授信证明
下架原因：【阐明具体的下架原因】balabala</code></pre>
<h4 id="3.6"> 3.6 技能变更开发者账号</h4>
<ul>
<li>
<p>原owner在：使用开发者认证时登记的邮箱，邮件到<strong>duer-tob-service@baidu.com、DBP-service@baidu.com</strong> 提供技能ID、新owner的手机号、证件号</p>
</li>
<li>原owner不在：新owner邮件到<strong>duer-tob-service@baidu.com、DBP-service@baidu.com</strong>提供技能ID、原owner的手机号，新owner的手机号，新owner和原原owner的企业身份必须一致</li>
</ul>
<h2 id="4"> 四、蓝牙mesh接入问题</h2>
<h4 id="4.1"> 4.1 mesh设备接入</h4>
<h4 id="4.2"> 4.2 mesh授权开通</h4>
<h4 id="4.3"> 4.3 设备配网</h4>
<h4 id="4.4"> 4.4 设备控制</h4>