按钮寻找开源项目

描述

关于

Find the Button 是一款简单的游戏，却提供了惊人的乐趣！在这个游戏中，一个玩家隐藏一个回声按钮，另一个玩家去找到它。这对小孩子来说特别有趣！我两岁的儿子喜欢跑来跑去，从闪烁的灯光中找出按钮的位置。

要玩游戏，您只需在隐藏或找到它时按一下按钮即可。每个动作有 30 秒的时间，以努力提高游戏的速度和节奏。

启动技能并启动后，整个游戏循环只需一个按钮即可操作！无需语音！您当然可以随时寻求帮助。

此外，由于这是一项不明确依赖于播放按钮颜色的技能，您可以随时禁用和启用按钮灯。我为那些可能对闪光灯敏感的人加入了这个功能，但在我这样做之后我意识到它也大大增加了找到按钮的挑战。

执行

我使用 Typescript 和 ask-sdk v2 来提高我的技能，并将我的代码托管在 AWS Lambda 上。

我喜欢尽可能地划分我的代码，所以我的处理程序索引文件总是相当简单：

import { SkillBuilders } from 'ask-sdk';import { RequestHandlers, ErrorHandlers } from './handlers';import { RequestInterceptors } from './request-interceptors';import { ResponseInterceptors } from './response-interceptors';const skillBuilder = SkillBuilders.custom();export const handler = skillBuilder    .addRequestInterceptors(...RequestInterceptors)    .addRequestHandlers(...RequestHandlers)    .addErrorHandlers(...ErrorHandlers)    .addResponseInterceptors(...ResponseInterceptors)    .lambda();

我有处理程序和拦截器的索引文件，所以我可以像这样同时导入所有处理程序。这是 RequestHandlers 索引文件：

import { RollCallStateRequestHandlers } from './RollCallState';import { GenericRequestHandlers, GenericErrorHandlers } from './Stateless';import { HideButtonStateRequestHandlers } from './HideButtonState';import { FindButtonStateRequestHandlers } from './FindButtonState';import { GameOverStateRequestHandlers } from './GameOverState';import { LaunchStateRequestHandlers } from './LaunchState';export const RequestHandlers = [ ...LaunchStateRequestHandlers, ...RollCallStateRequestHandlers, ...HideButtonStateRequestHandlers, ...FindButtonStateRequestHandlers, ...GameOverStateRequestHandlers, ...GenericRequestHandlers];export const ErrorHandlers = [ ...GenericErrorHandlers];

我将所有可能的意图分配给执行状态，然后以这种方式将它们分成文件夹。这是我的处理程序目录的结构：

 

Stateless 子目录包含不需要为其分配状态的通用处理程序（Fallback、LaunchRequest 等）

 

每个状态都有处理程序，需要根据状态执行特定操作。例如，AMAZON.HelpIntent 处理程序（认证所需的处理程序）需要根据您在技能中的位置说出不同的内容，并且始终需要以问题结束。由于基本行为始终相同（唯一可以保证在不同状态的帮助处理程序之间发生变化的是Alexa所说的），我创建了一个通用的 HelpIntentHandler 类，我对其进行扩展并且只将状态传递到其中。由于我按状态名称对所有语音消息进行排序，处理程序只需将messages[this.state].Help()传递给speak调用即可给出响应：

import { HandlerInput, ResponseBuilder } from "ask-sdk";import { MyRequestHandler } from "./MyRequestHandler.class";import { GadgetController } from "../../utils";export class HelpIntentHandler extends MyRequestHandler { constructor(private state: string) { super();    } public canHandle(handlerInput: HandlerInput): boolean { const request = handlerInput.requestEnvelope.request; const state = handlerInput.attributesManager.getSessionAttributes().state; return state === this.state && request.type === 'IntentRequest' && request.intent.name === 'AMAZON.HelpIntent';    } protected updateSessionAttributes(handlerInput: HandlerInput) { this.setSessionAttribute('hasBeenAskedAQuestion', true); this.removeSessionAttribute('inputHandlerId'); this.removeSessionAttribute('handlerStartTime'); this.saveSessionAttributes();    } protected createResponse(handlerInput: HandlerInput): ResponseBuilder { const messages = this.getRequestAttribute('messages');; const flashingDisabled = this.getSessionAttribute('flashingDisabled'); const buttonId = this.getSessionAttribute('buttonId'); let response = handlerInput.responseBuilder            .speak(messages[this.state].Help())            .addDirective(GadgetController.stopButtonDownAnimation())            .addDirective(GadgetController.stopButtonUpAnimation())            .addDirective(GadgetController.stopDefaultAnimation())            .withShouldEndSession(false); if (!flashingDisabled) { response = response                .addDirective(GadgetController.createButtonDownAnimation(undefined, 'FF0000'))                .addDirective(GadgetController.createButtonUpAnimation(undefined, 'FF0000'))                .addDirective(GadgetController.createHelpAnimation(buttonId));        } return response;    }}

您可能会注意到 HelpIntentHandler 扩展了一个名为 MyRequestHandler 的类。这是我创建的一个类，它封装了所有处理程序共有的行为，包括设置您可能已经注意到我在帮助处理程序中调用的方法、setSessionAttrribute 、removeSessionAttribute、getRequestAttribute等。这些方法和其他方法我已经写过，允许我以更方便的方式使用handlerInput中包含的attributesManager 。

我还编写了实用程序类GadgetController和GameEngine，以帮助简化两个按钮 API 的交互，因为它们不直观。我假设亚马逊会在某个时候发布这样的按钮 API 实用程序类；现在，我为使用我所构建的东西感到自豪和高兴。

总而言之，使用这些很棒的工具，将AMAZON.HelpIntent处理程序添加到您的状态之一就像下面这样简单：

import { HelpIntentHandler } from "../classes/HelpIntentHandler.class";import { STATES } from "../../data/states";export class RollCallHelpHandler extends HelpIntentHandler { constructor() { super(STATES.RollCall);    }}

。