한 눈에 보기
이 페이지는 앱인토스 SDK에서 제공하는 주요 기능을 한 번에 살펴볼 수 있도록 정리한 가이드예요.
- SDK에 어떤 기능들이 있는지 빠르게 훑어보고
- 게임 미니앱 / 비게임 미니앱에서 각각 어떤 기능을 주로 사용하는지 참고하고
- WebView(WV)와 React Native(RN) 환경에서 사용할 수 있는 기능을 한눈에 확인할 수 있어요.
확인하세요
- 표의 '지원 환경'은 WV = WebView, RN = React Native를 의미해요.
- '추천 대상'은 일반적인 사용 사례를 기준으로 한 권장 분류이며, 서비스 특성에 따라 달라질 수 있어요.
| 카테고리 | 기능 | 지원 환경 | 추천 대상 | 설명 |
|---|---|---|---|---|
| 화면 구조 · 내비게이션 | 화면 이동(라우팅) | RN | 게임, 비게임 | 화면 전환, 히스토리 관리, 파라미터 전달 등 라우팅을 처리해요 |
| 화면 구조 · 내비게이션 | 레이아웃 | RN | 게임, 비게임 | 여러 페이지에서 반복되는 UI 요소(헤더, 내비게이션 바, 푸터 등)를 일관성 있게 관리하기 위한 구조를 설명해요 |
| 화면 구조 · 내비게이션 | 내비게이션 바 설정 | WV, RN | 게임, 비게임 | 앱인토스 내비게이션 바를 설정하는 방법이에요 |
| 스타일 | Flex | RN | 게임, 비게임 | 가로와 세로 방향 배치, 정렬, 중앙 정렬를 간편하게 구성해요 |
| 스타일 | Spacing | RN | 게임, 비게임 | 요소 사이의 간격을 쉽게 조절해요 |
| 스타일 | Stack | RN | 게임, 비게임 | 일정 간격으로 자식 요소를 배치하는 레이아웃 컴포넌트예요 |
| 스타일 | margin | RN | 게임, 비게임 | 컴포넌트의 외부 여백을 간결하게 지정하는 유틸이에요 |
| 스타일 | padding | RN | 게임, 비게임 | 컴포넌트의 안쪽 여백을 간결하게 지정하는 유틸이에요 |
| 스타일 | Overlay | RN | 게임, 비게임 | 모달, 바텀시트, 다이얼로그 등 별도의 UI 레이어를 표시할 때 사용해요 |
| UI 컴포넌트 | Image | RN | 게임, 비게임 | 비트맵(png, jpg 등)이나 벡터(svg) 이미지를 불러와 화면에 표시해요 |
| UI 컴포넌트 | Lottie | RN | 게임, 비게임 | Lottie JSON 파일을 불러와 애니메이션을 재생해요 |
| UI 컴포넌트 | BlurView | RN | 비게임 | iOS에서만 지원되는 블러(Blur) 효과를 제공해요 |
| UI 컴포넌트 | Video | RN | 게임, 비게임 | 비디오를 재생해요 |
| 이벤트 제어 | 뒤로가기 버튼 이벤트 감지하기 | WV, RN | 비게임 | 내비게이션 바의 뒤로가기 버튼 이벤트를 제어해요 |
| 이벤트 제어 | 앱 진입 완료 이벤트 감지하기 | WV, RN | 게임, 비게임 | 미니앱 진입하는 이벤트를 감지해요 이 시점을 기준으로 초기화, 데이터 로딩, 애니메이션 시작 등 작업을 수행해요 |
| 화면 제어 | Safe Area 여백 구하기 | WV, RN | 게임, 비게임 | 화면의 안전 영역(Safe Area) 여백 값을 확인해요 |
| 화면 제어 | 스크롤 뷰에서 요소 감지하기 | RN | 비게임 | 특정 요소가 화면에 일정 비율 이상 나타나면 onImpressionStart 콜백이 호출돼요 |
| 화면 제어 | 화면 방향 설정하기 | WV, RN | 게임 | 기기의 화면 방향을 설정하는 기능을 제공해요 |
| 화면 제어 > 노출/가시성 감지하기 | 요소 노출 감지하기 | RN | 비게임 | 화면에 요소가 보이기 시작하거나 화면에서 사라지는 것을 감지해요 |
| 화면 제어 > 노출/가시성 감지하기 | 컴포넌트 노출 감지하기 | RN | 비게임 | 특정 컴포넌트가 화면에 보이는지 여부를 감지해서 외부에 알려주는 컴포넌트예요 |
| 화면 제어 > 노출/가시성 감지하기 | 스크롤 영역 노출 감지하기 | RN | 비게임 | 스크롤 중 특정 요소가 화면에 보이거나 사라지는 상태를 감지할 수 있어요 |
| 화면 제어 > 노출/가시성 감지하기 | 리스트 항목 노출 감지하기 | RN | 비게임 | 리스트의 각 항목이 화면에 나타나는지 여부를 쉽게 확인하고 처리할 수 있어요 |
| 화면 제어 > 노출/가시성 감지하기 | 화면 보임 여부 확인하기 | RN | 게임, 비게임 | 화면이 현재 사용자에게 보이는지 여부를 알 수 있어요 |
| 화면 제어 > 노출/가시성 감지하기 | 가시성 변경 감지하기 | RN | 게임, 비게임 | 페이지나 컴포넌트가 사용자에게 보이는지 여부가 변경될 때 감지할 수 있어요 |
| 화면 제어 > 내비게이션 제어하기 | 화면 닫기 | WV, RN | 게임, 비게임 | 현재 화면을 닫는 함수에요 |
| 화면 제어 > 내비게이션 제어하기 | iOS 스와이프 설정하기 | WV | 비게임 | iOS에서 화면을 스와이프하여 뒤로가기 기능을 활성화하거나 비활성화할 수 있어요 |
| 화면 제어 > 내비게이션 제어하기 | 뒤로가기 이벤트 제어하기 | RN | 비게임 | 뒤로 가기 이벤트를 등록하고 제거할 수 있는 컨트롤러 객체를 반환하는 Hook이에요 |
| 화면 제어 | 화면 항상 켜짐 설정하기 | WV, RN | 게임 | 화면이 항상 켜져 있도록 설정하거나 해제하는 기능이에요 |
| 화면 제어 | 화면 캡처 차단하기 | WV, RN | 비게임 | 네이티브 수준에서 화면 캡처를 차단하거나 허용할 수 있어요 |
| 화면 제어 | 쿼리 파라미터 사용하기 | RN | 비게임 | 지정된 라우트에서 파라미터를 가져오는 훅이에요 |
| 화면 제어 | 화면 복귀 후 코드 실행하기 | RN | 게임, 비게임 | 화면 전환을 하고 돌아왔을 때 다음 코드를 동기적으로 실행할 수 있도록 도와주는 훅이에요 |
| 화면 제어 | 외부 URL 열기 | WV, RN | 비게임 | 지정한 URL을 기기의 기본 브라우저나 연결된 앱에서 열 수 있는 유틸리티예요 |
| WebView 속성 제어하기 | - | WV | 게임, 비게임 | 스크롤 동작, 미디어 재생 방식, 제스처 사용 여부 등 사용자 경험에 직접적인 영향을 주는 WV 속성을 상황에 맞게 조정할 수 있어요 |
| 인터랙션 | 스크롤 바운스 영역 배경 처리 | RN | 비게임 | iOS ScrollView에서 스크롤이 끝에 도달했을 때 발생하는 바운스 효과 영역(위/아래)에 배경색을 채워 보다 자연스러운 시각 효과를 제공하는 컴포넌트예요 |
| 인터랙션 | 색상 모드 타입 | RN | 비게임 | 현재 기기의 색상 모드(라이트/다크)를 나타내는 타입이에요 |
| 인터랙션 | 키보드 위로 요소 올리기 | RN | 비게임 | 키보드가 나타날 때 자식 컴포넌트를 자동으로 키보드 위로 올려주는 레이아웃 컴포넌트예요 |
| 인터랙션 | 오디오 포커스 변경 콜백 | RN | 게임 | 비디오나 오디오 컴포넌트의 오디오 포커스가 변경될 때 호출되는 콜백 타입이에요 |
| 인터랙션 | 햅틱 진동 실행하기 | WV, RN | 게임, 비게임 | 디바이스에서 햅틱 진동을 발생시키는 함수예요 |
| 인증 · 로그인 | 토스 로그인 - 인가 코드 받기 | WV, RN | 비게임 | 토스 앱의 인증 흐름을 사용해 로그인을 수행하고, 로그인이 성공하면 인가 코드를 반환해요 |
| 인증 · 로그인 | 토스 로그인 연동 확인 | WV, RN | 게임 | 현재 유저가 토스 로그인과 연동된 유저인지 여부를 확인해요 |
| 인증 · 로그인 | 게임 로그인 - 유저 식별자 받기 | WV, RN | 게임 | 게임 미니앱에서 유저 식별자를 확인해요 |
| 인증 · 로그인 | 토스 인증 - 인증 화면 호출 | WV, RN | 게임, 비게임 | 토스 인증 화면을 호출해요 |
| 콘텐츠 > 공통 | 공유 리워드 (게임/비게임) | WV, RN | 게임, 비게임 | 사용자가 친구에게 미니앱을 공유하고, 그 결과에 따라 리워드를 지급해요 |
| 콘텐츠 > 공통 > 공유하기 | 토스앱 공유 링크 만들기 | WV, RN | 게임, 비게임 | 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크로 변환해주는 유틸이에요 |
| 콘텐츠 > 공통 > 공유하기 | 메시지 공유하기 | WV, RN | 게임, 비게임 | 사용자가 콘텐츠를 쉽게 공유할 수 있도록, 네이티브 공유 시트를 표시해요 |
| 콘텐츠 > 게임 | 프로모션(토스 포인트) | WV, RN | 게임 | 게임 로그인을 통해 받은 유저 식별자 값을 사용해 프로모션(토스 포인트) 기능을 실행해요 |
| 콘텐츠 > 게임 | 게임 리더보드 | WV, RN | 게임 | 사용자의 게임 점수를 집계하고, 순위를 확인할 수 있어요 |
| 콘텐츠 > 결제 | 토스 페이 | WV, RN | 비게임 | 토스 페이 결제창을 띄우고, 사용자 인증을 수행해요 |
| 콘텐츠 > 결제 | 인앱 결제 | WV, RN | 게임, 비게임 | 인앱 결제 함수를 제공해요 |
| 콘텐츠 | 인앱 광고 2.0 | WV, RN | 게임, 비게임 | 인앱 광고 함수를 제공해요 |
| 분석 | 사용자 행동 기록하기 | WV, RN | 게임, 비게임 | 분석(로깅) 함수를 제공해요 |
| 권한 | 필요한 권한 설정하기 | WV, RN | 비게임 | 토스앱에서 쓸 수 있도록 권한을 설정하는 방법을 안내해요 |
| 디바이스 > 위치 정보 | 현재 위치 가져오기 | WV, RN | 비게임 | 디바이스의 현재 위치 정보를 가져와요 |
| 디바이스 > 위치 정보 | 실시간 위치 추적하기 | WV, RN | 비게임 | 디바이스의 위치 정보를 지속적으로 감지하고, 위치가 변경되면 콜백을 실행해요 |
| 디바이스 > 위치 정보 | 훅으로 위치 사용하기 | RN | 비게임 | 디바이스의 위치 정보를 반환하는 훅이에요 |
| 디바이스 | 네이티브 저장소 이용하기 | WV, RN | 게임, 비게임 | 네이티브의 저장소를 사용해요 |
| 디바이스 | 카메라로 사진 촬영하기 | WV, RN | 비게임 | 카메라를 실행해서 촬영된 이미지를 반환해요 |
| 디바이스 | 앨범 가져오기 | WV, RN | 비게임 | 사용자의 앨범에서 사진 목록을 불러와요 |
| 디바이스 | 클립보드 | WV, RN | 게임, 비게임 | 클립보드에 저장된 텍스트를 가져오고 복사해요 |
| 디바이스 | 파일 저장하기 | WV, RN | 비게임 | 문자열로 인코딩된 Base64 데이터를 지정한 파일 이름과 MIME 타입으로 사용자 기기에 저장해요 |
| 디바이스 | 연락처 가져오기 | WV, RN | 비게임 | 사용자의 연락처 목록을 페이지 단위로 가져와요 |
| 네트워크 · 환경 > 네트워크 | 네트워크 연결 상태 확인하기 | WV, RN | 게임, 비게임 | 디바이스의 현재 네트워크 연결 상태를 가져와요 |
| 네트워크 · 환경 > 네트워크 | http 통신하기 | WV, RN | 게임, 비게임 | 네트워크 통신을 하는 방법을 소개해요 |
| 네트워크 · 환경 > 환경 확인 | 기기 고유식별자 확인하기 | WV, RN | 게임, 비게임 | 사용 중인 기기의 고유 식별자를 문자열로 반환해요 |
| 네트워크 · 환경 > 환경 확인 | 애플리케이션 환경 확인하기 | WV, RN | 게임, 비게임 | 샌드박스 환경인지 토스앱 환경인지 반환해요 |
| 네트워크 · 환경 > 환경 확인 | 토스앱 버전 가져오기 | WV, RN | 게임, 비게임 | 토스 앱 버전을 가져와요 |
| 네트워크 · 환경 > 환경 확인 | 앱 최소 버전 확인하기 | WV, RN | 게임, 비게임 | 현재 토스 앱 버전이 지정한 최소 버전 이상인지 확인해요 |
| 네트워크 · 환경 > 환경 확인 | 실행중인 플랫폼 확인하기 | WV, RN | 게임, 비게임 | 현재 실행 중인 플랫폼을 확인해요 |
| 네트워크 · 환경 > 환경 확인 | 스킴 값 가져오기 | WV, RN | 비게임 | 처음에 화면에 진입한 스킴 값을 반환해요 |
| 언어(로케일) | 로케일 가져오기 | WV, RN | 게임, 비게임 | 현재 사용자의 로케일(local) 정보를 가져와요 |
게임에 추천하는 기능
게임 미니앱에서 자주 사용되며,
게임 플레이 흐름과 사용자 경험에 직접적인 영향을 주는 주요 기능들을 정리했어요.
게임 출시 가이드를 확인하세요
게임 미니앱 출시 전 반드시 확인해야 하는 체크리스트예요.
출시 가이드를 지키지 않으면 심사 과정에서 반려될 수 있으니, 반드시 확인하세요.
특히 아래 항목은 게임 미니앱에서 필수로 고려해야 하는 사항이에요.
- 풀스크린 구성 :
사용자의 몰입도를 높이기 위해 게임 화면은 풀스크린으로 구현해야 해요.Safe Area함수를 사용해 상·하단 레터박스가 생기지 않도록 구성하고,
내비게이션 바가 게임 화면의 버튼이나 UI 요소와 겹치지 않도록 주의해 주세요. - 사운드 처리 :
사운드는 필수는 아니지만, 게임 경험을 크게 향상시키는 요소예요.
백그라운드 전환 시 사운드가 중지되고,
다시 게임으로 돌아왔을 때 정상적으로 재생되도록 처리해 주세요.
| 카테고리 | 기능 | 지원 환경 | 권장도 | 설명 |
|---|---|---|---|---|
| 인증 · 로그인 | 게임 로그인 - 유저 식별자 받기 | WV, RN | 필수 | 게임 전용 유저 식별자(hash)를 사용해 랭킹, 프로모션 등 유저별 데이터를 안전하게 관리해요. |
| 콘텐츠 > 게임 | 게임 리더보드 | WV, RN | 필수 | 플레이 후 점수 제출 · 순위 확인으로 경쟁 요소를 제공해 몰입도를 높여요 |
| 콘텐츠 > 게임 | 프로모션(토스 포인트) | WV, RN | 권장 | 게임 식별자를 이용한 포인트/보상 지급. 이벤트, 로그인 보상 등에 유용해요 |
| 콘텐츠 > 공통 | 공유 리워드 (게임/비게임) | WV, RN | 권장 | 초대/공유 완료 시 리워드 지급으로 바이럴 유입을 촉진해요 |
| 콘텐츠 > 공통 > 공유하기 | 토스앱 공유 링크 만들기 | WV, RN | 권장 | 게임 결과나 초대 링크를 토스앱에서 바로 열 수 있는 공유 링크로 생성해요. |
| 콘텐츠 > 결제 | 인앱 결제 | WV, RN | 권장 | 아이템 판매 등 직접 수익화를 해보세요 |
| 콘텐츠 | 인앱 광고 2.0 | WV, RN | 권장 | 전면형/보상형 광고를 통해 광고 기반 수익화를 해보세요 |
| 디바이스 | 네이티브 저장소 이용하기 | WV, RN | 필수 | 네이티브의 저장소를 사용하여 유저의 정보를 저장하세요 유저의 기기 변경 시 데이터 유실이 없도록 설계하세요 |
| 화면 제어 | 화면 항상 켜짐 설정하기 | WV, RN | 권장 | 방치형·플레이 지속형 게임에서는 화면이 꺼지지 않는게 좋아요 |
| 화면 제어 | 화면 방향 설정하기 | WV, RN | 권장 | 가로/세로 고정 등 게임 플레이에 맞는 화면의 방향을 설정해요 |
| 이벤트 제어 | 앱 진입 완료 이벤트 감지하기 | WV, RN | 필수 | 미니앱 진입하는 이벤트를 감지해요 이 시점을 기준으로 초기화, 데이터 로딩, 애니메이션 시작 등 작업을 수행해요 |
| 화면 제어 | Safe Area 여백 구하기 | WV, RN | 필수 | 다양한 디바이스에서 UI가 가려지지 않도록 안전 영역을 고려하세요 |
| 인터랙션 | 오디오 포커스 변경 콜백 | RN | 권장 | 사운드/뮤트 상태 전환을 적절히 처리해 UX를 향상시켜요 |
| 인터랙션 | 햅틱 진동 실행하기 | WV, RN | 권장 | 디바이스에서 햅틱 진동을 발생시켜 게임의 몰입도를 높여요 |
| 분석 | 사용자 행동 기록하기 | WV, RN | 필수 | 플레이 데이터 분석, 이벤트 추적, A/B 테스트 등 게임 고도화의 필수 요소예요 |