Rokid webhook 指南 手把手教你做个懒人

  1. 云栖社区>
  2. Rokid>
  3. 博客>
  4. 正文

Rokid webhook 指南 手把手教你做个懒人

大发呀 2018-05-02 20:19:19 浏览2551
展开阅读全文

若琪用户 Amadeus 在社区里分享过很多视频。当你进门10秒后还未关闭房门,若琪会一直报警提醒;当你走进门后将门反锁的那一刻,若琪会为你播报今天的天气、为你播放设定的轻音乐。

看到这些视频中对传感器、智能情景的熟练运用,你很难想象他们都出自一名跟互联网和 IoT 都不相关的国家公职人员之手。作为一个智能家居爱好者,他不会编写代码,却仔细地去研究每一个变量代表的含义,并事无巨细地在若琪开发者社区和大家分享如何拓展若琪 webhook 功能。

现在把文章分享给大家。


以下摘录于 Amadeus 开发日记:

《如何使用 Rokid 的 webhook 功能》

最近一些智能家居用户,尤其是 AmazingBOX 用户,在很多智能家居场景中使用了若琪提供的webhook 功能,让若琪进行 TTS 语音播报和音乐的播放。如回家打开智能锁,不用语音唤醒,不说语音命令,若琪就能为你播报现在的时刻、室内的温湿度以及播放背景音乐等。大家感觉这种操作非常酷炫,于是纷纷在 Rokid 的 app 中寻求这种设置的帮助。但打开 Rokid 的 app,却发现设置无从下手,因为对于小白来说这些基本看不懂。

那么,AmazingBOX 用户为什么能够轻而易举地进行 TTS 语音播报的设置和音乐的播放设置呢? 这是因为 AmazingBOX 的情景设置页面里有若琪的插件。

如下图:
_2018_05_02_10_49_25

下面就为 AmazingBOX 新用户讲述如何使用若琪插件。

若琪插件在使用时,需要添加序列号和 webhook token 地址。打开若琪插件,点击右上角的问号,会出现操作引导,跟着引导走。webhook 创建后,就可以看到 Webhook token 地址了。一定要使用下图红框中的部分,有的用户把整个地址添加到若琪插件,结果若琪不出声,浪费了许多时间。建议添加序列号和 Webhook token 地址时采用复制粘贴,不要用键盘一个一个地键入。由于序列号和Webhook token 地址经常使用,建议把序列号和 Webhook token 地址保存在一个文本文件里。粘贴时要在输入框的起始位置粘贴,前面不要有空格。

有了若琪产品序列号和 Webhook token 地址,如何开始播报设置呢?

基本概念

设备分为实体设备和非实体设备。温湿度传感器的属性就是实体设备的属性,日期时间这样的属性就是非实体设备的属性。

举例1:温湿度传感器的温湿度数值就是温湿度传感器的属性;

举例2:智能门锁的门磁状态、锁舌状态等就是智能门锁的属性。

有的属性是用数字表示的,并且不带单位,如温湿度传感器的温湿度数值,有的属性是用文字表示的,如智能门锁的各种状态。无论是数字表示还是文字表示,这些属性的值都是会变化的,都是变化着的量,所以就有了变量的说法。

播报实体设备的属性非常简单,播报非实体设备的属性需要用到变量或插件,变量里需要书写代码,不会书写代码可以复制粘贴大神们散布出来的各种代码。

下面先介绍实体设备的属性播报。

图示举例:

下图表示在 AmazingBOX 的情景流程设计中,点开若琪插件,出现动作属性设定,选择播放语音会让你填入播放内容,点击属性按钮,会出现选择设备的输出属性,如果想播放温湿度的数值,我们就点击小三角然后选择温湿度传感器,AmazingBOX 的温湿度传感器有较多属性,需要什么属性就加入什么属性。该图选择的是温度属性,显示的当前变量值即属性值是20.0,语音播报出来就是读成“二十点零”,没有单位读音,单位需要我们自己添加。
_2018_05_02_10_49_52

下图表示的是选择智能门锁的门磁属性
_2018_05_02_10_49_58

具体操作

如何让若琪播报实体设备属性的值呢?方法非常简单,操作特别方便,适合 AmazingBOX 拥有若琪、龙猫和 usb 播报设备的用户。

首先,打开 AmazingBOX 的电脑情景流程设计面板,建一个手动流程,触发流程、周期流程也可以。“手动→若琪插件”,这就是手动流程的基本框架,图示如下:
_2018_05_02_10_52_16

具体步骤:

将“开始”拖入,然后选择其中的“手动”;

将若琪插件拖入;

用线将“手动”和“若琪插件”连接;

在若琪插件中填写内容;

将流程终点的实心点,点击成圆圈,表示流程结束。

那么怎样填写我们想要播报的设备属性呢?我们点开若琪智能家庭机器人,会出现下面的图:

_2018_05_02_10_52_43

我们在播放内容的框里需要填上设备的属性和一些固定不变的文字,设备属性的书写有一定规范,涉及格式、端末名称、属性名称等,如果是打字输入就难了,好在不是打字输入。点开播报内容框右面的(x),这个叫属性按钮,选择要播报的设备名称(注意:设备不要有重名,需要设备配对入网后就个性化命名),然后点击属性名称,选择需要的属性,点击确认,播报内容里出现“@xxxx.xx;”双引号里面的部分,属性的规范书写格式自动出现在里面了。注意:;,这个分号是键盘英文输入状态下的分号。

图示举例如下这张图表示我选择了温湿度传感器的两个属性,温度和湿度,如果这时候保存流程并试听流程,我们听到的只是数字,连单位都没有,所以我们需要在属性的一左一右添加文字、单位和标点符号等。
_2018_05_02_10_53_27

