干货丨亚马逊Echo接入教程

Echo是亚马逊推出的智能家居的控制装置,还是一款便携式扬声器同时还包含了一位名叫Alexa的语音助理,连上机智云后用户可以通过语音和音箱进行交互,Echo还可以提供各种信息和提醒、控制其他智能设备等功能。

亚马逊 Echo 背后的大脑是 Alexa。Alexa 是亚马逊提供的一个语音服务平台,开发者可以在 Alexa 平台上开发出新的 Skill(可以理解为插件)。这样只要用户启用了新的 Skill,那么 Echo 的功能就得到了增强。

配置产品与亚马逊Echo互联后,通过amazon echo先进的智能语音服务,当用户向Echo发送一条设备的语音指令时,Echo会识别此命令并传递给机智云,并最终与您的设备进行智能语音交互。如:向Echo说:“Hi Alexa,turn on my living room lights.”我们要让 Echo 控制一款机智云的产品,就是要在 Alexa 上开发一个针对这个产品的 Skill。

接入步骤

1、创建 Alexa Skill
打开亚马逊开发者平台并登录您的开发者账号
在菜单栏选择 “Alexa”
点击 “Alexa Skills Kit”
点击 “Add a New Skill”

请仔细阅读亚马逊的 Alexa Skill 开发文档,本文档对 Skill 的开发不做说明

账号连接

假设有一个用户下载了您的 App,并且已经绑定了您开发的基于机智云的智能产品,现在他要使用 Echo 控制您的产品。那么第一步要做的,就是让用户的亚马逊账号关联机智云账号。

机智云提供 OAuth 2.0 接口,可以让第三方应用通过 OAuth 2.0 的方式获取用户的 token,然后通过用户的 token 调用 Open API 完成绑定设备列表查询、设备状态获取以及设备远程控制等功能。

*在机智云开发者平台打开您要接入 Alexa 的产品页面

*在左边 “服务” 菜单栏下,点击 “+添加服务” 按钮

*选择 “产品互联”,提交申请

*申请通过后,机智云将自动为您的产品生成一个 OAuth 2.0 客户端,再次进入 “产品互联” 页面,可以看到 client_id,client_secret 等信息,您可以稍后设置 “Client Name”,”Redirect URL” 等信息

*打开您的 Alexa Skill 设置页面,选择 “Configuration”,参考下图进行设置

*将上面页面的 Redirect URLs 的其中任意一个,设置到机智云 “产品互联” 的 Redirect URL 中,”Client Name” 可以填写 “Alexa”
*在 Alexa Skill 设置页面,选择 “Test”,选择 “Enabled”
*这时,你在 Alexa App 中,选择 “Skills”,点击 “Your Skills”,就能看到你的 Skill 了,点击 “Link Account” 就能进入登录页面了
*输入您在自己的 App 中注册的账号和密码,如果最终出现成功连接账号的页面,您就能在 Alexa Skill 的程序中收到 Alexa 发送的用户 token 了.

使用 Open API 完成 Alexa Skill 开发

如何使用 Open API 不在本文范围内,您可以参考其他文档,完成您的 Alexa Skill 开发、提交 Skill 审核。如果您已经完成了所 Alexa Skill 开发,那么恭喜您,您可以在 Alexa Skill 设置页面提交发布申请了。

在这之前,有一点需要注意的是,亚马逊对启用了 “Account Linking” 的 Skill 有如下要求:”Authorization URL” 的域名必须属于您,并且该链接必须是 https 链接。

这就需要您完成如下几点:

拥有一个自己品牌的域名

添加一个二级域名,并且 CNAME 到 “oauth.gizwits.com”

购买一个 https 证书,并将证书文件(包括证书文件和 key 文件)发送给我们,我们将您的证书配置在我们的服务器

在 “Account Linking” 页面,将 “Authorization URL” 和 “Access Token URI” 中的域名修改为您的二级域名

在机智云开发者中心开通产品互联

产品互联功能介绍:配置您产品与第三方产品或服务联动。如亚马逊Echo音箱、IFTTT等。

目前暂只对购买了GDCS服务包的企业客户开放。

开通服务方法:点击“添加服务”,就可以看到“产品互联”,申请开通并审核通过即可使用。