@aghanim-sdk/checkout

中文文档
0.5.2发布于 2026/10/22MITTypeScriptESM + CJS零依赖近 30 天下载 4297

Aghanim 退赛 JS SDK – 通过 Aghanim 退赛接受支付而不离开您的网页游戏

中文使用文档
文档目录4 节
  1. 安装
  2. 快开始
  3. 没有后端开发
  4. 参考文献

@aghanim-sdk/ 检查出局

在您的网页游戏中接受付款 阿加尼姆(英语:Aghanim) 取出 — 没有页空出, 没有服务器侧运行时间 .

📖 全向导 : docs.aghanim.com/checkout/javascript-sdk 页面存档备份,存于互联网档案馆

安装

npm install @aghanim-sdk/checkout

或通过脚本标记( 曝光) window.Aghanim:

<script src="https://cdn.jsdelivr.net/npm/@aghanim-sdk/checkout/dist/aghanim-checkout.global.js"></script>

快开始

import { Aghanim } from "@aghanim-sdk/checkout";

// Key from Dashboard → Integration → API keys.
const aghanim = Aghanim.init({ apiKey: "sdk_..." });

// As soon as your game knows who the player is;
// clearPlayerId() on sign-out.
aghanim.setPlayerId("player_1");

const order = await aghanim.orders.create({ items: [{ sku: "gems-100" }] });
const checkout = await aghanim.openCheckout(order);

checkout
  .onPaid(() => showSuccessUI())
  .onClosed(() => game.resume());

这个SDK创建的命令是可消耗的. paid 只是一个 UX 信号: 来自 item.add 或将未完成的清单排出靴子、恢复和之后 paid。 。 。 .

// Always grant first — consuming the same order twice fails.
for (const order of await aghanim.orders.unconsumedDetails()) {
  grantToPlayer(order.items);
  await aghanim.orders.consume(order.id);
}

已经创建命令服务器侧吗 ? 通过不透明 checkout_url 直接穿过 :

const checkout = await aghanim.openCheckout(checkoutUrlFromYourBackend);

没有后端开发

const aghanim = Aghanim.init({
  apiKey: "sdk_mock",
  mock: { scenario: "instant_success" },
});

假设情况(instant_success, (中文(简体) ), open_external, (中文(简体) ), three_ds, (中文(简体) ), failure, (中文(简体) ), load_error, (中文(简体) ), poll_fallback, (中文(简体) ), unconsumed通过真实解析管道播放脚本事件. 见 examples/。 。 。 .

参考文献

版本与发布记录

@aghanim-sdk/checkout 共发布 12 个版本,首次发布于 2026/08/13;过去 12 个月发布了 12 个版本。

版本发布日期距今
0.5.2latest2026/10/2217 天前
0.5.12026/10/1722 天前
0.4.32026/08/242 个月前
0.4.22026/08/242 个月前
0.4.12026/08/192 个月前
0.5.02026/08/192 个月前

关于 @aghanim-sdk/checkout 的常见问题

@aghanim-sdk/checkout 是什么?

Aghanim 退赛 JS SDK – 通过 Aghanim 退赛接受支付而不离开您的网页游戏

如何安装 @aghanim-sdk/checkout?

在项目目录运行 npm install @aghanim-sdk/checkout,或使用 pnpm add / yarn add / bun add。

@aghanim-sdk/checkout 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aghanim-sdk/checkout 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@aghanim-sdk/checkout 可以商用吗?

@aghanim-sdk/checkout 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@aghanim-sdk/checkout 的下载量有多少?

根据 npm 官方下载统计,@aghanim-sdk/checkout 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,297 次,日均约 143 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aghanim-sdk/checkout 还在维护吗?

最新版本 0.5.2 发布于 2026/10/22(17 天前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/08/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。