> ## 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.

# 使用實體物件儲存玩家資料

> 使用 SetObjects 和 GetObjects 在 PlayFab 實體上儲存和擷取小型 JSON 物件，並提供玩家資料的 C# 範例和 Game Manager 檢閱方式。

實體物件可讓您讀取和寫入附加至實體的小型 JSON 可序列化物件。所有實體類型都支援相同的 `GetObjects` 和 `SetObjects` 方法。

下列範例示範在 `title_player_account` 上設定和讀取 `Object`。

```csharp theme={null}
var data = new Dictionary<string, object>()
{
    {"Health", 100},
    {"Mana", 10000}
};
var dataList = new List<SetObject>()
{
    new SetObject()
    {
        ObjectName = "PlayerData",
        DataObject = data
    },
    // A free-tier customer may store up to 3 objects on each entity
};
PlayFabDataAPI.SetObjects(new SetObjectsRequest()
{
    Entity = new EntityKey {Id = entityId, Type = entityType}, // Saved from GetEntityToken, or a specified key created from a titlePlayerId, CharacterId, etc
    Objects = dataList,
}, (setResult) => {
    Debug.Log(setResult.ProfileVersion);
}, OnPlayFabError);
```

```csharp theme={null}
var getRequest = new GetObjectsRequest {Entity = new EntityKey {Id = entityId, Type = entityType}};
PlayFabDataAPI.GetObjects(getRequest,
    result => { var objs = result.Objects; },
    OnPlayFabError
);
```

## Game Manager 和實體

Game Manager 可讓您操作玩家的物件和檔案。玩家概觀已更新，可同時顯示遊戲玩家帳戶和主要玩家帳戶資訊。

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/entities/tutorials/game-manager-entities-player-overview.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=ceac36d3b1e7fd248caeedbf4bea8055" alt="Game Manager - 實體 - 玩家概觀" width="1800" height="1406" data-path="images/playfab/live-service-management/game-configuration/entities/tutorials/game-manager-entities-player-overview.png" />

此外，檔案和物件現在在 **Players** 索引標籤中各有自己的區段。

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/entities/tutorials/game-manager-entities-player-files.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=70b96669460d8bb673ec25fdbcd1bd41" alt="Game Manager - 實體 - 玩家檔案和物件" width="1800" height="969" data-path="images/playfab/live-service-management/game-configuration/entities/tutorials/game-manager-entities-player-files.png" />

## 相關功能

實體物件和檔案用於多項 PlayFab 功能，每項功能都限定於不同的實體類型：

| 功能 | 實體類型 | 使用案例 |
| - | - | - |
| [遊戲伺服器設定](/zh-TW/services/playfab/live-service-management/game-configuration) | `game_server` | 伺服器端設定和伺服器授權的資料 |
| [遊戲資料](/zh-TW/services/playfab/live-service-management/game-configuration/titledata) | `namespace`, `title` | 所有玩家共用的全域索引鍵/值設定 |
| [玩家資料](/zh-TW/services/playfab/player-progression/player-data) | `title_player_account`, `master_player_account`, `character` | 每位玩家的設定檔、進度和喜好設定儲存 |
| [群組](/zh-TW/services/playfab/community/associations/groups) | `group` | 在玩家群組或公會內共用的資料 |


## Related topics

- [玩家資料](/zh-TW/services/playfab/player-progression/player-data/index.md)
- [PlayFab GDPR - 匯出玩家資料](/zh-TW/services/playfab/data-analytics/privacy-compliance/gdpr-exporting-player-data.md)
- [PlayFab GDPR - 刪除玩家資料](/zh-TW/services/playfab/data-analytics/privacy-compliance/gdpr-deleting-player-data.md)
- [實體檔案](/zh-TW/services/playfab/live-service-management/game-configuration/entities/entity-files.md)
- [遊戲伺服器設定概觀](/zh-TW/services/playfab/live-service-management/game-configuration/index.md)