Methods
화면에 UI를 표시, 유저 이동 또는 강퇴, 사운드 재생 등 편리한 기능을 제공하는 함수들 입니다.
이름 | 설명 |
---|---|
loadSpritesheet | 스프라이트 시트 그림 파일을 읽어 객체화하는 함수입니다. |
showCenterLabel | 모든 플레이어에게 지정된 위치에 text를 3초간 표시하는 함수입니다. |
showCustomLabel | 모든 플레이어에게 지정된 위치에 text를 3초간 표시하는 함수입니다.
text 부분에 span 태그를 넣어 텍스트를 꾸밀 수 있습니다. |
sayToAll | 채팅창에 text 를 출력하는 함수입니다. |
showWidget | 모든플레이어에게 지정된 align의 위치에 html파일을 위젯으로 불러오는 함수입니다. |
showYoutubeWidget | 링크에 해당하는 Youtube 컨텐츠를 위젯으로 불러옵니다. |
이름 | 설명 |
---|---|
spawnPlayer | 플레이어를 지정한 x, y 좌표로 이동 시키는 함수입니다. |
kickPlayer | 플레이어를 추방하는 함수입니다. |
forceDestroy | 미니게임 앱을 강제 종료하는 함수입니다. |
clearChat | 모든 채팅 내용을 삭제하는 함수입니다. |
이름 | 설명 |
---|---|
playSound | 사운드 파일을 재생하는 함수입니다. |
playSoundLink | 사운드 URL을 재생하는 함수입니다. |
stopSound | 재생 중인 모든 사운드를 멈추는 함수입니다. |
이름 | 설명 |
---|---|
httpGet | http get 요청을 보내는 함수입니다. |
httpPost | Form-Data 형태의 http post 요청을 보내는 함수 입니다. |
httpPostJson | JSON 형태의 http post 요청을 보내는 함수입니다. |
이름 | 설명 |
---|---|
sendUpdated | App, Player 관련 필드 값이 변경되면 변경 값을 적용하는 함수입니다. |
UI 함수 한 눈에 보기
// 스프라이트 시트 그림 파일을 읽어 객체화
App.loadSpritesheet(fileName: string, frameWidth: number, frameHeight: number, anims: array, frameRate: number): ScriptDynamicResource
// 모든 플레이어에게 지정된 위치에 해당 text를 1초간 표시
App.showCenterLabel(text: string, color: uint = 0xFFFFFF, bgColor: uint = 0x000000, offset: int = 0, time: int = 3000)
// 모든 플레이어에게 지정된 위치에 해당 text를 3초간 표시, 커스터마이징 가능
App.showCustomLabel(text: string, color: number = 0xFFFFFF, bgColor: number = 0x000000, offset: number = 0, width = 100, opacity = 0.6, time: int = 3000);
// 채팅창에 해당 text내용을 출력
App.sayToAll(text: string, color: uint = 0xFFFFFF)
// 모든 플레이어에게 지정된 align의 위치에 해 당 html파일을 위젯으로 불러오기
App.showWidget(fileName: string, align: string, width: number, height: number): ScriptWidget
// 모든 플레이어에게 지정된 align의 위치에 해당 YouTube link의 동영상을 재생시킴
App.showYoutubeWidget(link: string, align: string, width: number, height: number): ScriptWidget
App.loadSpritesheet(fileName: string, frameWidth: number, frameHeight: number, anims: array, frameRate: number): ScriptDynamicResource
스프라이트 시트 그림 파일을 읽어 객체화하는 함수입니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
fileName | String | 불러올 파일의 이름 |
frameWidth frameHeight | number | 한 프레임의 가로, 세로 픽셀 크기 |
anims | Array | 애니메이션으로 지정할 frame 이미지 번호 배열 |
frameRate | number | 프레임 하나 당 데이터를 표시하는 속도
frameRate: 8 → 1초에 8개의 이미지를 보여줌 |
예제
페인트맨 - 블루맨 스프라이트 이미지 적용해보기
예제_loadSpritesheet.zip
29KB
Binary
// 한 프레임의 사이즈 48x64
let blueman = App.loadSpritesheet('blueman.png', 48, 64, {
left: [5, 6, 7, 8, 9], // 좌방향 이동 이미지
up: [15, 16, 17, 18, 19],
down: [0, 1, 2, 3, 4],
right: [10, 11, 12, 13, 14],
dance: [20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37],
down_jump: [38],
left_jump: [39],
right_jump: [40],
up_jump: [41],
}, 8);
// 플레이어가 입장하면 캐릭터 이미지가 바뀜
App.onJoinPlayer.Add(function(player){
player.sprite = blueman;
player.sendUpdated();
});
App.showCenterLabel(text: string, color: uint = 0xFFFFFF, bgColor: uint = 0x000000, offset: number = 0, time: number = 3000)
모든 플레이어에게 지정된 위치에 text를 3초간 표시하는 함수입니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
text | String | 라벨에 출력할 텍스트 |
color | Uint | |
bgColor | Uint | 메시지가 출력되는 라벨의 배경색
값을 입력하지 않을 경우, 검은색(0x000000)으로 적용됩니다. |
offset | number | offset 값이 클수록 표시되는 위치가 화면 아래쪽 방향으로 가까워집니다.
값을 입력하지 않을 경우, 0으로 지정됩니다. |
time | number | 라벨 표시 시간 (ms), 기본 값 3000 ( 3초 ) |
예제
노란색 배경 입장 메시지 라벨을 2초간 출력해보기

App.onJoinPlayer.Add(function(player){
App.showCenterLabel(`${player.name}님이 입장하셨습니다.`, 0x000000, 0xFFFF00, 200, 2000); // 노란색 배경, 검정색 글씨로 표시하기
});
App.showCustomLabel(text: string, color: number = 0xFFFFFF, bgColor: number = 0x000000, offset: number = 0, width = 100, opacity = 0.6, time: number = 3000);
모든 플레이어에게 지정된 위치에 text를 3초간 표시하는 함수입니다.
text 부분에
span
태그를 넣어 텍스트를 꾸밀 수 있습니다.파라미터
이름 | 타입 | 설명 |
---|---|---|
text | String | 라벨에 출력할 텍스트 ( span 태그 허용 ) |
color | Uint |