연동 순서
Unity 게임을 앱인토스 미니앱으로 연동하는 과정을 5단계로 안내해요.
| 단계 | 내용 |
|---|---|
| 1단계 호환성 검토 | 게임이 미니앱 환경에서 잘 동작할 수 있는지 확인해요 |
| 2단계 프로젝트 연동 | Unity 프로젝트를 WebGL 기반 미니앱으로 변환해요 |
| 3단계 SDK 연동 | 인증, 결제, 광고 등 플랫폼 기능을 연동해요 |
| 4단계 UX 최적화 | 성능을 최적화해 출시 수준의 품질을 확보해요 |
| 5단계 배포 및 모니터링 | 미니앱을 배포하고 사용자 지표를 점검해요 |
1. 호환성 검토
게임을 미니앱으로 전환하기 전에, 프로젝트의 구조·리소스·엔진 버전이 앱인토스 미니앱 환경에 맞는지 먼저 확인해요.
2. 프로젝트 연동
Unity 프로젝트를 앱인토스 미니앱 형태로 변환해요.
SDK를 설치하고 WebGL 빌드를 만들어 테스트 가능한 미니앱을 생성해 보세요.
3. 앱인토스 SDK 연동
Unity 게임을 앱인토스 SDK와 연동하면 플랫폼의 다양한 기능을 활용할 수 있어요.
토스 로그인, 인앱 결제, 인앱 광고 등 필요한 기능을 선택적으로 연동하세요.
4. UX 최적화
이 단계까지 진행했다면 Unity 게임은 앱인토스에서 정상적으로 실행될 거예요.
출시 전 마지막으로 성능을 점검하고 완성도를 높이는 단계예요.
첫 씬 로딩 최적화
미니앱 사용자는 게임 시작 속도에 매우 민감해요. 시작이 길어지면 이탈률이 눈에 띄게 높아져요.
첫 프레임 로직과 초기 게임 코드를 다듬어 첫 씬이 빠르게 표시되도록 최적화하는 게 가장 중요해요.
리소스 사전 다운로드
Unity Loader 로딩 중 네트워크가 상대적으로 여유로운 구간을 활용해 리소스를 미리 다운로드하면, 게임 씬 로딩 속도를 더 빠르게 만들 수 있어요.
관련 문서
실행 성능 개선
성능 프로파일링 도구를 활용하면 병목 구간을 정확히 찾아내고 체계적으로 최적화할 수 있어요.
리소스 압축 및 최적화
게임 리소스를 효과적으로 압축하고 최적화해서 다운로드 시간을 단축하고 메모리 사용량을 줄여요.
WASM 코드 분할
wasm 파일을 초기 로딩용과 지연 로딩용으로 나누면 더 작은 초기 패키지로 빠르게 메인 씬에 진입할 수 있어요.
관련 문서
로딩 화면 커스터마이징
로딩 중에는 커버 이미지나 영상으로 자연스러운 전환을 연출할 수 있어요.
관련 문서
- 커스텀 로딩 화면
- 로딩 화면 커스터마이징 — AITLoading API 활용
5. 배포 및 모니터링
출시 후 실제 사용자 환경에서의 성능을 모니터링하고 지속적으로 최적화해요.
관련 문서
- 성능 최적화 가이드
- SDK 이벤트 로깅 — 자동 수집 런타임 이벤트
- Sentry 통합 — 크래시 모니터링
- 문제 해결