描述

關(guān)于

Find the Button 是一款簡(jiǎn)單的游戲，卻提供了驚人的樂趣！在這個(gè)游戲中，一個(gè)玩家隱藏一個(gè)回聲按鈕，另一個(gè)玩家去找到它。這對(duì)小孩子來說特別有趣！我兩歲的兒子喜歡跑來跑去，從閃爍的燈光中找出按鈕的位置。

要玩游戲，您只需在隱藏或找到它時(shí)按一下按鈕即可。每個(gè)動(dòng)作有 30 秒的時(shí)間，以努力提高游戲的速度和節(jié)奏。

啟動(dòng)技能并啟動(dòng)后，整個(gè)游戲循環(huán)只需一個(gè)按鈕即可操作！無需語音！您當(dāng)然可以隨時(shí)尋求幫助。

此外，由于這是一項(xiàng)不明確依賴于播放按鈕顏色的技能，您可以隨時(shí)禁用和啟用按鈕燈。我為那些可能對(duì)閃光燈敏感的人加入了這個(gè)功能，但在我這樣做之后我意識(shí)到它也大大增加了找到按鈕的挑戰(zhàn)。

執(zhí)行

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

我喜歡盡可能地劃分我的代碼，所以我的處理程序索引文件總是相當(dāng)簡(jiǎn)單：

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();

我有處理程序和攔截器的索引文件，所以我可以像這樣同時(shí)導(dǎo)入所有處理程序。這是 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];

我將所有可能的意圖分配給執(zhí)行狀態(tài)，然后以這種方式將它們分成文件夾。這是我的處理程序目錄的結(jié)構(gòu)：

?

Stateless 子目錄包含不需要為其分配狀態(tài)的通用處理程序（Fallback、LaunchRequest 等）

?

每個(gè)狀態(tài)都有處理程序，需要根據(jù)狀態(tài)執(zhí)行特定操作。例如，AMAZON.HelpIntent 處理程序（認(rèn)證所需的處理程序）需要根據(jù)您在技能中的位置說出不同的內(nèi)容，并且始終需要以問題結(jié)束。由于基本行為始終相同（唯一可以保證在不同狀態(tài)的幫助處理程序之間發(fā)生變化的是Alexa所說的），我創(chuàng)建了一個(gè)通用的 HelpIntentHandler 類，我對(duì)其進(jìn)行擴(kuò)展并且只將狀態(tài)傳遞到其中。由于我按狀態(tài)名稱對(duì)所有語音消息進(jìn)行排序，處理程序只需將messages[this.state].Help()傳遞給speak調(diào)用即可給出響應(yīng)：

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;    }}

您可能會(huì)注意到 HelpIntentHandler 擴(kuò)展了一個(gè)名為 MyRequestHandler 的類。這是我創(chuàng)建的一個(gè)類，它封裝了所有處理程序共有的行為，包括設(shè)置您可能已經(jīng)注意到我在幫助處理程序中調(diào)用的方法、setSessionAttrribute 、removeSessionAttribute、getRequestAttribute等。這些方法和其他方法我已經(jīng)寫過，允許我以更方便的方式使用handlerInput中包含的attributesManager 。

我還編寫了實(shí)用程序類GadgetController和GameEngine，以幫助簡(jiǎn)化兩個(gè)按鈕 API 的交互，因?yàn)樗鼈儾恢庇^。我假設(shè)亞馬遜會(huì)在某個(gè)時(shí)候發(fā)布這樣的按鈕 API 實(shí)用程序類；現(xiàn)在，我為使用我所構(gòu)建的東西感到自豪和高興。

總而言之，使用這些很棒的工具，將AMAZON.HelpIntent處理程序添加到您的狀態(tài)之一就像下面這樣簡(jiǎn)單：

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

。

?

?

?