npm 包 @alexa-games/skills-gameon-sdk 使用教程

阅读时长 5 分钟读完

介绍

@alexa-games/skills-gameon-sdk 是官方提供的 Alexa 游戏开发工具包,支持在 Alexa 技能中使用 GameOn API 来创建比赛和管理玩家。本文将介绍如何使用它。

安装

使用 npm 安装 @alexa-games/skills-gameon-sdk :

使用

首先在你的 Alexa 技能中创建一个新的 GameOn 实例,然后将其用于所有 GameOn API 请求。以下示例代码演示了如何创建 GameOn 实例:

-- -------------------- ---- -------
----- ----- - ------------------------
----- ------------- - --------------------------------------------------------

----- ------------- - --- ---------------
  ------------ --------------------------
  -------------- ------- -------------------
  ----------- --
  -------- ------
  ------- --------
  -------- -----
---

----- --------- - ----- -----------------------------------

上面的示例中,我们创建了一个 GameOnService 实例并使用它来获取当前游戏状态。

示例代码

接下来,我们将看一些更具体的示例代码:

创建比赛

-- -------------------- ---- -------
----- ----- - ------------------------
----- ------------- - --------------------------------------------------------

----- ------------- - --- ---------------
  ------------ --------------------------
  -------------- ------- -------------------
  ----------- --
  -------- ------
  ------- --------
  -------- -----
---

----- ---- - ----- --------------------------
  ----- -------
  ------------ -------
  ----- ----------
  --------------------- --------------------------------------- ----
  ------ -
    ------------- --------------
    --------- ---
    -------- --------
  --
---

----------------------

上面的示例中,我们创建了一个名为“游戏名称”的 GameOn 游戏,并设置了一些参数,例如游戏类型,比赛规则等。创建完成后,我们可以使用 game.url(比赛的唯一 URL)来分享游戏给用户。

加入比赛

-- -------------------- ---- -------
----- ----- - ------------------------
----- ------------- - --------------------------------------------------------

----- ------------- - --- ---------------
  ------------ --------------------------
  -------------- ------- -------------------
  ----------- --
  -------- ------
  ------- --------
  -------- -----
---

----- --------- - ----- -------------------------------- ----------
-----------------------

上面的示例中,我们加入传入的比赛并获取到该比赛的加入码(joinToken),我们可以将它分享给用户来帮助他们快速进入该比赛。

管理玩家

-- -------------------- ---- -------
----- ----- - ------------------------
----- ------------- - --------------------------------------------------------

----- ------------- - --- ---------------
  ------------ --------------------------
  -------------- ------- -------------------
  ----------- --
  -------- ------
  ------- --------
  -------- -----
---

----- -------- - ----- ----------------------------
  --------- -----
  ------ ----------------------
  ------------ -----
  ------------ --------
---

----------------------

上面的示例中,我们创建了一个新的玩家,并获取到了该玩家的 ID。之后,我们可以使用该 ID 来管理该玩家,例如更新其个人资料、获取其比赛历史记录等。

结论

@alexa-games/skills-gameon-sdk 是使用 GameOn API 的最佳方式,通过在 Alexa 技能中使用它,您可以增强您的游戏功能,为您的用户带来更好的游戏体验。我希望这篇文章能够对您有所帮助,欢迎在评论区提出任何问题或建议。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/83177