npm 包 `wrap-royale-core` 使用教程

wrap-royale-core 是为了简化 "Supercell" 游戏开发者编写关于 "Clash Royale" 游戏的 API 的库, 使开发者可以方便地使用 "Supercell" 的 API。

安装

wrap-royale-core 是在 npm 上发布的，因此您需要先安装并运行 npm，然后在终端或 cmd 中输入以下命令进行安装：

npm install wrap-royale-core

使用

首先，我们需要从 wrap-royale-core 导入需要使用的内容：

const { Client, AuthentificationError } = require("wrap-royale-core");

然后，我们可以创建一个新的客户端并提供 "Supercell" 开发者密钥：

const client = new Client({
  key: "my-supercell-key",
});

你也可以选择不使用密钥，这将使 wrap-royale-core 在使用官方 API 时不受限制。但是请注意，这可能会导致官方 API 的速度不如使用密钥时那么快。

用户认证

为了能够对一个用户的数据进行操作，您需要使用他们的 token 进行身份验证。用户必须在游戏中申请这个 token，然后将其提供给您的应用程序。下面是通过 Client.auth() 方法进行认证：

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

要注意的一点是，如果 Supercell 要求使用验证码进行认证，您将需要提供第三个参数（验证码），即使它为零长度字符串。

操作用户数据

一旦您有了令牌，您就可以使用它来操作用户的数据，例如获取他们的卡牌列表：

try {
  const cards = await client.getCards(token);
  console.log(cards);
} catch (e) {
  console.error(e);
}

您还可以检索有关其他用户详细信息，例如他们的当前战斗状态：

try {
  const state = await client.getState(token);
  console.log(state);
} catch (e) {
  console.error(e);
}

更多操作

除了上述功能之外，wrap-royale-core 还支持其他很多操作。您可以在 Client.js 文件中的其他方法中查找它们。在使用这些操作之前，请确保您已经阅读并理解了 Supercell 的 API 文档，这将使您更易于操作。另外，不要忘记捕获任何错误并处理它们，以及更好地使用 try/catch 块来避免引起应用程序崩溃。

总结

通过使用 wrap-royale-core，您可以轻松地使用 "Supercell" 的 "Clash Royale" API。只需创建一个客户端，通过调用 auth() 方法来对用户进行身份验证，并使用抓取到的令牌来操作用户的数据。祝您好运！

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600671178dd3466f61ffe6eb