Alexa Skills Kit SDK for Node.js 请求处理机制详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00346/article/details/148602593

Alexa Skills Kit SDK for Node.js 请求处理机制详解

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 Skills Kit SDK for Node.js 提供了一套完整的工具集，帮助开发者构建Alexa语音技能。本文将深入解析SDK中的请求处理机制，包括标准请求流程、请求处理器、拦截器以及错误处理器的实现原理和使用方法。

标准请求处理流程

当用户与Alexa技能交互时，技能服务会收到一个包含JSON正文的POST请求。这个请求正文包含了服务执行逻辑并生成JSON格式响应所需的所有参数。

Node.js原生支持JSON处理，因此在使用ASK SDK v2 for Node.js时，开发者无需手动进行JSON的序列化和反序列化操作。请求正文的JSON结构遵循Alexa技能的标准请求格式规范。

HandlerInput对象详解

在请求处理过程中，所有处理器（包括请求处理器、拦截器和错误处理器）都会接收到一个HandlerInput对象。这个对象是请求处理的核心，包含了处理请求所需的各种关键组件：

RequestEnvelope：完整的请求正文，包含所有Alexa发送的请求数据
AttributesManager：提供对请求属性、会话属性和持久化属性的访问
ServiceClientFactory：构建可以调用Alexa API的服务客户端
ResponseBuilder：包含创建响应的辅助函数
Context：提供宿主容器传递的可选上下文对象（如AWS Lambda函数的上下文）

请求处理器实现

请求处理器负责处理特定类型的请求，其实现基于RequestHandler接口：

interface RequestHandler {
    canHandle(handlerInput: HandlerInput): Promise<boolean> | boolean;
    handle(handlerInput: HandlerInput): Promise<Response> | Response;
}

关键方法解析

canHandle方法：
- SDK会调用此方法判断处理器是否能处理当前请求
- 可以基于请求类型、参数或技能属性进行判断
- 返回true表示可以处理，false表示不能处理
handle方法：
- 包含实际的请求处理逻辑
- 必须返回Response对象或Promise

示例代码

const HelloWorldIntentHandler = {
  canHandle(handlerInput) {
    return handlerInput.requestEnvelope.request.type === 'IntentRequest'
      && handlerInput.requestEnvelope.request.intent.name === 'HelloWorldIntent';
  },
  handle(handlerInput) {
    const speechText = '你好，世界！';
    
    return handlerInput.responseBuilder
      .speak(speechText)
      .withSimpleCard('欢迎', speechText)
      .getResponse();
  }
};

处理器注册顺序

SDK会按照注册顺序依次调用处理器的canHandle方法，直到找到第一个返回true的处理器。因此，处理器的注册顺序非常重要：

const skill = SkillBuilders.custom()
  .addRequestHandlers(
    HighPriorityHandler,  // 高优先级处理器
    MediumPriorityHandler,
    LowPriorityHandler)  // 低优先级处理器
  .create();

请求与响应拦截器

拦截器提供了一种在请求处理器执行前后插入自定义逻辑的机制。

请求拦截器

在请求处理器执行前调用，适合用于：

请求预处理
数据验证
属性初始化

interface RequestInterceptor {
    process(handlerInput: HandlerInput): Promise<void> | void;
}

响应拦截器

在请求处理器执行后调用，适合用于：

响应后处理
数据持久化
日志记录

interface ResponseInterceptor {
    process(handlerInput: HandlerInput, response?: Response): Promise<void> | void;
}

持久化属性保存示例

const PersistenceSavingResponseInterceptor = {
  process(handlerInput) {
    return handlerInput.attributesManager.savePersistentAttributes();
  }
};

拦截器执行顺序

拦截器按照注册顺序执行：

请求拦截器（注册顺序）
请求处理器
响应拦截器（注册顺序）

错误处理机制

错误处理器用于捕获和处理请求处理过程中抛出的异常。

错误处理器接口

interface ErrorHandler {
    canHandle(handlerInput: HandlerInput, error: Error): Promise<boolean> | boolean;
    handle(handlerInput: HandlerInput, error: Error): Promise<Response> | Response;
}

错误处理示例

const MyErrorHandler = {
  canHandle(handlerInput, error) {
    return error.name.startsWith('CustomError');
  },
  handle(handlerInput, error) {
    console.error(`错误发生: ${error.message}`);
    
    return handlerInput.responseBuilder
      .speak('处理您的请求时遇到问题，请稍后再试')
      .getResponse();
  }
};