> ## 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 游戏数据概述：作用域为 title 和 namespace 实体的全局键/值配置，用于远程游戏设置，包括内部游戏数据。

游戏数据是作用域为你的 `title` 和 `namespace` 实体的全局键/值配置存储。使用它可以远程管理游戏设置，而无需部署新构建。

游戏数据是 PlayFab 中的几种存储功能之一，每种功能都作用于不同的实体类型。有关比较，请参阅[实体对象](/services/playfab/live-service-management/game-configuration/entities/entity-objects#related-features)。

## 工作原理

游戏数据是一组键/值对，你可以在 Game Manager 中或通过 [API](https://learn.microsoft.com/en-us/rest/api/playfab/admin/title-wide-data-management?view=playfab-rest\&preserve-view=true) 设置。这通常被称为主游戏数据。

*内部*游戏数据是一组特殊的游戏数据，客户端无法直接访问，可用于存储*仅*对你所控制的服务可用的配置。

<Note>
  游戏数据值被复制并分发到 PlayFab 服务器群集中可能*数百*台机器上。作为此过程的一部分，游戏数据会被缓存，并且更改可能需要长达 15 分钟才能在这些缓存中刷新。游戏数据最适合*全局常量/静态数据*，不适合或不可靠作为全局变量。
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-onboard.PNG?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=3a90b2c31d147d72cde1d8a8aad1a2c2" alt="游戏数据的屏幕截图" width="3000" height="1583" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-onboard.PNG" />

## 游戏数据覆盖

游戏数据覆盖是一组键/值对，用于存储和管理以覆盖主游戏数据。此覆盖键/值对集作为附加操作持久存在。使用覆盖，可以：

* **添加**新的键值对，方法是命名一个默认数据中不包含的键值对。
* **更改**现有的键值对，方法是命名一个已在默认数据中的键值对。此新数据将替换现有的键值数据。
* **移除**现有键值对，方法是包含现有键但值为空。

在查看覆盖时，每个键值对都表示为 +、  或 -。

覆盖游戏数据可以称为主游戏数据的子集，允许在不部署新构建的情况下更新游戏的远程配置。

<Note>
  此覆盖键/值对集目前仅在使用[实验](/services/playfab/live-service-management/game-configuration/experiments)时生效。
</Note>

如果玩家属于包含游戏数据覆盖的实验变体，则覆盖会自动应用在服务器端，并在客户端与游戏数据一起返回。

<Note>
  游戏数据覆盖值可能需要长达一分钟才能刷新和持久化。
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data.PNG?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=16682590418c79dd5afd0fb373bd6fab" alt="游戏数据的屏幕截图" width="2999" height="1985" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data.PNG" />

## 链接

* [游戏数据快速入门](/services/playfab/live-service-management/game-configuration/titledata/quickstart)
* [使用发布者数据](/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data)


## Related topics

- [什么是 PlayFab？](/zh-CN/services/playfab/get-started/what-is-playfab.md)
- [TitleDataType 数据类型](/zh-CN/services/playfab/api-references/events/data-types/titledatatype.md)
- [玩家数据](/zh-CN/services/playfab/player-progression/player-data/index.md)
- [title_data_updated](/zh-CN/services/playfab/api-references/events/TitleData/title-data-updated.md)
- [PlayFab 数据与分析文档](/zh-CN/services/playfab/data-analytics/index.md)