Rokid ALL in ONE 语音交互 Skill 开发指南

官方教程

(chao.xuc) #1

对开发者,我们是认真的。

1 什么是 Rokid All in ONE 全栈语音智能开发套件

Rokid All in ONE 全栈语音智能开发套件是 Rokid 中美两地实验室数十名专家、数百名工程师经过不懈努力,通过三年软硬件端到端的细心打磨、与数万真实用户不断互动并融入顶级设计团队品质创意的成果。

开发套件拥有4/6 mic阵列、USB type-c充电调试接口、Micro HDMI显示输出、3.5mm音频输出等丰富接口以及灵活的扩展能力,对常见的I2C、SPI、UART协议提供支持。除此之外,开发套件70%的操作系统框架代码以及100%的E.E、M.E设计全部开源。

于2017年10月正式发布。

2 如何获取 All in ONE 全栈语音智能开发套件以及相关资料

2.1 获取 All in ONE 全栈语音智能开发套件

开发者可以于 11月20日 开始在 Rokid开发者社区官网 中购买,定价999元。相关页面将会在近期放出。欲购买开发套件的开发者可以在申请帖中留言,开售前我们会为您发送提醒,谢谢。

2.2 了解更多资料

我们将会陆续在 All in ONE全栈开发套件讨论区 中发布更多关于开发套件的资料,欢迎与我们一起讨论。

3 用 All in ONE 全栈语音智能开发套件开发一个语音Skill

Rokid All in ONE 全栈语音智能开发套件预装若琪完整的语音交互系统,可以直接使用若琪·月石所拥有的大部分主要功能。

3.1 启动开发套件

首先将 All in ONE 全栈语音智能开发套件通过 USB-Type C 接口接通电源,如下,

随后开发套件将会进入开机启动阶段。请使用开发套件上的3.5mm接口连接耳机或音箱,以便收听开发套件的语音反馈(开发套件默认不配备扬声器)。

开机启动阶段使用LED灯表示开机进度

启动完成后,您将会听到“请在手机上下载若琪应用,并为Pebble完成网络配置”。 此时开发套件的状态如下,

等待配网时LED灯圈将以紫色光圈转动

3.2 下载 Rokid App

使用手机浏览器打开 Rokid App 下载页,根据手机系统选择并下载安装Rokid App。

安装完毕后,点击进入 Rokid App,使用手机号进行注册并登录。 若之前在Rokid开发者社区注册过账号,或已经是Rokid用户,则请忽略此步骤。

3.2 使用 Rokid App 对 All in ONE 全栈语音智能开发套件进行配网

进入 Rokid App 后,您将看到添加设备页面。

若您已经使用Rokid App绑定某台Rokid设备,则需要在侧边栏「若琪设置 - 添加新设备」中找到此页面。

1)随机自带的Android系统,请 临时 使用若琪·月石(Pebble)的配网流程;

2)自己刷的开源版本Linux系统,请使用开发板专用配网流程,如下:

请在 「页面下方版本号处连点6下」,进入专用页面以添加All in ONE 全栈语音智能开发套件,

点击「已出现紫色灯光闪烁」来到连接蓝牙页面。

选择等待配网的开发套件「Rokid-Devboard-00010」,选择成功后您将会听到“蓝牙连接成功”。

之后您将进入连接Wi-Fi页面,为设备配置Wi-Fi。 此步骤中的Wi-Fi名称是您手机当前连接的Wi-Fi热点名。

输入Wi-Fi密码后点击「连接Wi-Fi」,您将会听到“开始连接此网络热点”,此时设备进入配网流程。 配网成功后,您将会听到“Hi,我来了”,并看到如下页面。

若配网失败,请检查您的Wi-Fi网络状态或输入的Wi-Fi密码是否正确。

添加设备后的App首页

3.3 使用 All in ONE 全栈语音智能开发套件进行语音交互

完成对 All in ONE 全栈语音智能开发套件的配网后,您就可以使用All in ONE 全栈语音智能开发套件进行语音交互了,比如您可以对若琪说:

  • “若琪,讲个笑话。”
  • “若琪,今天天气怎么样?”
  • “若琪,明天8点叫我起床。”
  • “若琪,我要听新闻。”
  • “若琪,播放周杰伦的稻香。”

当您对着开发套件说“若琪”时,将有一颗LED灯指向您的方向,表示它正在收听您的语音。

更多语音交互用法,请在APP侧边栏中的「玩转若琪」中查看。

3.4 使用 All in ONE 全栈语音智能开发套件开发一个语音交互Skill

下面我们来尝试使用 All in ONE 全栈语音智能开发套件在10分钟内开发一个简单的对话Skill。

3.4.1 创建技能

使用在APP中注册的Rokid账号登录Rokid开发者社区

登录Rokid开发者社区控制台

登录后在控制台中选择「创建技能」,进入技能开发工具

创建一个新的技能

