샘플 코드

앱인토스 Unity SDK에서 제공하는 기능을 한눈에 살펴볼 수 있어요. 각 항목을 클릭하면 상세 가이드와 샘플 코드를 확인할 수 있어요.

[Unity SDK GitHub 보기 ↗](https://github.com/toss/apps-in-toss-unity-sdk/)

시작 가이드

기능	설명
시작하기	SDK를 설치하고 빌드까지 진행할 수 있어요.
API 사용 패턴	비동기 처리, 에러 대응, 테스트 환경 설정 방법을 확인할 수 있어요.

API 레퍼런스

기능	설명
인증	사용자가 토스 계정으로 별도 가입 없이 간편하게 로그인할 수 있어요.
내비게이션	화면 상단의 제목·뒤로가기 영역을 설정할 수 있어요.
Safe Area	노치·둥근 모서리에 가려지지 않도록 화면 여백 값을 확인해요.
시스템 정보	기기 ID, 플랫폼, 앱 버전, 네트워크 상태 등을 확인할 수 있어요.
권한 설정	카메라, 위치 등 기기 권한을 요청하고 확인할 수 있어요.
위치 정보	현재 위치를 가져오거나 실시간으로 위치를 추적할 수 있어요.
미디어	카메라로 촬영하거나 앨범에서 사진을 가져올 수 있어요.
클립보드	복사한 텍스트를 가져오거나, 텍스트를 복사해 둘 수 있어요.
연락처	사용자의 연락처 목록을 가져와요.
스토리지	사용자 정보를 기기에 저장할 수 있어요.
게임 리더보드	플레이가 끝나면 점수를 등록하고 순위를 보여줘요. 경쟁 요소로 다시 하고 싶게 만들어요.
공유	게임 결과나 초대 링크를 공유해, 받은 사람이 토스 앱에서 바로 열 수 있어요.
기타 API	사용자 식별키, 프로모션 리워드, 앱 리뷰 요청 등을 안내해요.

빌드

기능	설명
빌드 프로필	개발·테스트·배포 단계별로 최적화된 빌드 설정을 구성할 수 있어요.
빌드 프로세스	초기화부터 WebGL 빌드, 패키징까지 전체 과정을 확인할 수 있어요.
빌드 커스터마이징	index.html, npm 패키지, Vite 플러그인 등으로 빌드를 커스터마이징할 수 있어요.

화면 & 이벤트

기능	설명
로딩 화면 커스터마이징	커스텀 HTML과 JavaScript로 로딩 화면을 원하는 대로 꾸밀 수 있어요.
화면 가시성 처리	앱이 백그라운드로 전환될 때 오디오와 게임 상태를 처리할 수 있어요.

분석 & 모니터링

기능	설명
SDK 이벤트 로깅	사용자가 게임에서 뭘 했는지 기록해요. 데이터 분석, A/B 테스트 등 게임 개선에 꼭 필요해요.
Sentry 통합	Sentry를 연동해 오류를 자동으로 추적하고 모니터링할 수 있어요.

수익화

기능	설명
인앱 광고	화면 전체를 덮는 광고나 보면 보상을 주는 광고를 넣을 수 있어요.
인앱 결제	아이템처럼 한 번씩 파는 상품으로 수익을 낼 수 있어요.

문제 해결

기능	설명
문제 해결	SDK 사용 중 자주 발생하는 문제와 해결 방법을 확인할 수 있어요.
디버깅 및 예외 처리	Unity WebGL 환경에서 디버깅하고 예외를 처리하는 방법을 확인할 수 있어요.