> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 经济定价计量表

> 了解 PlayFab 经济目录可计费计量表、它们衡量的操作以及目录使用量如何转化为 PlayFab 账单上的费用。

# 目录定价计量表

PlayFab 经济 V2 目录 API 有两类基于消费的计量表 - 请求和存储。本页面概述并定义了这些计量表，包括其测量和计算方式。有关 PlayFab 定价模型的更多信息，请参见 [PlayFab 定价概述](/services/playfab/pricing/pricing-overview)。

<Note>
  PlayFab 经济 V2 的一般用法可能会计入其他 PlayFab 计量表，例如 PlayStream 事件。
</Note>

## 请求

请求计量表由任何 UGC API 调用或 CDN 请求的响应大小决定。对于三种 PlayFab 计划中的每一种，都有五种不同的费率，具体取决于大小：

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/services/playfab/pricing/pricingV2-media/ugc-pricing-requests.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e8e7d1f9cf171d3af9da7177dc1df98e" alt="UGC 请求定价" width="955" height="576" data-path="images/services/playfab/pricing/pricingV2-media/ugc-pricing-requests.png" />

<Note>
  如果您计划存储超过 100 MB 的内容，请与我们联系。
</Note>

## 存储

存储计量表由所有内容（文件和图像）的总大小决定。所有定价计划均包含 5 GB。若需更多存储，该计量表根据计划有三种不同的费率。

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/services/playfab/pricing/pricingV2-media/ugc-pricing-storage.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=c3bc65ca518e4e1c5387dd068da37caa" alt="UGC 存储定价" width="912" height="205" data-path="images/services/playfab/pricing/pricingV2-media/ugc-pricing-storage.png" />

该计量表包括与未发布项目相关联的内容，以及通过公共目录不可见的项目。有关项目如何从公共目录中隐藏的更多信息，请参见 [目录项目状态](/services/playfab/economy-monetization/economy-v2/catalog/item-status)。

## 所含计量表

无论选择哪种计划，所有 PlayFab 客户都会获得一组所含计量表：

| 计量表        |   所含数量   |
| ---------- | :------: |
| 最多 1 MB 请求 | 150k 个请求 |
| 存储         |   5 GB   |

<Note>
  处于开发模式的工作室在启用 UGC 之前必须输入付款信息，超出部分将按上述费率收费。
</Note>

## 账单示例

让我们通过一个客户的目录使用示例来查看他们的月度账单。此示例游戏使用 *按需付费* 计划。让我们从单个用户开始。该用户前往内容发现页面并搜索"dinosaurs"。向用户显示 10 个结果，每个结果都有标题和缩略图。用户选择一段内容，随后会显示完整的元数据，包括描述、评分和另外四张图像。用户认为该内容看起来足够有趣，因此选择下载按钮。

现在让我们看看这种情况带来的计量表消耗：

* 该用户前往内容发现页面并搜索"dinosaurs"。向用户显示 10 个结果，每个结果都有标题和缩略图。
  * `SearchItems` 调用返回了 10 个带有基础元数据的项目，产生一个"**最多 1 MB 请求**"。
  * 10 个缩略图中的每一个都从 CDN 请求。假设其中 5 个略小于 1 MB，5 个略大于 1 MB。这种情况会产生 5 个"**最多 1 MB 请求**"和 4 个"**最多 5 MB 请求**"。
* 用户选择一段内容，随后会显示完整的元数据，包括描述、评分和另外四张图像。
  * `GetItem` 调用返回了带有完整元数据的单个项目，产生一个 **最多 1 MB 请求**
  * `GetRatings` 调用返回了单个项目的评分，产生一个 **最多 1 MB 请求**
  * 四张图像中的每一张都从 CDN 请求。作为更高质量的图像，其中两张图像 *小于* 5 MB，两张图像 *大于* 5 MB。这种情况会产生两个"**最多 5 MB 请求**"和两个"**最多 25 MB 请求**"。
* 用户认为内容看起来足够有趣，因此选择下载按钮。
  * 从 CDN 请求内容。作为大块内容为 20 MB。这种情况会产生一个 **最多 25 MB 请求**。

| 计量表       | 请求计数 |
| --------- | ---- |
| 最多 1 MB   | 8    |
| 最多 5 MB   | 7    |
| 最多 25 MB  | 3    |
| 最多 50 MB  | 0    |
| 最多 100 MB | 0    |

接下来，此游戏有 10,000 名用户，每天在一个 30 天的月份中执行此场景一次（300,000 次）——大致相当于一个用户平均每 9 秒执行一次。此场景会产生以下计量表消耗：

| 计量表       | 请求计数  |
| --------- | ----- |
| 最多 1 MB   | 240 万 |
| 最多 5 MB   | 210 万 |
| 最多 25 MB  | 90 万  |
| 最多 50 MB  | 0     |
| 最多 100 MB | 0     |

如果一款游戏是工作室中唯一使用 UGC 的游戏，并且该游戏在月末存储了 4 GB 的 UGC（完全被所含的 5 GB 覆盖，因此不产生 **存储** 计量表费用），最终的 UGC 账单如下所示：

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/services/playfab/pricing/pricingV2-media/ugc-sample-monthly-bill.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=fddbf962aa0ba9404fd9ed9e7474a10b" alt="账单示例" width="1200" height="401" data-path="images/services/playfab/pricing/pricingV2-media/ugc-sample-monthly-bill.png" />

## 资源

* 有关每个计量表的最新价格视图，请参见 [PlayFab 定价](https://playfab.com/pricing/)
* 查看 [消费最佳做法](/services/playfab/pricing/consumption-best-practices) 以了解如何为您的游戏保持最低的计量表使用率和成本

## 相关 API

以下 API 会导致经济目录计量表递增：

* [CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/create-draft-item)
* [CreateUploadUrls](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/create-upload-urls)
* [DeleteEntityItemReviews](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/delete-entity-item-reviews)
* [DeleteItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/delete-item)
* [GetCatalogConfig](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-catalog-config)
* [GetDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-draft-item)
* [GetEntityDraftItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-entity-draft-items)
* [GetEntityItemReview](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-entity-item-review)
* [GetItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item)
* [GetItemModerationState](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-moderation-state)
* [GetItemPublishStatus](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-publish-status)
* [GetItemReviews](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-reviews)
* [GetItemReviewSummary](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-review-summary)
* [GetItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-items)
* [PublishDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/publish-draft-item)
* [ReportItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/report-item)
* [ReportItemReview](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/report-item-review)
* [ReviewItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/review-item)
* [SearchItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/search-items)
* [SetItemModerationState](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/set-item-moderation-state)
* [SubmitItemReviewVote](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/submit-item-review-vote)
* [TakedownItemReviews](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/takedown-item-reviews)
* [UpdateCatalogConfig](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/update-catalog-config)
* [UpdateDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/update-draft-item)

<Note>
  对 CDN 的任何调用也会导致经济目录计量表递增
</Note>