Skip to content

自定义语音能力

通过自定义语音能力服务,您可以通过开关、模式、档位三个功能类型轻松定制适合您产品特色的语音控制能力。 该服务目前支持 Alexa 和 Google Assistant 两大语音平台。它们已为开关、档位和模式设定了标准句式,您只需根据您想实现的功能替换句中的特定关键词,就能生成属于自己的语音指令。

前提条件

已完成对您产品的物模型定义,该产品类型支持 【三方语音接入】 配置。

配置自定义能力

可根据产品的需求,选择配置开关、模式、档位这三个类型的自定义语音能力。具体配置操作如下:

  1. 进入三方语音接入界面。

img

  1. 选择您想支持的语音平台进入方案配置页。
  • 对于没有创建过语音方案版本的方案。
    • 您可以单击对应语音平台中的 方案配置 直接进入方案配置页。

img

  • 您也可以单击 版本管理 按钮,进入版本弹出框,单击弹出框右上角的 新增版本img

  • 对于已经创建过语音方案版本的方案。

    • 如果您已经创建并已发布版本,您可以单击 方案配置 继续创建语音方案版本在发布前不会影响上线版本使用,您也可以点击 已上线x个语音功能 查看上线版本功能或点击 取消开通 下线语音功能。 img
    • 如果您有语音方案版本处于 配置中 状态,则可以单击 继续配置img
  1. 添加自定义功能。
  • 如果在功能列表中找到适合您产品可以直接选择其自定义功能,进入下一步配置 img
  • 如果在功能列表中没有找到适合您产品的自定义功能,可以点击下方 创建自定义功能 灵活配置。 img

配置自定义能力类型为开关

您选择自定义功能的可配置的数据类型为 bool创建自定义功能 类型为开关,配置语音能力填写项说明及示例如下: img

填写说明:

填写信息说明是否必填
功能名称该功能的名称,只用于展示和区分用途。
功能类型决定自定义能力的功能属性。根据产品用途选择。
支持语种该能力需要支持的语种。您可以选择一个或多个语种。
功能控制方式决定功能对设备是即控制又查询还是只查询
功能名称说法设置该开关功能的说法,自定义开关控制指令中的对应的 “toggle name”。
Alexa 自带说法仅 Alexa 平台支持选择 Alexa 自带说法。
自定义说法支持自定义配置每个语种的说法,每个语种最多可填写3个单词。- 在 Alexa 语音方案中,如果没有填写 Alexa 自带说法,则必须填写所有支持语种的自定义说法。
- 在 Alexa 语音方案中,Alexa 自带说法与自定义说法可一起填写,二者可以共用。
- 在 Google Assistant 语音方案中,必须填写所有支持语种的自定义说法。
设置物模型该语音指令对应的设备物模型。支持选择布尔型物模型。
单个语音能力配置仅支持单个物模型。
设置物模型参数该语音指令中的开与关对应物模型的打开或关闭

配置示例:

以“开关”为例,添加开关类型的自定义能力。配置信息如下图。 img 上述信息填写后单击 确定 即可添加该能力至语音方案版本中,您可以在 方案配置 界面查看已添加的自定义能力 img

配置自定义能力类型为模式

您选择自定义功能的可配置的数据类型为 枚举创建自定义功能 类型为模式,配置语音能力填写项说明及示例如下: img

填写说明:

填写信息说明是否必填
功能名称该功能的名称,只用于展示和区分用途。
功能类型决定自定义能力的功能属性。根据能力用途选择。
支持语种该能力需要支持的语种。您可以选择一个或多个语种。
功能控制方式决定功能对设备是即控制又查询还是只查询
功能名称说法自定义模式控制指令中对应的 "mode name”。
Alexa 自带说法仅 Alexa 平台支持选择 Alexa 自带说法。
自定义说法支持自定义配置每个语种的说法,每个语种最多可填写3个单词。- 在 Alexa 语音方案中,如果没有填写 Alexa 自带说法,则必须填写所有支持语种的自定义说法。
- 在 Alexa 语音方案中,Alexa 自带说法与自定义说法可一起填写,二者可以共用。
- 在 Google Assistant 语音方案中,必须填写所有支持语种的自定义说法。
设置物模型该语音指令对应的设备物模型。支持选择枚举型物模型。
单个语音能力配置仅支持单个物模型。
模式值说法自定义模式指令中对应的 “mode value”。
您可以定义每个模式值的说法。

配置示例:

以“工作模式”为例,添加枚举类型的自定义能力。配置信息如下图。 img 上述信息填写后单击 确定 即可添加该能力至语音方案版本中,您可以在 方案配置 界面查看已添加的自定义能力 img

配置自定义能力类型为档位

您选择自定义功能的可配置的数据类型为 数值创建自定义功能 类型为档位,配置语音能力填写项说明及示例如下: img 填写说明:

填写信息说明是否必填
功能名称该功能的名称,只用于展示和区分用途。
功能类型决定自定义能力的功能属性。根据能力用途选择。
支持语种该能力需要支持的语种。您可以选择一个或多个语种。
功能控制方式决定功能对设备是即控制又查询还是只查询
功能名称说法自定义档位控制指令中对应的 ”range name”。
Alexa 自带说法仅 Alexa 平台支持选择 Alexa 自带说法。
自定义说法支持自定义配置每个语种的说法,每个语种最多可填写3个单词。- 在 Alexa 语音方案中,如果没有填写 Alexa 自带说法,则必须填写所有支持语种的自定义说法。
- 在 Alexa 语音方案中,Alexa 自带说法与自定义说法可一起填写,二者可以共用。
- 在 Google Assistant 语音方案中,必须填写所有支持语种的自定义说法。
设置物模型该语音指令对应的设备物模型。支持选择数值型物模型。
单个语音能力配置仅支持单个物模型。
档位别名说法自定义模式指令中对应的 “preset name”。
支持添加多个档位别名。如档位范围为 0~100 时,可以自定义 “100” 的说法为最大/最快/最热等别名说法。最多可添加100个别名。

配置示例:

以“风速”为例,添加数值类型的自定义能力。配置信息如下图。 img 上述信息填写后单击 确定 即可添加该能力至语音方案版本中,您可以在 方案配置 界面查看已添加的自定义能力 img

测试发布

方案配置 界面,单击下方 确认配置,立即测试,可前往 测试发布 界面。
操作流程可参考 使用语音工作台 及 相关语音平台对接方案。
在 测试发布 界面,您可以通过两种方式验证配置产品是否正确:
语音代测服务:只需提供设备,繁琐的测试流程及上架审核动作由移远工作人员操作
自主测试:
1.您需下载并注册Wonderfree App完成测试设备绑定,点击 测试配置测试账号 将该账号填写
2.下载并注册Alexa、Google Home App
3.通过Wonderfree技能进行账号绑定后根据您配置的语音功能进行测试,具体见 Alexa App教程 与 Google Home App教程 img