> ## 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# 샘플을 제공합니다.

엔터티 오브젝트를 사용하면 엔터티에 첨부된 작고 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
);
```

## 게임 관리자와 엔터티

게임 관리자를 통해 플레이어의 오브젝트와 파일을 조작할 수 있습니다. 플레이어 개요는 타이틀 플레이어와 마스터 플레이어 계정 정보를 모두 표시하도록 업데이트되었습니다.

<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="게임 관리자 - 엔터티 - 플레이어 개요" 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="게임 관리자 - 엔터티 - 플레이어 파일 및 오브젝트" width="1800" height="969" data-path="images/playfab/live-service-management/game-configuration/entities/tutorials/game-manager-entities-player-files.png" />

## 관련 기능

엔터티 오브젝트와 파일은 다음과 같이 서로 다른 엔터티 유형으로 범위가 지정되어 여러 PlayFab 기능에서 사용됩니다.

| 기능                                                                                | 엔터티 유형                                                       | 사용 사례                      |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------------------------- |
| [게임 서버 구성](/services/playfab/live-service-management/game-configuration)          | `game_server`                                                | 서버 측 설정 및 서버 권한 데이터        |
| [타이틀 데이터](/services/playfab/live-service-management/game-configuration/titledata) | `namespace`, `title`                                         | 모든 플레이어가 공유하는 전역 키/값 구성    |
| [플레이어 데이터](/services/playfab/player-progression/player-data)                      | `title_player_account`, `master_player_account`, `character` | 플레이어별 프로필, 진행 상황, 환경설정 저장  |
| [그룹](/services/playfab/community/associations/groups)                             | `group`                                                      | 플레이어 그룹 또는 길드 내에서 공유되는 데이터 |


## Related topics

- [플레이어 게시자 데이터를 사용하여 다중 타이틀 플레이 보상 부여](/ko/services/playfab/player-progression/player-data/using-player-publisher-data.md)
- [엔터티 파일](/ko/services/playfab/live-service-management/game-configuration/entities/entity-files.md)
- [플레이어 데이터 빠른 시작](/ko/services/playfab/player-progression/player-data/quickstart.md)
- [엔터티 마이그레이션 정보](/ko/services/playfab/live-service-management/game-configuration/entities/migration-information.md)
- [PlayFab GDPR - 플레이어 데이터 내보내기](/ko/services/playfab/data-analytics/privacy-compliance/gdpr-exporting-player-data.md)