定制组件 - HMIP 平台使用说明

## 简介 
> 定制组件是为特定的终端应用设计的

> 以下是为科沃斯的系列机器人做的定制组件

| 组件 | 说明 | 组件标识 |
| --- | --- | --- |
| ECO旺宝3 | 科沃斯旺宝3机器人交互配置 | benebot3 |
| ECO旺宝5网格版 | 科沃斯旺宝5机器人网格版交互配置 | benebot5 |
| ECO旺宝5画廊版 | 科沃斯旺宝5机器人画廊版交互配置 | benebot5g |
| ECO秀宝网格版 | 科沃斯秀宝机器人网格版交互配置 | showbot |
| ECO秀宝网格版2.0 | 科沃斯秀宝机器人网格版交互配置 | showbot2 |
| ECO秀宝画廊版 | 科沃斯秀宝机器人网格版交互配置 | showbotg |
| 协作工具配置 | 以科沃斯人机协作为代表的工具的话术，图片等素材配置 |  |
| 机器人动作设计 | 以科沃斯机器人为代表的实体机器人动作设计配置 |  |
| 歌曲配置 | 以科沃斯机器人为代表的实体机器人歌曲与动作配合配置 |  |

## 主题设置
>		主题设置包含模板图片配置、全局资源配置和主页背景配置。
>		模板图片配置对应于三代模板配置页面的按钮图片、边框颜色等。
>		全局资源配置对应于首页部分logo、电量图片、语音识别图片等。
>		主页背景配置对应与首页一级模板的图片和文字等。（此功能兼容旺3老版本，最多6个图片，需要配置更多图片的新版本请使用 FAQ 功能进行配置）
>		每个配置界面在未配置数据时有“点击获取默认数据”，点击后可以自动加载默认的数据，机器人端设置界面点击“获取主题资源”后加载完成即可。

> **平台可以自动提供不同的主题设置给不同的机型，这个功能需要在机器人配置中的机器人画像中的机型属中填写以上定制组件标识**

> 示例参见：[科沃斯机器人界面配置](http://doc.hmip.ecovacs-c.com/project-6/doc-111/ "科沃斯机器人界面配置")

## 预制话术
>		设计不同场景所需要的提示话术，填写完成提示话术后，点击确认按钮保存。闲聊过长、详情闲聊过长、点击屏幕声音，三项支持添加多条话术，并用|隔开，其余只允许添加一条语料。

[========]

## FAQ
> **FAQ是重要且必要的主页配置，FAQ至少要配置3个或3个以上，主页才能正常显示**
>![](/media//202011/2020-11-13_165247.png)

>		主页与分类引导页面的设置，点击新增按钮（只能增加一个），输入屏幕显示问题和标准问题，如果此问题要出现在右侧并有图片可以点击，等级选择为1，并上传相应图片，如不需要，等级选择为空。
>		人机协作场景， 首页上方按钮faq等级为1， 显示顺序和标注顺序一!致。 下方的问题等级为2， 需要标注问题前面显示的小图标。
[](/media//202011/2020-11-12_091743.png)
>		增加子项后要点击展开才能看到子项
![](/media//202011/2020-11-18_135842.png)

>**填写颜色时按照： #RRGGBB 的格式**

>**设置背景图片时，将图片先加入素材库，鼠标右键点击预览小图，复制浏览器地址栏中的链接，粘贴到背景图片输入框**
![](/media//202011/2020-11-12_093315.png)

> 示例参见：[科沃斯机器人界面配置](http://doc.hmip.ecovacs-c.com/project-6/doc-111/ "科沃斯机器人界面配置")

[========]

## 协作工具配置

### 话术素材（常用表达）
>		常用表达用于客服快速推出一些常见回答，可分级管理。
>		常用表达注意点如下：
>		1）同一个常用表达中话术内容不可重复，不同的常用表达中话术内容可重复
>		2）一个常用表达中可以配置多条话术，只能配置一个动作和音效，常用表达名称不可重复
>		3）编辑常用表达后需要进入三代审核界面，点击“常用表达审核”按钮才生效
>		4）常用表达音效不要配置太长，简短（控制在3s内），常用表达执行的顺序是表情和音效同时发生，音效播放完之后才播放话术

### 歌曲素材
>		供客户端推送的歌曲，点击增加后，从当前场景的音乐实体中选择。审核后，使用该场景的机器对应的客户端可以看到配置的常用歌曲。

### 图片素材
>		供客户端推送的图片，上传图片，审核后，使用该场景的机器对应的客户端可以看到配置的常用图片。
>		常用图片分一级二级目录。
>		常用图片可配置参数“超时时间（s）”，配置后对应为客户端推送的图片在机器人端显示的时长。

[========]

## 机器人动作设计
>该功能主要用于V1模板：简单问题，意图，协作工具配置中的话术素材
动作管理注意点如下：
>1. 动作执行顺序默认为前面的序号，头部上下角度不超过20度，头部左右角度不超过45度，动作管理转动只设置最多一圈转动，动作步骤别设置太多
2. 使用动作管理时，只需选择动作名即可
3. 编辑动作步骤后需要进入三代审核界面，点击“动作管理审核”按钮才生效，其他页面才可以选择新增动作。
>.

[========]

## 歌曲配置
>![](/media//202011/2020-11-11_174914.png)

>		 输入歌曲名，上传新歌曲，
>		 或者从曲库中选择，选择曲库中已经存在的歌曲。
>		 然后选择头部动作和身体角度、持续时间、灯饰，输入开始语音和结束语音。
>		如需要显示图片，可添加图片，完成后点击确认按钮，保存。

>		 图片只可添加一张 
>		 灯效和跳舞必须同时开启或关闭
>		 唱歌开启灯效时，要保证机器电量高于10%，否则即使打开灯效开关也不闪
>		 机器直接提问唱首歌：优先唱通用歌曲
>		 为每首歌配置的开始语和结束语，尽量通用

>		唱歌逻辑如下
>			a）直接提问“唱首歌”，这句话里没有歌曲名的实体，这种情况是随机选择当前场景的一首曲子，如果当前场景无歌曲，则随机选择通用场景的一首歌播放
>			b）提问语句中含有歌曲名，逻辑如下
>			示例，提问“唱首A”：

>| 当前场景 | 通用场景 | 结果 |
| --- | --- | --- |
| 有歌曲A | 不判断 | 唱歌曲A |
| 没有歌曲A | 有歌曲A | 唱歌曲A |
| 没有歌曲A，存在其他歌曲 | 没有歌曲A | 随机唱一首当前场景存在的歌 |
| 无歌曲 | 没有歌曲A，存在其他歌曲 | 随机唱一首通用场景存在的歌 |

>音乐实体分为通用场景和独立场景，每个场景可根据需要添加音乐，只适用于此场景，并不与其他场景通用，但通用场景中的歌曲通用于所有场景，不需要操作，其余场景便存在通用场景的所有音乐。