개발 문서

아이디어를 첫 플레이로

Immercy는 스마트폰을 컨트롤러로 사용하는 웹게임을 만드는 개발자 플랫폼입니다. 프로젝트를 준비하면 컨트롤러 디자인, SDK 연결, CLI 배포, 통합 프리뷰, 공개가 하나의 흐름으로 이어집니다.

1. 프로젝트 만들기

대시보드에서 Google 계정으로 로그인하고 새 프로젝트를 만듭니다. 게임명, 설명, 개발자명, 공개 범위를 입력하고 표지를 선택하세요. 발급된 API Key는 한 번만 표시되므로 로컬 환경변수 또는 Git에서 제외한 파일에 저장합니다. 표지는 프로젝트 설정에서도 업로드할 수 있습니다.

비공개: 로그인한 개발자 본인만 테스트합니다.
링크 공개: 링크를 아는 사람이 플레이합니다.
전체 공개: 공개용 설명과 표지 검토를 거쳐 누구나 접근할 수 있습니다.

2. 컨트롤러 구성하기

프로젝트의 컨트롤러 메뉴에서 입력 컴포넌트를 JSON으로 조합하거나 SDK의 함수로 설정 파일을 생성합니다. Button, Joystick, D-Pad, TouchPad, Gyro, Accelerometer, Swipe, Multi-touch를 지원합니다. 별도 드래그앤드롭 에디터는 제공하지 않습니다.

컨트롤러 프리뷰는 게임 없이 입력 이벤트를 확인합니다. 게임 빌드를 실행하지 않으므로 Plays가 차감되지 않습니다. 센서는 실제 스마트폰의 HTTPS 브라우저에서 권한을 허용해야 사용할 수 있습니다.

3. 웹게임과 연결하기

SDK 문서를 따라 게임에서 입력 이벤트를 받습니다. 정적 HTML·CSS·JavaScript 빌드를 사용합니다. Unity, 서버 실행 파일, 게임 자체의 백엔드 호스팅은 지원하지 않습니다.

저장소의 examples/starter에는 실제 게임 소스, 컨트롤러 설정, 정적 빌드 스크립트가 있습니다. npm 패키지는 별도 게시 전까지 저장소의 로컬 경로를 사용하세요.

4. 빌드 올리기

CLI에서 프로젝트를 생성하지 않습니다. 대시보드에서 만든 Project ID와 API Key로 인증한 뒤 빌드 폴더를 업로드합니다.

immercy help deploy
immercy validate
immercy deploy

배포 문서에서 로컬 설치와 설정 파일을 확인하세요. 서버는 파일별 크기와 해시를 검증한 뒤 최신 빌드를 교체합니다. 이전 버전은 Git에서 관리하고, 돌아가려면 필요한 버전을 다시 빌드해 배포합니다.

5. 연결하고 공개하기

프로젝트의 통합 프리뷰에서 QR을 띄우고 스마트폰으로 스캔합니다. 폰에서 컨트롤러 연결을 누르고 연결이 확인되면 PC에서 게임이 자동 시작됩니다. 연결된 스마트폰은 한 대이며 별도 앱을 설치하지 않습니다.