Skip to main content

第三方语音支持

如果您的产品接入了智能音箱，可以在此处勾选对应接入的语音助手，然后在右侧输入框补充接入的技能名称，勾选后，在 App 我的 - 语音等第三方服务 里将会出现对应帮助说明的图标入口。配置前请先申请第三方的语音助手 Skill，如果有需要代理服务，请联系我们的业务代表。

  • 中国大陆地区支持天猫精灵，小爱同学。

  • 境外地区支持 Alexa，Google assiant。

  • 如果选择 自定义帮助文档全部内容 ，则会出现 编辑文档 按钮，单击后，即可在弹框里维护各语种的帮助文案。

    在线编辑器内已显示预设的文案，您可以基于此文案模板进行二次修改，修改并保存后，App 用户即可查看最新版文案。

    如果要设置其他语种的帮助内容，必须先设置并保存英文的内容后，再单击语种下拉框，选择其他语种继续编辑。

  • 如为您的 App 开启 Alexa 和 Google Assistant 语音助手，需要单独开通 OEM 技能，否则可能会导致语音控制失效的情况。

  • Alexa 已实现 Alexa App-to-App 账户链接。在 Alexa 支持 选项中，可单击对应能力的超链接 服务介绍 查看详情或单击 立即开通 购买该服务。

  • 开启/关闭具体的语音支持服务，或修改具体语音支持服务里的帮助文案，无需重新构建 App。

配置语音助手Skill​

点击APP开发-OEM APP下的可选配置，就可以跳转到语音服务的选项卡界面，以天猫精灵为例，首先要勾选天猫精灵复选框，如果需要同步配置APP天猫精灵的引导文案，可以同步点击编辑帮助文档按钮，设置语种，引导文案，教程文档，点击保存，回到语音服务选项卡界面后，点击保存并发布按钮，就可以自动生成语音助手Skill，点击复制授权URL按钮，会弹出相关信息页面，包括Client ID, Client Secret, 网关URL， Authorization URL， Access Token URL，这些信息需要从这里复制，并相应填写到第三方语音平台，完成Skill配置。

image-20221212110358469

image-20221212110819068

image-20221212112201500

注意：其他语控平台的Skill配置参考如上步骤，基本流程都是一样的

创建技能​

天猫精灵​

如果选择天猫精灵语音接入，需要先在天猫精灵开放平台创建相应技能，可以参考天猫精灵开放平台技能发布流程，完成天猫精灵开放平台Skill配置。

小爱同学​

暂未开放，敬请期待

Alexa​

如果选择Alexa语音接入，需要在Alexa平台创建技能、Lambda服务，可以参考Alexa对接流程，完成Alex平台技能与Lambda服务配置。

Google Assistant​

暂未开放，敬请期待

创建产品​

第三方语音平台​

天猫精灵​

登录天猫精灵开放平台，用户需要新建产品，并关联上面创建的技能，并添加产品物模型定义，来完成产品定义，人机交互，设备调试，软件发布等，具体请参考天猫精灵开放平台平台与接入流程。

  • 产品定义：主要添加产品相关的物模型定义
  • 人机交互：主要用于语音语料的生成
  • 设备调试：主要是账号授权和设备调试
  • 软件发布：在产品已经开发并测试完成后，可以进行产品发布

以下为天猫精灵物模型定义部分截图：

image-20221213104118456

爱星物联开放平台​

在第三方语音平台创建完产品后，需要同步在爱星物联开放平台创建相应的产品，创建产品后，根据第三方语音平台产品物模型定义来添加爱星物联开放平台产品相对应的物模型定义，关于如何创建产品和添加物模型功能定义，请参考产品管理章节，相关截图如下：

image-20221213105228270

在添加完爱星物联产品和相关物模型的功能定义后，需要点击产品下语音控制选项卡，进行爱星物联开放平台产品功能定义到第三方语音平台产品功能定义的映射配置

image-20221213110144269

点击相应语音平台的配置方案，可以跳转到功能点定义的映射配置界面，首先要填入第三方语音平台产品与技能的相关信息，包括产品名称，产品分类(英文)，产品型号，技能ID等。

image-20221213110621388

点击添加功能点按钮，会弹出功能配置界面，需要添加功能名称，以下的属性，数据类型，值的左侧为爱星物联开放平台这边的功能点配置，右侧需要填入第三方语音平台的功能点配置，选择爱星物联开放平台属性后，会自动选择类型，这时我们需要相应填入第三方语音平台的功能点标识和类型，如爱星物联开放平台的开关属性的值类型为布尔类型，但是天猫精灵的功能点值类型一般都为数值型，这个时候我们一定要注意，第三方语音平台的值类型为什么类型就要选择什么类型，如天猫精灵开关值为0，1，那我们就要选择枚举型或者整型，因为不管是设备的语音属性上报，还是语音下发控制，都会存在爱星物联开放平台和第三方语音平台的值类型转换，这很重要，有可能会造成设备属性上报失败，或者语音下发控制失败。

支持的数据类型有：

  • 枚举型（Enum）
  • 浮点型（Double）
  • 布尔型（Bool）
  • 整型（Int）
  • 字符型（String）

然后值字段有数值范围和数值列表两个选项，如果是数值范围，还需要注意单位之间的转换问题，具体可以参考以下两张截图：

image-20221213113701001

image-20221213113813258

语音控制设备​

配置好以上这些信息后，需要在爱星物联开放平台相关产品下生成设备三元组，创建相应的设备，烧录MCU SDK，并上线，通过爱星物联app配网成功，并确认设备已经上线，然后使用天猫精灵账号登录天猫精灵app，并绑定天猫精灵音箱，进行账号授权登录，并从爱星物联平台获取到已激活并上线的设备列表，用户就可以通过天猫精灵音箱来控制相应的设备。

image-20221213140111254