【品牌APP】接入Amazon Alexa教程
更新时间:2018-10-19 11:29:34
厂家自有品牌App控制的设备,如果也希望被Amazon Echo音箱控制,需要开发者自己去Amazon 开发者平台中创建一个Smart Home skill,并和自己的品牌App进行对接开发。以下是开发者如何对接Amazon Alexa的教程:
注意:Amazon Alexa Skill的创建是免费的,但是官方要求搭配AWS Lambda使用,Lambda会根据实际使用情况收取相应的费用。
1. 架构图
业务架构图:
核心流程链路图:
2. Smart Home Skill开发流程
2.1 注册亚马逊开发者账号
开发者需要前往亚马逊开发者平台,注册一个亚马逊开发者账号。
2.2 创建Smart Home Skill
在developer console中,找到Skills,点击Creat Skill。
为SKill起一个用户便于搜索的名称,并选择智能家居技能模板“Smart Home”。
2.3 填写基本信息
根据以下步骤,完成Amazon Alexa Skill信息的填写。
2.3.1 请根据图片填写
payload version、endpoint先不填,下文会讲解如何获得回填
2.3.2 Account Linking信息填写(oauth2.0协议)
若使用平台内置账号体系,则由阿里云提供本步骤的信息。如果使用厂家自有账号体系,则有开发者自行完善该步骤信息。
若使用平台内置账号体系,请在平台-自有品牌APP-用户账号-查看对接信息,获取相关内容,如下图所示:
将平台中的信息复制到Amazon Sill的如下字段中:
2.4 购买AWS Lambda,创建Smart Home Skill的Function
由于Amazon Alexa官方要求,使用Smart Home Skill模板的开发者,必须购买AWS的Lambda产品,完成语音控制链路中function的实现。
2.4.1 AWS Lambda 配置
我们为了让开发者更快地完成skill的开发,平台提供了现成代码的的下载,可以直接上传到AWS的Lambda中。
请根据以下步骤,完成Lambda的基本信息、上传代码、配置项的填写。
飞燕产品的amazon配置中获取示例代码:(示例代码使用的加密工具是阿里云的kms,开发者可以根据需要调整,示例代码使用到的api)
2.4.2 function ARN回填到Alexa Skill创建-步骤1的endpoint
2.5 下载Alexa App,调试Skill
下载“Amazon Alexa” App或使用web版Alexa app,菜单->skills->dev skill,找到按本文步骤创建的skill启用,输入自有品牌app的账号密码完成登陆,按照app提示获取设备列表,然后进行调试
1、准备一台接入Link Living 国际站的设备,使用厂家自有品牌App,绑定该设备。
2、准备一台Amazon Echo音箱,下载 Amazon alexa客户端并绑定该音箱
(iOS用户请至美国区App Store搜索“Amazon Alexa”下载,Android客户请至Google Play搜索“Amazon Alexa”下载)
注:在大陆地区下载Alexa app需要使用国外的应用市场账号,所以国内测试建议通过网页来配置。
网页配置地址:http://alexa.amazon.com/spa/index.html
3、在Amazon alexa客户端中点击Skills,找到自己创建的Skill,点击“ENABLE”启用。
4、输入您自己App登录的账号和密码,并正确选择您的账号所属国家,然后点击“Link Now”来绑定您的公版APP设备。
5、控制设备前,Echo需要先发现设备。你可以对Echo说:“Alexa, discover devices”。您也可以在Skill页面点击“DISCOVER”来发现设备,您绑定过的设备就会出现在列表里。(如果在你自己的App中修改了设备昵称,Echo必须重新发现设备,否则不能对设备进行控制)
6、完成以上步骤后,您可以通过下列指令控制您的设备了(如灯 Light):
Alexa, turn on/off the light. (开关设备)
Alexa, brighten/dim the light. (灯亮度增强/减弱)
Alexa, set the light to yellow. (灯颜色调节)
Alexa, set the light to warm white. (灯色温调节)
2.6 正式发布你的Skill
完成开发后,你就可以发布你的Amazon Alexa Skill了!
注意:根据Amazon Alexa提供的官方发布指引,你需要提供一个自有品牌app的账号,账号下面需要有设备,填写在发布申请的信息里,给Skill的审核人员进行测试使用,以便顺利通过审核。