앱인토스 개발자센터 로고
Skip to content

포팅 순서

아래 그림은 새로운 Unity 게임을 앱인토스 미니앱 플랫폼에 연동하는 주요 포팅 순서를 소개하며, 다음 내용은 각 단계의 작업을 설명해요.

  • 【1단계】 전환 점검: 게임이 미니앱 환경에서도 잘 동작할 수 있는지 살펴봐요.
  • 【2단계】 프로젝트 전환: Unity 프로젝트를 WebGL 기반 미니앱으로 변환해요.
  • 【3단계】 플랫폼 기능 연동: AppsInToss SDK를 통해 인증, 결제 등 플랫폼 기능을 연동해요.
  • 【4단계】 체험 개선: 미니앱에서의 UX·성능을 최적화해 출시 수준의 품질을 확보해요.
  • 【5단계】 배포 및 모니터링: 미니앱을 배포하고, 실행 현황과 사용자 지표를 점검해요.

1. 호환성 검토

새로운 게임을 미니앱으로 전환하기 전에, 해당 기술 방안이 프로젝트에 적합한지 먼저 확인하세요.
이미 전환된 사례를 참고해, 현재 프로젝트의 구조·리소스·엔진 버전이 AppsInToss 미니앱 환경에 맞는지 검토하는 단계입니다.


2. 프로젝트 포팅

이 단계에서는 Unity 프로젝트를 실제로 AppsInToss 미니앱 형태로 변환합니다.
전환 도구를 이용해 빠르게 WebGL 빌드를 만들고, 플러그인을 설치해 테스트 가능한 미니앱을 생성해보세요.


3. 앱인토스 SDK 연동

Unity 게임을 앱인토스 SDK와 연동하면, 플랫폼의 다양한 기능을 활용할 수 있습니다.
토스 로그인, 인앱 결제, 인앱 광고 등 필요한 기능을 선택적으로 연동하세요.


4. UX 최적화

이 단계까지 진행했다면, 이제 Unity 게임은 앱인토스 미니앱 플랫폼에서 정상적으로 실행될 거예요.
하지만 더 좋은 게임 경험을 위해선 프로젝트를 계속 다듬고 최적화해야 합니다.

이 섹션에서는 앱인토스 미니앱 플랫폼이 제공하는 튜닝 기능을 소개해요.
출시 전 마지막으로 성능을 점검하고, 완성도를 높이는 단계예요.

첫 씬 로딩 최적화

통계에 따르면 미니앱 사용자는 게임 시작 속도에 매우 민감해요. 시작이 길어지면 이탈률이 눈에 띄게 높아집니다.
그래서 Unity 네이티브 게임을 앱인토스 미니앱으로 연동할 때는, 첫 씬이 빠르게 표시되도록 최적화하는 게 가장 중요해요.

첫 씬 최적화는 단순한 설정만으로 해결되진 않아요. 대부분의 경우, 첫 프레임 로직과 초기 게임 코드를 직접 다듬어야 해요.

자세한 방법은 아래 메뉴얼을 참고하세요.

리소스 사전 다운로드

Unity Loader 로딩 중에는 CPU 작업이 집중되고, 네트워크는 상대적으로 여유로운 구간이 있어요.
이 시점을 활용해 필요한 리소스를 미리 다운로드하면, 게임 씬 로딩 속도를 더 빠르게 만들 수 있어요.

실행 성능 개선

Unity WebGL 게임의 실행 성능을 높여 더 좋은 사용자 경험을 만들어보세요.
성능 프로파일링 도구를 활용하면 병목 구간을 정확히 찾아내고, 체계적으로 최적화할 수 있어요.

리소스 압축 및 최적화

게임 리소스를 효과적으로 압축하고 최적화하여 다운로드 시간을 단축하고 메모리 사용량을 줄여요.

WASM 코드 분할

Unity에서 미니앱 프로젝트를 내보내면 코드가 wasm 파일로 변환돼 저장돼요.
게임을 시작할 때는 완전한 wasm 파일이 모두 로드돼야 실행할 수 있어요.
wasm 파일을 초기 로딩용과 지연 로딩용으로 나누어 더 작은 초기 패키지로 빠르게 메인 씬에 진입할 수 있습니다.

커버 이미지 설정

시작 커버 설정

로딩 중에는 커버 이미지나 영상으로 자연스러운 과도기를 연출할 수 있습니다.
자동 숨김 시점 등을 커스터마이즈할 수 있습니다.

5. 배포 및 모니터링

성능 모니터링

출시 후 실제 사용자 환경에서의 성능을 모니터링하고 지속적으로 최적화해요.

사용자 피드백 및 분석

사용자 로그와 피드백을 수집해 게임 체험을 지속적으로 개선합니다.

지속적인 업데이트

버전별 업데이트 전략을 세워 지속적인 서비스 품질을 유지하세요.

관련 메뉴얼

  • 버전 업데이트 가이드