Alexa Skills Kit SDK for Node.js 从v1迁移到v2完全指南-优快云博客

Alexa Skills Kit SDK for Node.js 从v1迁移到v2完全指南

alexa-skills-kit-sdk-for-nodejs The Alexa Skills Kit SDK for Node.js helps you get a skill up and running quickly, letting you focus on skill logic instead of boilerplate code. 项目地址: https://gitcode.com/gh_mirrors/al/alexa-skills-kit-sdk-for-nodejs

前言

作为Alexa技能开发者，你可能已经使用过Alexa Skills Kit SDK for Node.js的v1版本（alexa-sdk）开发过技能。随着v2版本（ask-sdk）的发布，Amazon提供了更强大、更灵活的SDK架构。本文将详细介绍如何将现有基于v1 SDK开发的技能迁移到v2 SDK，同时保持功能的完整性和稳定性。

为什么需要迁移

v2 SDK相比v1版本有以下优势：

更清晰的请求处理流程
更好的类型支持
更灵活的中间件机制
更完善的错误处理
更现代的异步处理方式

迁移策略概述

Amazon提供了两种迁移路径：

渐进式迁移：使用v1适配器(v1adapter)让v1和v2代码共存，逐步替换
完全重写：直接使用v2 SDK完全重写技能

对于生产环境中的技能，推荐采用渐进式迁移策略，这样可以最小化风险。

迁移准备

环境要求

Node.js 4.3.2或更高版本
现有的基于alexa-sdk(v1)的Node.js项目

依赖安装

首先需要安装v2 SDK核心包和v1适配器：

npm install --save ask-sdk ask-sdk-v1adapter

代码迁移步骤

1. 修改导入语句

将原来的v1 SDK导入语句：

const Alexa = require('alexa-sdk');

替换为：

const Alexa = require('ask-sdk-v1adapter');

2. 保持现有v1处理逻辑

现有的v1处理逻辑可以保持不变，例如：

const handlers = {
    'LaunchRequest': function() {
        this.emit('SayHello');
    },
    'HelloWorldIntent': function() {
        this.emit('SayHello');
    },
    'SayHello': function() {
        this.response.speak('Hello World!');
        this.emit(':responseReady');
    }
};

3. 初始化代码调整

原有的初始化代码基本保持不变：

exports.handler = function(event, context, callback) {
    const alexa = Alexa.handler(event, context, callback);
    alexa.appId = APP_ID;
    alexa.registerHandlers(handlers);
    alexa.execute();
};

渐进式引入v2处理程序

1. 注册v2处理程序

使用新的registerV2Handlers方法注册v2风格的处理程序：

exports.handler = function(event, context, callback) {
    const alexa = Alexa.handler(event, context, callback);
    alexa.appId = APP_ID;
    alexa.registerHandlers(handlers); // v1处理程序
    alexa.registerV2Handlers(HelpIntentHandler); // v2处理程序
    alexa.execute();
};

2. v2处理程序示例

下面是一个v2风格的帮助意图处理程序示例：

const HelpIntentHandler = {
    canHandle: function({requestEnvelope}) {
        return requestEnvelope.request.type === 'IntentRequest' &&
               requestEnvelope.request.intent.name === 'AMAZON.HelpIntent';
    },
    handle: function({responseBuilder}) {
        const speechOutput = '这是一个示例技能，你可以对我说"你好"';
        const reprompt = '请对我说"你好"';
        return responseBuilder
            .speak(speechOutput)
            .reprompt(reprompt)
            .getResponse();
    }
};