1. 前言

本系列将向开发者介绍如何从零开始，开发一款完整的 Alexa 技能，并详细介绍对接亚马逊开放平台语音服务的设计和编码过程。通过本文，您将学习如何在 Alexa Developer Console 中创建一个新的技能，并设计技能的交互模型、配置后端服务和实现前端逻辑。

2. 开发流程

2.1. 开发前准备

2.1.1. 创建亚马逊开发者账号

前往亚马逊开发者门户网站(https://developer.amazon.com/zh/)， 创建一个免费的开发者账号。

2.1.2. 创建 Alexa 技能

登录亚马逊开发者账号后，转到alexa控制台(https://developer.amazon.com/alexa/console/ask)，控制台没有中文界面，点击 Create Skill（创建技能）按钮开始创建一个新的 Alexa 技能。
该页面主要由以下步骤：

• Name your Skill （填写技能名称），这里我填写Demo Smart2 Test
• Choose a primary locale（选择语言）,默认选择English(US)

• Choose a type of experience（选择一个体验），这里选择Smart home
• Choose a model（选择一个交互模型），这里选择Smart Home

2.1.3. 配置 Alexa 技能(上)

上一步操作保存后，会直接跳转到技能配置页面。当然你也可以稍后再配置，因为亚马逊的语音控制需要配合 Lamdba 使用，而且每一个区域使用不同的端点， 所以首先得先配置Lamdba。

需要注意的是，为了最大限度地减少地区客户延迟问题，Alexa建议选择离目标客户最近的地理区域，并设置特定于地理位置的端点。比如 美国东部 选择 北弗吉尼亚州 托管Lambda函数。至写稿前，Alexa共提供3个地理区域用来单独配置North America、Europe, India、Far East。

这步只介绍概念，等下配置。

2.1.4. 配置Lamdba

浏览器新打开一个窗口(https://us-east-1.console.aws.amazon.com/console)，如果没登陆，登陆一下。
进入后台后，在左上角的服务搜索栏里面输入：Lambda，弹出来的菜单列表，选择进入Lambda模块。
点击 创建函数

• 函数名称，这里我填写demoSmart2AlexaTest。
• 运行时，选择Java 8 on Amazon Linux 1。

• 其他默认，保存。
  完成后，可以在界面中查看其中的函数ARN就是上面需要用到的端点，而右上角就是端点所在的区域，每个区域都有不同的端点。

• 点击配置，点击环境变量，这里可以写入一些环境变量的东西，为后面Java程序函数里面可以拿到这些变量，做一些跟业务相关逻辑处理。这里我添加trace变量，值为true，用来控制是否输出日志。

• 点击代码，上传代码源，这里还没有写，下一步我们来编写一个Java函数代码，然后再来上传。

2.1.4.1. 编写Java函数代码

• 打开IDEA开发工具，新建一个maven工程。
  pom.xml文件内容如下

    4.0.0
    com.demo
    demo-alexa-func2
    jar
    2.0.1
    demo-alexa-func2
    
        1.8
        UTF-8
        1.8
        1.8
    

    
        
            cn.hutool
            hutool-all
            5.8.14
        
        
            org.projectlombok
            lombok
            1.18.16
        
        
            com.amazonaws
            aws-lambda-java-core
            1.2.1
        
    

    
        
            
                org.apache.maven.plugins
                maven-shade-plugin
                3.2.4
                
                    false
                
                
                    
                        package
                        
                            shade
                        
                    

                
            
            
                org.apache.maven.plugins
                maven-compiler-plugin
                3.8.1
                
                    1.8
                    1.8
                
            
        
    

• 新建DemoSmartHomeHandler类

package com.demo.alexa.handler;

import cn.hutool.json.JSONObject;
import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;
import cn.hutool.core.util.BooleanUtil;

/**
 * @author CaiCai
 */
public class AlexaSmartHomeHandler implements RequestHandler {

    @Override
    public Object handleRequest(JSONObject input, Context context) {
        LambdaLogger logger = context.getLogger();
        //获取环境参数
        Boolean isTrace = BooleanUtil.toBoolean(System.getenv("trace"));
        if(this.isTrace) {
            logger.log("需要log");
        }
        else{
            logger.log("不需要log");
        }
        //业务代码略
    }

}

业务逻辑实现不属于本篇幅内容，故只写了个简单的几行代码。

• 打包工程，生成demo-alexa-func2-2.0.1.jar包。

2.1.4.2. Lambda函数详细设置

• 继续2.1.3.1中步骤，上传上面打包好的jar包。

• 在运行时设置栏目，点击编辑，进入编辑运行时设置界面。

修改处理程序的文本框，改为jar包中 处理函数的全类名 + 方法名，如下：

com.demo.alexa.handler.AlexaSmartHomeHandler::handleRequest

保存。

2.1.4.3. 添加触发器

• 触发器配置
  选择第一个，Alexa(alexa iot voice)
• Choose an Alexa product
  选择第二个，Alexa Smart Home
• Skill ID

这个在2.1.2那一步完成后，在技能详情页面可以找到Your Skill ID

• 复制进来保存。

2.1.5. 配置 Alexa 技能(下)

2.1.5.1. 复制端点

将 2.1.4中完成的Lambda的函数ARN 复制到 2.1.3中的alexa技能的默认端点，这里我暂时只配置一个区域。

2.1.5.2. 配置关联账号

点击ACCOUNT LINKING，进入该配置界面。

• Settings 默认是关闭的，开启它。
  Allow users to link their account to your skill from within your application or website
• Security Provider Information
  auth2.0协议部分，按提示填写。

这里注意Your Authentication Scheme这个配置部分，如果想让client_secret通过request body传输，而不是通过header，则选择第二个Credentials in request body选项。

2.1.5.3. 配置权限

*Permissions
开启它，启用向alexa端点发送消息，这样技能将被授权异步响应Alexa指令并发送状态更改事件。

2.1.5.4. 其他配置

• 这个页面的*部分都要填充

• 上面步骤都做完，开始添加您的alexa内测试账号，用于开发调试。

2.1.6. 小结

现在准备部分的配置完成了，后面进行具体的业务开发。

未完待续...