在前端开发过程中，使用第三方库或框架可以大大提高开发效率和代码质量。@alexa-games/gameon-sdk 是一个为 Alexa 游戏开发者设计的 SDK，旨在简化 Alexa 游戏开发过程。本文将向您介绍如何使用 @alexa-games/gameon-sdk。
准备工作
- 注册 Amazon 开发者账户。
- 安装 Node.js 和 npm。
- 安装代码编辑器，如 Visual Studio Code。
- 创建一个 Alexa 开发者账户。
安装 @alexa-games/gameon-sdk
在命令行中输入以下命令：
npm install @alexa-games/gameon-sdk
创建 Alexa 技能
要构建一个 Alexa 技能，您需要定义一组 Alexa Directives。这些指令告诉 Alexa 如何与您的服务交互。为了创建 Alexa Direcitve，您需要：
- 在 Alexa 开发者账户中创建一个技能。
- 使用技能模型定义您的技能。
- 创建 Lambda 函数来处理技能请求。
- 使用 Alexa Skill Kit 来将您的 Lambda 函数连接到 Alexa Voice Service。
完整的创建 Alexa 技能的过程已经超出了本文的范畴。您可以在 Alexa Developer Console 上查看更多信息。
引入 @alexa-games/gameon-sdk
在您的 Lambda 函数中，您需要将 @alexa-games/gameon-sdk 引入您的代码中：
const gameOn = require('@alexa-games/gameon-sdk');创建 Gameon 实例
在 Lambda 函数中，您需要创建一个 Gameon 实例来处理来自 Alexa 的请求。在新建 Gameon 实例时，您需要提供以下内容：
- 您的 Gameon GUID。您可以在您创建 Gameon 领域（域是您的 Alexa 技能）时获得这些信息。
- Gameon API URL。
- Gameon 测试环境的 URL。
- 一个引用 AWS 的 Lambda context 对象。
- 一个 Lambda event 对象。
-- -------------------- ---- -------
--------------- - ----- -------- ------- -------- -
----- -------------- - -----------------------
----- -----------------
---- -----------------------------------------------
----- ------------------------------------------
-------- --------
------ -----
---
--处理 Alexa 请求
在创建 Gameon 实例之后，您需要为您的 Alexa 技能的请求配置正确的处理器。@alexa-games/gameon-sdk 支持处理下列请求：
- Alexa Launch Request（启动请求）
- Alexa Intent Request（意图请求）
- Alexa End Session Request（结束请求）
在处理 Alex 请求之前，您需要为您的技能创建并注册所有必要的自定义指令处理器。您可以使用一组 Gameon 方法来让技能回应您的 Alexa 请求：
-- -------------------- ---- -------
--------------- - ----- -------- ------- -------- -
----- -------------- - -----------------------
----- -----------------
---- -----------------------------------------------
----- ------------------------------------------
-------- --------
------ -----
---
---------------------------------- -- -
-- ---------
---
-------------------------------------------
------- ------------- -------- -- -
-- -------
-
--
---------------------------------------- -- -
-- ---------
---
--发送 Gameon 消息
一旦您从 Alexa 请求中收到数据并处理完毕，您可以将操作结果发送回 Gameon 服务。在 Gameon 实例中可用的消息类型：
- SetMatch 将当前配置为一个比赛。
- RecordMatchScore 记录比赛分数。
- CancelMatch 取消正在进行的比赛。
- RecordMatchResult 记录比赛结果。
- UpdateMatchAttribute 更新比赛属性。
以下是一个发送 RecordMatchResult 消息的例子：
-- -------------------- ---- -------
--------------- - ----- -------- ------- -------- -
----- -------------- - -----------------------
----- -----------------
---- -----------------------------------------------
----- ------------------------------------------
-------- --------
------ -----
---
-------------------------------------------
------- ------------- -------- -- -
-- -------
---------------------
----- --------------------
------- -
------ -----
---------------- -
------ -------
-
-
---
-
--
--总结
在本文中，我们向您介绍了如何安装、创建 Gameon 实例、处理 Alexa 请求以及发送 Gameon 消息。如需了解更多关于 @alexa-games/gameon-sdk 的信息，请参阅 官方文档，这是一项引人入胜而广泛的 SDK。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/86333