---
url: /docs/webview/launch-flow.md
description: 게임웹뷰 진입부터 게임 실행까지의 동선 안내
---

# 게임 실행 흐름

게임웹뷰에서 파트너사의 게임이 실행되기 전, 카카오가 확인하는 진입 조건과 화면 분기 흐름을 설명합니다.

정상 진입 시에는 카카오가 공통으로 제공하는 게임 스플래시 화면을 거쳐 게임으로 이동하며, 조건에 따라 약관 동의나 안내 화면으로 이동할 수 있습니다. 카카오가 제공하는 영역이나 인증·공유·데이터 연동 설계 시 반드시 참고해 주세요.

## 실행 주체

파트너사는 게임 URL이 로드된 이후를 담당합니다. 그 이전은 카카오가 제공합니다.

| 구간 | 담당 |
| --- | --- |
| 웹뷰 실행 및 진입 조건 판단 | 카카오 |
| 스플래시·조건별 분기/안내 화면 | 카카오 |
| 게임 초기화·화면 실행 (URL 호출 이후) | 파트너사 |

## 전체 흐름

## 조건별 화면 분기

카카오는 게임 URL을 호출하기 전에 사용자 상태와 게임 운영 상태, 등록된 실행 도메인을 확인합니다.
조건을 충족하지 않으면 아래와 같이 안내 화면을 노출하거나 게임 실행을 차단합니다.

| 조건 | 분기 화면 | 화면 예시 |
| --- | --- | --- |
| 서비스 약관 미동의 | 약관 동의 화면 |  |
| 만 14세 미만 사용자 | 법정대리인 동의 안내 |  |
| 미성년자 보호조치 대상 | 청소년 보호 안내 화면 |  |
| 카카오톡 버전이 최소 지원 미만 | 구버전 안내 화면 |  |
| 게임 서비스 종료 상태 | 종료된 게임 안내 화면 |  |
| 등록되지 않은 게임 실행 도메인 | 게임 실행 차단 | 화면 없음 |
| 카카오싱크 미동의 (파트너사 앱) | 싱크 동의창 |  |
| 모든 조건 충족 | 스플래시 → 게임 실행 |  |

게임 실행 도메인 등록 기준은 [게임웹뷰 SDK: 실행 조건](/api-sdk/sdk/kakaotalk-gameplay#실행-조건)을 참고하세요.

## 게임 URL 접근 분기

사용자가 게임웹뷰가 아닌 PC 또는 모바일 브라우저에서 게임 URL에 직접 접근하면 파트너사는 카카오가 안내한 주소로 리다이렉트해야 합니다.
리다이렉트 이후의 환경별 안내 화면과 카카오톡 실행 분기는 카카오가 제공합니다.

### PC 접근 

PC 웹에서 게임 URL에 직접 접근하면 게임 진입을 제한하고 `gameplay.kakao.com`으로 리다이렉트합니다.
리다이렉트가 완료되면 카카오가 PC용 안내 화면을 노출합니다.

| 항목 | 기준 |
| --- | --- |
| 적용 여부 | 필수 |
| 확인 상황 | PC 웹에서 게임 URL에 직접 접근 |
| 리다이렉트 URL | `gameplay.kakao.com` |
| 분기 화면 제공 | 카카오 |

### 모바일 접근 

모바일 브라우저에서 게임 URL에 직접 접근하면 카카오가 안내한 주소로 리다이렉트합니다.
카카오는 카카오톡 설치 여부와 지원 버전을 확인해 게임 실행 또는 안내 화면으로 분기합니다.

| 사용자 환경 | 카카오 분기 |
| --- | --- |
| 카카오톡 설치 및 지원 버전 충족 | 카카오톡 게임웹뷰로 연결 |
| 카카오톡 미설치 | 카카오톡 설치 안내 화면 |
| 카카오톡 지원 버전 미만 | 카카오톡 업데이트 안내 화면 |

## 파트너사 연동 핵심 포인트

* 게임 URL이 로드되는 시점에는 이미 카카오톡 계정 세션이 준비되어 있습니다. 설정은 [카카오싱크 설정](/docs/authentication/kakao-login-sync), 구현 스펙은 [카카오싱크 API](/api-sdk/kakaosync/rest-api)를 참고하세요.
* 카카오톡 게임웹뷰에서만 실행되어야 합니다. UserAgent 검증 등 개발 기준은 [게임웹뷰 SDK](/api-sdk/sdk/kakaotalk-gameplay)를 참고하세요.
* 게임 종료 후 웹뷰가 닫히는 조건은 파트너사 게임 로직에서 처리합니다.

## 참고 문서

* [게임웹뷰](/docs/webview/overview): 게임웹뷰의 역할과 전체 개발 순서
* [카카오싱크 설정](/docs/authentication/kakao-login-sync)
* [카카오싱크 API](/api-sdk/kakaosync/rest-api)
* [게임웹뷰 SDK](/api-sdk/sdk/kakaotalk-gameplay)
* [상태바 오버레이 설정 방법](/docs/webview/status-bar-overlay)