在前端开发过程中,使用第三方库或框架可以大大提高开发效率和代码质量。@alexa-games/gameon-sdk 是一个为 Alexa 游戏开发者设计的 SDK,旨在简化 Alexa 游戏开发过程。本文将向您介绍如何使用 @alexa-games/gameon-sdk。
准备工作
- 注册 Amazon 开发者账户。
- 安装 Node.js 和 npm。
- 安装代码编辑器,如 Visual Studio Code。
- 创建一个 Alexa 开发者账户。
安装 @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 引入您的代码中:
----- ------ - -----------------------------------
创建 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