플레이어와 관련된 속성 값들 입니다.
플레이어의 닉네임(name), 위치(tileX / tileY) 등을 조회하거나 플레이어에게 스팟라이트(spotlight), 안보임(hidden) 기능을 활성화 할 수 있으며, 아바타의 이동속도(moveSpeed), 이미지(sprite)를 변경하거나 플레이어의 저장공간(storage)을 활용할 수도 있습니다.
🔒 아이콘이 있는 필드는 수정이 불가능한 읽기 전용 필드입니다.
| 이름 | 설명 |
|---|---|
| 🔒 id | 플레이어의 id 값 |
| name | 플레이어의 닉네임 값 |
| title | 아바타 닉네임 위에 노란색으로 노출되는 텍스트 |
| 🔒 role | 플레이어의 권한을 나타내는 숫자 값 |
| 🔒 tileX / tileY | 아바타가 서있는 X 좌표 값과 Y 좌표 값 |
| 🔒 dir | 아바타가 바라보고 있는 방향 값 |
| moveSpeed | 플레이어의 이동속도 값 |
| sprite | 아바타의 스프라이트 이미지 값 |
| tag | 필요한 속성 값을 부여 가능한 값 저장 공간 |
| hidden | 값이 true 이면, 다른 플레이어에게 보이지 않습니다. |
| spotlight | 플레이어의 스팟라이트 기능 활성화 여부 |
| disableVideo | 플레이어의 비디오 가능 여부 |
| disableAudio | 플레이어의 오디오 가능 여부 |
| attackType | 플레이어의 공격(Z키) 타입 |
| attackSprite | 플레이어의 공격(Z키) 이미지 값 |
| attackParam1 | 공격 이미지가 날아가는 거리 값 |
| attackParam2 | 공격 가능 거리 값 |
| attackType이 2(원거리 공격)으로 설정 된 경우에만 유효 | |
| 🔒 walletAddress | 플레이어의 전자지갑 주소 값 |
| storage | 스페이스 내의 Player 값 저장 공간(스페이스 한정) |
| 🔒 isMobile | 플레이어의 모바일 접속여부 |
| 🔒 isMoving | 플레이어가 움직이고 있으면 True, 아니면 False를 반환 |
| 🔒 isJumping | 플레이어가 점프하고 있으면 True, 아니면 False를 반환 |
| customData | URL 쿼리 스트링을 읽어 값을 저장 할 수 있습니다. |
<aside> ▶️ player.id : Number player.name : String
</aside>
플레이어의 id, 닉네임 값을 가져옵니다.
예제
플레이어가 입장 할 때 플레이어의 id, name 값 출력해보기
// 플레이어가 입장할 때 동작하는 함수
App.onJoinPlayer.Add(function(player){
App.sayToAll(`id: ${player.id} name: ${player.name}`);
})