게임 실행 흐름

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

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

실행 주체

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

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

전체 흐름

단계	처리 주체	처리 내용
1. 게임 선택	카카오	사용자가 카카오톡 게임플레이에서 게임을 선택하면 게임웹뷰를 엽니다.
2. 사용자 확인	카카오	다음 사용자 진입 조건을 확인합니다. 게임플레이 약관 동의 여부 만 14세 미만 여부 미성년자 보호조치 대상 여부 카카오톡 최소 지원 버전 충족 여부
3. 게임 확인	카카오	다음 게임 진입 조건을 확인합니다. 게임이 정상 운영 상태인지 확인 실행 도메인이 게임플레이에 등록되어 있는지 확인
4. 게임 URL 호출	카카오	모든 조건을 충족하면 공통 스플래시를 노출한 뒤 파트너사의 게임 URL을 호출합니다.
5. 인증·동의	파트너사	게임 URL 진입 즉시 인가 코드를 요청하고, 미동의 사용자에게 카카오싱크 동의 화면을 표시합니다.
6. 게임 실행	파트너사	사용자 인증과 약관 동의가 완료되면 게임을 실행합니다.

조건별 화면 분기

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

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

게임 실행 도메인 등록 기준은 게임웹뷰 SDK: 실행 조건을 참고하세요.

게임 URL 접근 분기

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

PC 접근 필수

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

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

모바일 접근 필수

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

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

파트너사 연동 핵심 포인트

• 게임 URL이 로드되는 시점에는 이미 카카오톡 계정 세션이 준비되어 있습니다.
  설정은 카카오싱크 설정, 구현 스펙은 카카오싱크 API를 참고하세요.
• 카카오톡 게임웹뷰에서만 실행되어야 합니다.
  UserAgent 검증 등 개발 기준은 게임웹뷰 SDK를 참고하세요.
• 게임 종료 후 웹뷰가 닫히는 조건은 파트너사 게임 로직에서 처리합니다.

참고 문서

• 게임웹뷰: 게임웹뷰의 역할과 전체 개발 순서
• 카카오싱크 설정
• 카카오싱크 API
• 게임웹뷰 SDK
• 상태바 오버레이 설정 방법