---
title: "虚拟货币"
description: "在 Adapty 中定义应用内货币，将其与产品关联以自动发放积分，并跟踪每位用户的余额。"
---

<CustomDocCardList ids={['virtual-currency-quickstart', 'create-virtual-currency', 'virtual-currency-balance']} />

当用户购买产品或续订订阅时，向其授予虚拟货币——AI 代币、积分或金币。只需定义一种货币，将其关联到需要发放奖励的产品，Adapty 即可自动为每位用户记账并维护其余额。您的应用通过[服务端 API](getting-started-with-server-side-api) 读取和消耗该余额——例如，按次扣减生成所需的代币。

## 工作原理 \{#how-it-works\}

1. [创建虚拟货币](create-virtual-currency)：打开 **Products** 并点击 **Virtual currency** 标签页。点击 **New virtual currency**。为货币定义代码、名称以及可选的描述信息。
2. **将货币关联到产品**：将货币映射到一次性购买或订阅产品，并设置每次购买可获得的积分数量。
3. **自动发放积分**：当用户购买关联的一次性产品或续订关联的订阅时，Adapty 会自动将配置的积分添加到其余额中。
4. **查看和消费余额**：您的应用通过服务端 API 读取每位用户的余额并进行积分的发放或消费操作。
5. **追踪每一次变动**：每次余额变动都会记录在[用户的画像](virtual-currency-balance)中。

完整的操作流程（从货币设置到通过 API 使用积分），请参阅[虚拟货币快速入门](virtual-currency-quickstart)。

## 使用场景 \{#use-cases\}

| 应用类型 | 如何使用虚拟货币 |
|----------|-------------------------------|
| **AI 应用**（图像、视频或文本生成） | 每次生成消耗积分。订阅中包含每月积分额度，并将积分包作为一次性商品出售。 |
| **短剧和视频应用** | 消耗金币解锁剧集。为订阅用户提供周期性金币额度，并将金币包作为一次性商品出售。 |
| **语言学习和教育** | 通过服务端 API 为免费用户提供有限的爱心或生命值额度。付费方案中提供更大额度，或完全跳过余额校验。 |
| **手游** | 同时运行软货币和硬货币：通过服务端 API 因游戏玩法奖励金币，出售宝石换取现金，并在单个原子事务中实现相互兑换。 |
| **生产力应用** | 用积分计量高成本操作（如 OCR 或导出）。免费用户获得少量额度，订阅后获得更多额度，批量工作时可购买积分包。 |

:::tip
对于订阅配额，请开启[积分到期](create-virtual-currency#link-products)功能。每次续订时未使用的积分自动清零，这样配额就始终是用户保持订阅的动力，重度用户也会选择购买积分包，而不是慢慢消耗囤积的积分。
:::

## 限制 \{#limitations\}

- **跨设备访问需要身份识别**：余额归属于某个用户画像。匿名用户的余额仅保留在其获得余额的设备上，因此请识别用户身份，以便在所有设备上共享余额。详见[余额、用户画像与设备](virtual-currency-balance#balances-profiles-and-devices)。
- **仅支持服务端操作**：目前尚无 SDK 方法可读取或消耗余额，因此应用需要一个后端服务，通过服务端 API 读取余额并进行充值或消耗操作。
- **每个应用最多支持 20 种货币**：一个应用最多可创建 20 种虚拟货币。