ZEP Guidebook (KR)
Search…
⌃K

Field

소개

Field는 App과 관련된 속성 값들 입니다. 이 필드를 활용해 참가 중인 스페이스나 맵, 플레이어 정보 등을 조회하거나, 저장공간을 활용할 수 있습니다.
🔒 아이콘이 있는 필드는 수정이 불가능한 읽기 전용 필드입니다.
이름
설명
🔒 spaceHashID
App이 설치된 스페이스의 해쉬값을 보여줍니다.
🔒 mapHashID
App이 설치된 맵의 해쉬값을 가져옵니다.
🔒 creatorID
App을 실행한 플레이어의 ID 값을 가져옵니다.
🔒 players
맵에 있는 모든 플레이어 리스트를 배열로 가져옵니다.
🔒 playerCount
앱이 설치된 맵에 있는 플레이어의 수를 가져옵니다.
cameraEffect
카메라 이펙트의 종류를 셋팅할 변수 값
cameraEffectParam
카메라 이펙트 효과의 범위 값
displayRatio
화면의 줌을 컨트롤 하는 값
storage
스페이스 내의 App 데이터의 저장공간(스페이스 한정)
followPlayer
App의 따라가기 기능 활성화 여부 값

📚 API 설명 및 예제

spaceHashID & mapHashID

App.spaceHashID: String App.mapHashID: String
앱이 설치된 스페이스의 spaceHashID와 mapHashID를 가져옵니다. (스페이스와 맵 이해하기)
예제
앱이 설치된 맵의 spaceHashID와 mapHashID 출력해보기
// 플레이어가 입장할 때 동작하는 함수
App.onJoinPlayer.Add(function(player){
// 채팅창에 spaceHashID와 mapHashID 출력해보기
App.sayToAll(`spaceHashID: ${App.spaceHashID}`); // spaceHashID: Ak42Xz
App.sayToAll(`mapHashID: ${App.mapHashID}`) // mapHashId: 25g3RQ
})

creatorID

App.creatorID
App을 실행한 플레이어의 ID 값을 가져옵니다.
예제
App을 실행한 플레이어의 닉네임을 채팅창에 출력해보기
// 플레이어가 입장할 때 동작하는 함수
App.onJoinPlayer.Add(function(player){
if(player.id == App.creatorID){
App.sayToAll(`${player.name}님이 앱을 실행했습니다.`)
}
})

players

App.players: ScriptPlayer[]
맵에 있는 모든 플레이어 리스트를 배열로 가져옵니다.
예제
맵에 있는 모든 플레이어 닉네임을 출력해보기
// q 키를 누르면 동작하는 함수
// App.addOnKeyDown 설명
App.addOnKeyDown(81,function(p){
//App.players를 이용해 채팅창에 접속해있는 모든 플레이어의 닉네임을 출력하기
let players = App.players;
for(let i in players){
let player = players[i]
App.sayToAll(player.name)
}
})

playerCount

App.playerCount: Number
앱이 설치된 맵에 있는 플레이어의 수를 가져옵니다.
예시
맵에 있는 플레이어 수 출력해보기
// q 키를 누르면 동작하는 함수
// App.addOnKeyDown 설명
App.addOnKeyDown(81,function(p){
// 현재 접속자 수를 채팅창에 출력
App.sayToAll(`접속자 수: ${App.playerCount}`)
})

cameraEffect & cameraEffectParam1

App.cameraEffect: NONE = 0, SPOTLIGHT = 1 App.cameraEffectParam1: Number
App.cameraEffect: 카메라 이펙트의 종류를 셋팅할 변수 값
App.cameraEffectParam1: 카메라 이펙트 효과의 범위 값
예제
비네팅 효과를 On/Off 하는 키 함수 만들어보기
모바일 환경에서는 비네팅 효과가 적용되지 않습니다.
// q 키를 누르면 동작하는 함수
// 한 번 누르면 비네팅 효과가 켜지고, 두 번 누르면 비네팅 효과가 꺼짐
// App.addOnKeyDown 설명
App.addOnKeyDown(81,function(p){
if(App.cameraEffect == 0){
App.cameraEffect = 1; // 1 = 비네팅 효과
App.cameraEffectParam1 = 500; // 비네팅 효과의 범위를 500으로 지정
}
else if(App.cameraEffect == 1){
App.cameraEffect = 0; // 비네팅 효과 끄기
}
App.sendUpdated(); // 앱의 Field값이 변경되면 App.sendUpdated()로 변경값을 적용
})
비네팅 효과 범위 500이 적용된 모습

displayRatio

App.displayRatio
화면의 줌을 컨트롤 하는 값 ( 기본 값: 1 )
예제
화면의 줌을 컨트롤 하는 키 만들어보기
// q 키를 누르면 동작하는 함수
// 한 번 누르면 화면의 줌 값이 커지고, 한 번 더 누르면 원래대로 돌아오는 키 함수
// App.addOnKeyDown 설명
App.addOnKeyDown(81,function(p){
if(App.displayRatio == 1){
*App.displayRatio = 5;*
}else{
*App.displayRatio = 1;
}
App.sendUpdated(); //* 앱의 Field값이 변경되면 App.sendUpdated()로 변경값을 적용
})
displayRatio 값이 5일 때
displayRatio 값이 1일 때

storage

App.storage: String
스페이스 내의 App 데이터의 저장공간 입니다 (스페이스 한정)
예제
App storage에 간단한 텍스트 저장해보기
💡 앱이 종료되어도 저장된 값이 사라지지 않습니다.
// q 키를 누르면 동작하는 함수
// App.addOnKeyDown
App.addOnKeyDown(81,function(p){
App.storage = "data";
App.save(); // storage의 값이 변경되면 App.save()로 변경값을 적용
})
// w 키를 누르면 동작하는 함수
App.addOnKeyDown(87,function(p){
App.sayToAll(App.storage); // App storage에 저장된 값을 채팅창에 출력
})

followPlayer

App.followPlayer: Boolean
App의 따라가기 기능 활성화 여부 값 입니다. ( 기본 값 : false )
노멀 앱, 미니게임 앱이 실행 중인 경우 followPlayer 값이 false로 설정되어 ‘따라가기’ 기능이 비활성화됩니다.
예제
따라가기 기능을 끄고 키는 함수 만들어보기
// q 키를 누르면 동작하는 함수
// followPlayer 값을 바꾸는 키 함수
// App.addOnKeyDown 설명
App.addOnKeyDown(81,function(p){
if(App.followPlayer){
App.followPlayer = false;
}else{
App.followPlayer = true;
*}*
App.sayToAll(`App.followPlayer: ${App.followPlayer}`)
*App.sendUpdated(); //* 앱의 Field값이 변경되면 App.sendUpdated()로 변경값을 적용
})

부록