인증 및 플레이어 데이터

플레이어의 게임 상태 데이터(클리어한 레벨, 경험치, 인게임 구매 항목 등)는 얀덱스 서버에 저장하거나 자체 서버로 전송할 수 있습니다. 또한 플레이어의 얀덱스 프로필 정보(이름 등)를 활용해 게임을 개인화할 수 있습니다.

플레이어 정보

플레이어 데이터를 사용하려면 Using player info 조건을 사용하세요. 이 특별한 조건은 플레이어의 동의를 요청하고 얀덱스 게임에서 플레이어 데이터를 가져옵니다.

이 조건을 통해 사용자의 인증 상태 확인, 이름 조회 등 작업이 가능합니다. 주의할 점은 이 정보를 사용하는 모든 로직을 반드시 Using player info 내부에 넣어야 한다는 것입니다.

경고

이 조건을 연속으로 여러 번 호출하지 않도록 주의하세요. 레이아웃 시작 시그널이나 함수 내에 배치하는 것이 좋습니다.

Using player info 내부에서 사용 가능한 항목은 다음과 같습니다:

  • Player is authorized: 플레이어가 얀덱스에 로그인되었는지 확인합니다.
  • Player personal info access granted: 플레이어의 개인 정보 수집이 승인되었는지 확인합니다.
  • Player signature: string, 얀덱스 프로필 데이터와 서명을 Base64로 인코딩된 두 줄로 구성됩니다.
  • Player avatar: string, 플레이어 아바타 URL.
  • Player name: string, 플레이어 이름.
  • Player unique id: string, 플레이어 고유 식별자.

인게임 데이터

플레이어 데이터를 관리하려면 다음 액션을 사용하세요:

  • Get player data: JSON 객체로 플레이어의 게임 데이터를 가져옵니다.
  • Set player data: JSON 데이터를 얀덱스 게임으로 전송합니다.
  • Get player stats: 수치형 게임 통계를 JSON으로 가져옵니다.
  • Set player stats: 수치형 통계를 얀덱스 게임으로 전송합니다.
  • Increment player stats: 통계 값을 지정된 수치만큼 증가시킵니다.

경고

이 모든 액션은 비동기 형태이므로 실행 시간이 필요합니다. 오류 방지를 위해 Wait for previous actions를 사용하세요.


저장소