我们添加内容都是在上图的红色框以外添加,红色框内的部分是设备的属性名称,千万不要破坏。
_2018_05_02_10_54_29

这张图表示在属性外用文字及标点符号串联属性,播放出来的效果是“当前室内温度是x℃,室内湿度是百分之x。”, x是设备属性的数字值,是变化的量,简称变量。我们输入文字和标点符号时尽量规范,因为播报内容在若琪app里有反馈。另外,标点符号有停顿效果,听起来不那么快。
以上就是用语音播报实体设备属性的基本设置, 这种设置适用于实体设备的属性播报。那么非实体设备的属性如何播报呢?这就涉及到了变量,真正意义的变量。

举例:“今天是2018年4月20日,星期5,现在是17点10分。” 这段话如何播报呢?这段话里的数字是会变化的,这样的播报流程就需要在若琪插件前加上变量应用。

手动流程的大框就是如下图。

_2018_05_02_10_56_38

.

那么变量应用如何应用呢?点开变量应用,会出现下图,点击右上角的“?”,就会出现变量的使用说明

使用说明精读几遍,虽然读不懂,但也能有个了解,知道了变量应用的大框我们就能读懂带变量应用的流程了。那么“今天是2018年4月20日,星期5,现在是17点10分。”这句话怎样在变量应用的流程里设置呢?看下图:
_2018_05_02_10_57_51

这张图是把变量应用节点展开后的图,并且填上了动作代码和保存变量列表。
我们仔细看动作代码输入框里的动作代码,发现有三行代码,分别是日期代码、时间代码和星期代码。还发现有等于号,等于号左边的部分也添加到了保存变量列表里了。我们这样理解,每一行代码相当于一个数学公式,跟勾股定理(a²+b²=c²)比较一下,上图中等于号左边的部分相当于c²,等于号右边的部分相当于a²+b²,等于号右边一变化,等于号左边就出现一个值,我们就让若琪播放这个值,所以要把等于号左边的部分填入到若琪插件中。如下图

我们在若琪插件中填写的变量名称一定要符合规范,千万不要输错。

如果这时保存流程并运行,仔细一听,设备读出的是“2018年4月20日 5 10点10分”了。也就是说“@日期;”这个变量名称输出为“2018年4月20日”,“@week;”这个变量名称输出为“5”,“@时间;”这个变量名称输出为“10点10分”。

如前所述,我们需要在播报内容里的“@日期; @week; @时间; ”双引号里的属性之间或属性前后加上文字和标点符号,也就是变成类似这样“今天是@日期;,星期@week;,现在是@时间; 。”, 这样若琪播放出来就是“今天是2018年4月20日,星期5,现在是17点10分。”了。

变量里代码的书写是关键,需要学习,达到一定学识才能会写,如果不想学,可以使用大神们书写的代码,大神们书写了各种各样的代码,足够我们使用了。

上例中的变量代码如下:

@日期;=date("Y-m-d",time()+60*60*8);

@时间;=date("H:i",time()+60*60*8);

@week;=date("w",time()+60*60*8);

这些代码都是大神写的,我不会写,我只是会复制粘贴。

@日期;=date("Y-m-d",time()+60*60*8); 

这个变量输出的值是年月日。有时我们感觉若琪把年说出来有些磨叽,只想要若琪读出月日,感觉简洁一些。怎么办?我们看这段代码的结构。能猜出来Ymd分别代表年月日。那么,我们把Y去掉,不就是只输出月和日了吗?我们把Y去掉,就是这样写的:

@日期;=date("m-d",time()+60*60*8);

这样若琪读出来,数据就不带有年了,只有月日。我们去到若琪里验证。发现,确实是没有年的发音了。但是,若其把4月23日读成了4比23了,怎么办?我们还有办法。我们可以单建一个月份的变量,再单建一个日期的变量。单独的月份的变量代码是这么写的:

@月;=date("m",time()+60*60*8);

单独的日期的变量代码是这么写的:

@日;=date("d",time()+60*60*8);

这样我们就把月和日拆分开了。那么,我们在若琪插件里怎么填写呢?首先我们把变量名称添加进去。就是把@月;和@日;添加进去,然后怎么办?应该明白了吧。

通过这个例子,我们能知道,我们虽然不会写代码,但是能够看懂代码,也能够修改代码为我所用。

@week;=date("w",time()+60*60*8);

这个代码,输出的是0,1,2,3,4,5,6。我们运用一周这个代码,会发现,若琪插件里填写的“星期@week;”,输出星期2时读成了星期两,星期日读成了星期0,因为输出的就是星期0,怎么办,有办法?大神们的智慧是无穷的。看下面的代码:

@星期;=$wk[date("w",time()+60*60*8)];
$wk=array("日","一","二","三","四","五","六");

用这个代码,输出"日"、"一"、"二"、"三"、"四"、"五"、"六",我们在变量名称前面加上星期填入若琪插件里,就是把“星期@星期;”填入到若琪插件里,这样若琪输出的就是“星期日一二三四五六”了,而且若琪app里的反馈,数字也是大写的了。

部分代码汇总如下:

@日期;=date("Y-m-d",time()+60*60*8);

@月;=date("m",time()+60*60*8);

@日;=date("d",time()+60*60*8);

@时间;=date("H:i",time()+60*60*8);

$wk=array("日","一","二","三","四","五","六");

@星期;=$wk[date("w",time()+60*60*8)];

今天的分享就到这里~

点击原文参与讨论

网友评论

登录后评论
0/500
评论
大发呀
+ 关注
所属团队号: Rokid