- 리소스: 플레이어
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ProfileSettings
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FriendsListVisibility
- PlayerExperienceInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- PlayerLevel
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- FriendStatus
- 메서드
리소스: 플레이어
플레이어 리소스입니다.
JSON 표현 |
---|
{ "kind": string, "playerId": string, "displayName": string, "avatarImageUrl": string, "bannerUrlPortrait": string, "bannerUrlLandscape": string, "originalPlayerId": string, "profileSettings": { object ( |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
playerId |
플레이어의 ID입니다. |
displayName |
플레이어에 표시할 이름입니다. |
avatarImageUrl |
플레이어를 나타내는 이미지의 기본 URL입니다. |
bannerUrlPortrait |
세로 모드 플레이어 배너 이미지의 URL입니다. |
bannerUrlLandscape |
가로 모드 플레이어 배너 이미지의 URL입니다. |
originalPlayerId |
플레이어가 해당 게임에 처음 로그인할 때 사용한 플레이어 ID입니다. 요청하는 플레이어의 player.get 호출, 이후에 플레이어 ID가 변경된 경우에만 채워지며 플레이어 ID 재매핑을 지원하는 클라이언트에만 채워집니다. |
profileSettings |
플레이어의 프로필 설정입니다. 플레이어의 프로필을 다른 플레이어에게 표시할지 여부를 제어합니다. |
name |
플레이어 이름의 개별 구성요소를 나타내는 객체 표현입니다. 일부 플레이어의 경우 이러한 필드가 없을 수도 있습니다. |
name.familyName |
이 플레이어의 성입니다. 일부 지역에서는 성이라고도 합니다. |
name.givenName |
이 플레이어의 이름입니다. 일부 지역에서는 이름을 부르기도 합니다. |
experienceInfo |
플레이어의 Play 게임즈 환경 정보를 나타내는 객체입니다. |
title |
게임 활동에 대한 보상을 받은 플레이어의 타이틀입니다. |
friendStatus |
요청자와 관련된 특정 플레이어의 친구 상태입니다. 플레이어가 친구 목록을 게임과 공유하지 않으면 설정되지 않습니다. |
gamePlayerId |
애플리케이션별 고유 플레이어 식별자입니다. |
ProfileSettings
프로필 설정
JSON 표현 |
---|
{
"kind": string,
"profileVisible": boolean,
"friendsListVisibility": enum ( |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
profileVisible |
현재 로그인된 플레이어에게 플레이어의 프로필이 표시되는지 여부입니다. |
friendsListVisibility |
|
FriendsListVisibility
플레이어의 친구 목록을 이 게임에 표시할지 또는 요청할 수 있는지 여부입니다. 이 필드는 현재 로그인한 플레이어에 대해서만 채워집니다.
열거형 | |
---|---|
VISIBLE |
친구 목록이 현재 게임에 표시됩니다. |
REQUEST_REQUIRED |
개발자는 친구 목록에 액세스할 수 없지만 Android API를 호출하여 동의 대화상자를 표시할 수 있습니다. |
UNAVAILABLE |
이 사용자는 현재 친구 목록을 사용할 수 없으며 사용자가 영구적으로 거절했거나 친구 기능을 사용할 수 없기 때문에 현재로서는 액세스를 요청할 수 없습니다. 이 상태에서 친구 목록에 대한 액세스를 요청하려고 시도하면 실패합니다. |
PlayerExperienceInfo
플레이어 환경에 관한 퍼스트 파티/서드 파티 메타데이터입니다.
JSON 표현 |
---|
{ "kind": string, "currentExperiencePoints": string, "lastLevelUpTimestampMillis": string, "currentLevel": { object ( |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
currentExperiencePoints |
플레이어의 현재 참여 점수입니다. |
lastLevelUpTimestampMillis |
플레이어의 레벨이 상승한 시점의 타임스탬프로, 유닉스 에포크 UTC 이후의 밀리초 단위입니다. |
currentLevel |
플레이어의 현재 레벨입니다. |
nextLevel |
플레이어의 다음 레벨입니다. 현재 등급이 최고 등급인 경우 현재 등급과 동일해야 합니다. |
PlayerLevel
사용자 수준에 관한 퍼스트 파티/서드 파티 메타데이터입니다.
JSON 표현 |
---|
{ "kind": string, "level": integer, "minExperiencePoints": string, "maxExperiencePoints": string } |
필드 | |
---|---|
kind |
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 |
level |
사용자의 수준입니다. |
minExperiencePoints |
이 레벨의 최소 참여 점수입니다. |
maxExperiencePoints |
이 레벨의 최대 참여 점수입니다. |
FriendStatus
플레이어 간의 우정 관계를 정의합니다.
열거형 | |
---|---|
NO_RELATIONSHIP |
플레이어 간에는 관계가 없습니다. |
FRIEND |
플레이어와 요청자는 친구입니다. |
메서드 |
|
---|---|
|
지정된 ID가 있는 플레이어 리소스를 검색합니다. |
|
호출하는 애플리케이션과 동일한 개발자가 요청한 모든 게임에서 현재 인증된 플레이어의 애플리케이션 플레이어 ID를 가져옵니다. |
|
현재 인증된 사용자의 범위가 지정된 플레이어 식별자를 검색합니다. |
|
현재 인증된 사용자의 플레이어 컬렉션을 가져옵니다. |