플레이어 데이터
플레이어 데이터는 여러 디바이스와 여러 게임에서 공유할 수 있는 PlayFab 서비스에 저장된 플레이어에 대한 정보입니다.
PlayFab에서는 플레이어 데이터를 저장하는 두 가지 방법을 제공합니다.
- 엔터티: 개체의 데이터와 플레이어, 캐릭터, 그룹 전반의 파일을 저장할 수 있습니다.
- 플레이어 데이터/UserData: 플레이어의 키/값 쌍 데이터를 저장할 수 있습니다.
최고의 유연성과 성능을 제공하려면 ‘모든’ 새 타이틀에서 엔터티 개체를 사용하는 것이 좋습니다.
PlayFab API에서 함수 이름은 UserData라는 용어를 사용합니다. 게임 관리자에서 이 개념은 플레이어 데이터로 설명됩니다. 이 두 개념은 동일하며 서로 바꿔서 사용할 수 있습니다.
플레이어 데이터의 액세스 모드는 다음 세 가지입니다.
- 클라이언트: 타이틀 클라이언트가 읽고 업데이트할 수 있는 플레이어 데이터입니다. 클라이언트 API UpdateUserData를 사용하여 플레이어 데이터를 생성, 업데이트 또는 삭제하고 GetUserData를 사용하여 플레이어 데이터를 읽습니다.
- 읽기 전용: 서버에서 만들거나 업데이트하는 플레이어 데이터입니다. 타이틀 클라이언트는 이 데이터를 읽을 수 있지만 업데이트할 수는 없습니다. 서버 API UpdateUserReadOnlyData를 사용하여 플레이어의 타이틀 관련 데이터를 생성, 업데이트 또는 삭제하고 클라이언트 API GetUserReadOnlyData를 사용하여 읽습니다. 이 데이터는 플레이어가 볼 수 있지만 서버에서만 수정할 수 있습니다.
- 내부: 서버에서만 사용할 수 있는 플레이어 데이터입니다. 서버 API UpdateUserInternalData를 사용하여 플레이어의 타이틀 관련 데이터를 생성, 업데이트 또는 삭제하고 클라이언트 API GetUserInternalData를 사용하여 읽습니다. 이 데이터는 서버 전용이며 클라이언트에서 볼 수 없습니다.
플레이어 데이터를 사용하는 경우 사용자 데이터 및 사용자 읽기 전용 데이터만 클라이언트 API에서 사용할 수 있습니다. 다른 플레이어가 읽을 수 있어야 하는 플레이어 데이터가 있는 경우 데이터를 쓸 때 Permission
값을 Public
으로 설정해야 합니다.
플레이어 데이터 및 플레이어 게시자 데이터 비교
플레이어 데이터는 게임 타이틀과 관련된 플레이어 정보입니다. 던전에서 플레이어의 위치 또는 기타 게임 관련 데이터를 저장하는 등 타이틀 관련 정보에 사용됩니다.
플레이어 게시자 데이터는 플레이어 계정 ‘및’ 타이틀과 반대로 플레이어 계정과 관련이 있는 데이터입니다. 스튜디오의 모든 타이틀과 관련된 플레이어에 대한 정보를 저장하는 데 사용됩니다(타이틀 간 보상 목적으로 타이틀 관련 정보가 포함될 수도 있음).
PlayFab의 스튜디오에 있는 모든 타이틀은 기본적으로 게시자 ID를 공유하며 해당 ID는 이러한 관계를 정의합니다. 플레이어 계정은 게시자 계층에 존재하며 동일한 게시자 ID로 모든 타이틀 간에 공유됩니다(그런 다음 추가적으로 타이틀당 고유한 플레이어 데이터를 가짐).
한 스튜디오에서 다른 게시자 ID를 가진 타이틀이 있거나 동일한 게시자 ID를 공유하는 다른 스튜디오에 타이틀이 있어야 하는 경우 PlayFab community 포럼에서 티켓을 열 수 있으며 Developer Success 팀에서 지원을 받을 수 있습니다.
참고 항목
‘플레이어’ 게시자 데이터를 모든 타이틀에서 공유되는 키/값 쌍인 게시자 데이터와 혼동하지 마세요(플레이어별 정보가 ‘아님’).
플레이어 게시자 데이터 사용은 플레이어 데이터 사용과 거의 동일합니다. ‘둘 다’ 문자열을 JSON blob(또는 다른 임의의 문자열 값)에 매핑하는 사전입니다.
자세한 내용은 플레이어 게시자 데이터를 사용하여 여러 타이틀 플레이에 대해 보상을 제공하는 방법을 참조하세요.