自定义语音能力
通过自定义语音能力服务,您可以通过开关、模式、档位三个功能类型轻松定制适合您产品特色的语音控制能力。 该服务目前支持 Alexa 和 Google Assistant 两大语音平台。它们已为开关、档位和模式设定了标准句式,您只需根据您想实现的功能替换句中的特定关键词,就能生成属于自己的语音指令。
前提条件
已完成对您产品的物模型定义,该产品类型支持 【三方语音接入】 配置。
配置自定义能力
可根据产品的需求,选择配置开关、模式、档位这三个类型的自定义语音能力。具体配置操作如下:
- 进入三方语音接入界面。
- 选择您想支持的语音平台进入方案配置页。
- 对于没有创建过语音方案版本的方案。
- 您可以单击对应语音平台中的 方案配置 直接进入方案配置页。
对于已经创建过语音方案版本的方案。
- 添加自定义功能。
配置自定义能力类型为开关
您选择自定义功能的可配置的数据类型为 bool 或 创建自定义功能 类型为开关,配置语音能力填写项说明及示例如下:
填写说明:
填写信息 | 说明 | 是否必填 |
---|---|---|
功能名称 | 该功能的名称,只用于展示和区分用途。 | 是 |
功能类型 | 决定自定义能力的功能属性。根据产品用途选择。 | 是 |
支持语种 | 该能力需要支持的语种。您可以选择一个或多个语种。 | 是 |
功能控制方式 | 决定功能对设备是即控制又查询还是只查询 | 是 |
功能名称说法 | 设置该开关功能的说法,自定义开关控制指令中的对应的 “toggle name”。 | 是 |
Alexa 自带说法 | 仅 Alexa 平台支持选择 Alexa 自带说法。 | 否 |
自定义说法 | 支持自定义配置每个语种的说法,每个语种最多可填写3个单词。 | - 在 Alexa 语音方案中,如果没有填写 Alexa 自带说法,则必须填写所有支持语种的自定义说法。 - 在 Alexa 语音方案中,Alexa 自带说法与自定义说法可一起填写,二者可以共用。 - 在 Google Assistant 语音方案中,必须填写所有支持语种的自定义说法。 |
设置物模型 | 该语音指令对应的设备物模型。支持选择布尔型物模型。 单个语音能力配置仅支持单个物模型。 | 是 |
设置物模型参数 | 该语音指令中的开与关对应物模型的打开或关闭 | 是 |
配置示例:
以“开关”为例,添加开关类型的自定义能力。配置信息如下图。 上述信息填写后单击 确定 即可添加该能力至语音方案版本中,您可以在 方案配置 界面查看已添加的自定义能力
配置自定义能力类型为模式
您选择自定义功能的可配置的数据类型为 枚举 或 创建自定义功能 类型为模式,配置语音能力填写项说明及示例如下:
填写说明:
填写信息 | 说明 | 是否必填 |
---|---|---|
功能名称 | 该功能的名称,只用于展示和区分用途。 | 是 |
功能类型 | 决定自定义能力的功能属性。根据能力用途选择。 | 是 |
支持语种 | 该能力需要支持的语种。您可以选择一个或多个语种。 | 是 |
功能控制方式 | 决定功能对设备是即控制又查询还是只查询 | 是 |
功能名称说法 | 自定义模式控制指令中对应的 "mode name”。 | 是 |
Alexa 自带说法 | 仅 Alexa 平台支持选择 Alexa 自带说法。 | 否 |
自定义说法 | 支持自定义配置每个语种的说法,每个语种最多可填写3个单词。 | - 在 Alexa 语音方案中,如果没有填写 Alexa 自带说法,则必须填写所有支持语种的自定义说法。 - 在 Alexa 语音方案中,Alexa 自带说法与自定义说法可一起填写,二者可以共用。 - 在 Google Assistant 语音方案中,必须填写所有支持语种的自定义说法。 |
设置物模型 | 该语音指令对应的设备物模型。支持选择枚举型物模型。 单个语音能力配置仅支持单个物模型。 | 是 |
模式值说法 | 自定义模式指令中对应的 “mode value”。 您可以定义每个模式值的说法。 | 是 |
配置示例:
以“工作模式”为例,添加枚举类型的自定义能力。配置信息如下图。 上述信息填写后单击 确定 即可添加该能力至语音方案版本中,您可以在 方案配置 界面查看已添加的自定义能力
配置自定义能力类型为档位
您选择自定义功能的可配置的数据类型为 数值 或 创建自定义功能 类型为档位,配置语音能力填写项说明及示例如下: 填写说明:
填写信息 | 说明 | 是否必填 |
---|---|---|
功能名称 | 该功能的名称,只用于展示和区分用途。 | 是 |
功能类型 | 决定自定义能力的功能属性。根据能力用途选择。 | 是 |
支持语种 | 该能力需要支持的语种。您可以选择一个或多个语种。 | 是 |
功能控制方式 | 决定功能对设备是即控制又查询还是只查询 | 是 |
功能名称说法 | 自定义档位控制指令中对应的 ”range name”。 | 是 |
Alexa 自带说法 | 仅 Alexa 平台支持选择 Alexa 自带说法。 | 否 |
自定义说法 | 支持自定义配置每个语种的说法,每个语种最多可填写3个单词。 | - 在 Alexa 语音方案中,如果没有填写 Alexa 自带说法,则必须填写所有支持语种的自定义说法。 - 在 Alexa 语音方案中,Alexa 自带说法与自定义说法可一起填写,二者可以共用。 - 在 Google Assistant 语音方案中,必须填写所有支持语种的自定义说法。 |
设置物模型 | 该语音指令对应的设备物模型。支持选择数值型物模型。 单个语音能力配置仅支持单个物模型。 | 是 |
档位别名说法 | 自定义模式指令中对应的 “preset name”。 支持添加多个档位别名。如档位范围为 0~100 时,可以自定义 “100” 的说法为最大/最快/最热等别名说法。最多可添加100个别名。 | 否 |
配置示例:
以“风速”为例,添加数值类型的自定义能力。配置信息如下图。 上述信息填写后单击 确定 即可添加该能力至语音方案版本中,您可以在 方案配置 界面查看已添加的自定义能力
测试发布
在 方案配置 界面,单击下方 确认配置,立即测试,可前往 测试发布 界面。
操作流程可参考 使用语音工作台 及 相关语音平台对接方案。
在 测试发布 界面,您可以通过两种方式验证配置产品是否正确:
语音代测服务:只需提供设备,繁琐的测试流程及上架审核动作由移远工作人员操作
自主测试:
1.您需下载并注册Wonderfree App完成测试设备绑定,点击 测试配置测试账号 将该账号填写
2.下载并注册Alexa、Google Home App
3.通过Wonderfree技能进行账号绑定后根据您配置的语音功能进行测试,具体见 Alexa App教程 与 Google Home App教程