3.4.1.1 给你的技能起个名字
  1. 技能属性请选择「公开」。
  2. 技能类型请选择「自定义技能」。
  3. 为技能起个好名字。
  4. 为技能起一个朗朗上口的「入口词」,用户将用他来唤起你的技能。
  5. 选择技能是否场景化展示时请选择「非场景化」,请不要选择系统配置哦!

此处的示例技能名称入口词均为「我要喝咖啡」。

完成后请点击「下一步」。

3.4.2 定义技能的语音交互并进行后端配置

首先请查看我们的技能模板:我要喝咖啡

3.4.2.2 定义语音交互

接着在「语音交互」页面中,

  • 将模板工程 > voice-interaction中的intent.json文件内容,复制进「意图定义」编辑框。

把intent.json的内容复制进「意图定义」

  • 提示:此时可以在该页面右侧的“语音交互测试”中测试配置是否正确。

完成后请点击「下一步」。

3.4.3 完成服务配置

接着在「配置」页面中,

  1. 选中「JS Engine」,
  2. 将模板工程 > sample-js中的js-engine.js文件内容复制到下方的编辑框中。

完成后请点击「下一步」。

3.4.4 测试你的技能

接下来,在「集成测试」页面中,

  1. 真机测试
    1. 在「测试设备」标签下选择「添加测试设备 - 添加账号下绑定设备」,将您Rokid账号下绑定的设备添加到您的技能中,作为测试设备使用。
    2. (若是自定义设备)如果需要在机器上进行测试,请根据设备Type ID、设备ID来「添加测试设备」。
  2. 页面测试
    1. 在「后端服务测试」下,输入「用户语句」,比如“若琪,打开「入口词」。”
    2. 你将会看到下方框体中出现经过Rokid语音服务解析的Json「服务请求」,和相应的「服务返回」。

添加账号下绑定设备

完成测试设备的添加

页面测试:“打开「我要喝咖啡」”

页面测试:“杭州哪里有好点的咖啡馆”

页面测试:“米萨咖啡最好喝的是哪一种”

3.4.5 自定义这个技能

  1. 首先,您可以对技能的名称和入口词进行修改,比如起一个新的名字「我要喝橙汁」。

  2. 接着您可以修改技能的intent名称和相应的用户语句。比如将问句变为「杭州哪里有好点的鲜榨果汁」。

  3. 修改Js Engine中的相关回复。

  4. 通过集成测试页面看看修改后效果吧。

3.4.6 发布

将「发布」及「隐私与合规」所需的内容填写完毕后,点击页面最下方亮起的“提交审核”按钮提交发布申请,Rokid将会于7个工作日内对您的技能进行审核,通过后技能即可发布上线。

需注意:开发者需要通过个人身份认证才可以将技能提交审核。

技能发布上线后,将会在Rokid技能商店中展示给所有Rokid用户使用。

4 分享与探索

您可以向身边的开发者分享如何获取 Rokid All in ONE 全栈语音智能开发套件并完成一个语音交互Skill的开发。同时可以通过以下方式探索更多关于 Rokid All in ONE 全栈语音智能开发套件的开发方法。


开发板指示灯状态及故障判断
新买的ALL in ONE 全栈开发套件都运行不起来
关于安卓开发套件不能蓝牙配网的问题
Rokid(全栈语音智能开发套件)开箱记
开发套件常见问题解决方案汇总
我的 Rokid 之路 附:记事本技能全部源代码
Rokid全栈语音智能开发套件S905D产品灯光颜色代表含义
(misa.zhu) #2

赞!


(chao.xuc) #3

(daniel.wu) #4

顶~


(childman) #5

999是不是太贵了


(120578270) #6

申请申请


(若。若) #7

灰度客户需要申请一个


(hzyyzs) #8

一直灰度用户申请一个!


(lijall) #9

Misa给我留一个!!!


(jiangfrom2012) #10

来一个呀


(智能阿才) #11

给我留一个 申请申请


(fei6461) #12

我也要一个…来自马来西亚的用户


(hans.chen) #13

申请预留一个,申请一下


(57939812) #14

申请一个


(513485189) #15

进入 Rokid App 后,您将看到添加设备页面。
若您已经使用Rokid App绑定某台Rokid设备,则需要在侧边栏「若琪设置 - 添加新设备」中找到此页面。
请在此 「页面空白处连点5下」,进入专用页面以添加All in ONE 全栈语音智能开发套件,

点不了,点了没任何反应


(hans.chen) #16

点了,都没有反应


(spursyy) #17

开发者组件的链接是什么,如何购买?


(快乐小猪头爸爸) #18

若祺app上找不到链接开发套件的页面,咋回事?


(chao.xuc) #19

当前有个小bug,如果使用开发板预装的系统请直接用pebble的配网流程。
下周修复后,
对添加设备页面的下方连续点击5下,可以进入开发板专用的配网页面。

谢谢。


(416566462) #20

您好,若琪app搜不到蓝牙设备,开发套件是处于紫色光圈加转动状态的,但是app里一直搜不到设备,请问要如何解决哈,我的手机是iphone6s