Skip to main content
Title Data는 게임의 구성 데이터를 서버에 원격으로 저장하고 관리하는 데 사용되는 일반 텍스트 키-값 쌍의 집합입니다. 이는 클라이언트 측에서 검색할 수 있는 타이틀 전역 구성 변수를 접근 가능하고 체계적으로 유지합니다. 이 빠른 시작에서는 타이틀 데이터를 프로그래밍 방식으로 생성하고 사용하는 방법을 설명합니다. 이는 중요한 주제로, 게임의 구성 데이터를 서버에 원격으로 저장하는 것은 언제든지 변경할 수 있으며, PlayFab과 같은 서비스를 사용하는 가장 기본적인 이유 중 하나입니다.

Title Data 가져오기

게임 클라이언트에서

PlayFabClientAPIGetTitleData를 사용하여 특정 타이틀의 KVP를 가져옵니다. 다음 코드 예제는 모든 타이틀 데이터의 값을 표시합니다.

게임 서버에서

PlayFabServerAPIGetTitleData를 사용하여 특정 타이틀의 KVP를 가져옵니다. 다음 코드 예제는 모든 Title Data의 값을 표시합니다.

Title Data 설정

타이틀 데이터가 매우 자주 변경될 가능성은 낮습니다. 대부분의 경우, 타이틀 데이터는 타이틀의 수명 동안 대체로 변경되지 않는 정적 데이터에 사용해야 합니다. Game Manager를 사용하거나 서버 API 함수를 통해 타이틀 데이터를 설정할 수 있습니다.

Game Manager를 사용하여 Title Data 설정

Game Manager를 사용하여 타이틀에 Primary Title Data를 추가하려면 다음 단계를 수행합니다.
  1. Game Manager에서 타이틀을 엽니다.
  2. Content를 선택한 다음 Title Data를 선택합니다.
  3. New Title Data를 선택합니다.
  4. 새 타이틀 데이터 페이지에서 Key 값과 Value 값을 입력합니다. KeyValue는 모두 문자열로 저장됩니다.
  5. Save 버튼을 사용하여 새 데이터 항목을 저장합니다.

C#에서 서버 API를 호출하여 Title Data 설정

SetTitleData API는 전용 서버에서 호출해야 하는 서버 API입니다. SetTitleData 호출에서 한 번에 하나의 타이틀 데이터 KVP만 설정할 수 있습니다.

Game Manager를 사용하여 Title Data 재정의 설정

재정의(Override) 또한 JSON 키-값 쌍의 집합이며, 이상적으로는 Primary Title Data의 키-값 쌍에 필요한 델타 변경을 담기 위한 목적으로 사용되어야 합니다. 델타 변경은 Primary Title Data와 비교했을 때 새로운 키-값, 기존 키의 값 변경 또는 키 삭제(값의 입력으로 NULL 사용)로 구성된 키-값 쌍으로 이루어질 수 있습니다. 기본 타이틀 데이터에 재정의를 추가하려면 다음 단계를 수행합니다.
  1. Game Manager에서 타이틀을 엽니다.
  2. Content를 선택한 다음 Title Data를 선택합니다.
  3. New Override를 선택합니다.
  4. Override Label을 입력하고, Key 값과 Value 값을 입력합니다. Key와 Value는 모두 문자열로 저장됩니다.
  5. Save 버튼을 사용하여 새 Title Data Override를 저장합니다.
이 키/값 쌍의 재정의 세트는 현재로서는 Experiments를 사용하는 경우에만 적용됩니다.
플레이어가 타이틀 데이터 재정의를 포함하는 실험 변형(experiment variant)에 속해 있다면, 재정의가 서버 측에서 자동으로 적용되고 클라이언트 측에서 타이틀 데이터와 함께 반환됩니다.
Title Data Override 값은 새로 고침 및 지속되는 데 최대 1분이 걸릴 수 있습니다.

내부 Title Data

User Data와 마찬가지로, 타이틀 데이터에는 클라이언트로부터 숨겨진 내부 저장소가 있습니다. 이 데이터도 Game Manager 또는 서버 API를 통해 설정할 수 있습니다.

C#에서 서버 API를 호출하여 내부 Title Data 가져오기

C#에서 서버 API를 호출하여 내부 Title Data 설정

참고

마지막 수정일 2026년 8월 13일