--- url: /docs/webview/overview.md description: 카카오톡 게임웹뷰의 역할과 파트너사 개발 순서 안내 --- # 게임웹뷰 게임웹뷰는 카카오톡 안에서 게임플레이 게임을 실행하는 전용 웹뷰 환경입니다. 파트너사는 카카오가 게임 URL을 불러온 이후의 게임 화면과 동작을 구현하고, 게임웹뷰 SDK를 연동해 카카오톡 네이티브 기능을 사용할 수 있습니다. 이 페이지에서 전체 개발 순서를 확인한 뒤 필요한 세부 가이드로 이동하세요. ## 카카오와 파트너사의 역할 | 구분 | 담당 영역 | | --- | --- | | 카카오 | 게임 진입 조건 확인, 카카오싱크 동의 분기, 공통 스플래시와 게임웹뷰 제공 | | 파트너사 | 게임 화면과 로딩·오류 처리, 게임웹뷰 SDK 연동, 디바이스별 UI 대응과 테스트 | 파트너사의 게임 URL이 로드되기 전 흐름은 카카오가 제공합니다. 진입 조건과 화면 분기는 [게임 실행 흐름](/docs/webview/launch-flow)에서 확인하세요. ## 개발 전 준비 ### 게임 URL과 도메인 등록 파트너사는 게임플레이 파트너센터의 게임 정보에 게임 URL을 입력합니다. 이 작업과 별도로 샌드박스·운영·테스트 환경에서 사용할 게임웹뷰 실행 허용 도메인(화이트리스트)을 카카오 담당자에게 전달해 등록을 요청합니다. 화이트리스트에 등록된 도메인만 카카오톡 안에서 게임웹뷰로 실행할 수 있습니다. 출시된 게임의 운영 URL은 테스트에 사용할 수 없으므로 별도의 테스트 URL도 함께 준비합니다. 카카오 담당자가 지정한 뒤에는 파트너사별 오픈채팅방에서 도메인 등록 상태와 테스트 일정을 확인하세요. 도메인 등록 후 카카오톡에서 확인하는 방법과 등록 없이 테스트앱을 사용하는 방법은 [게임웹뷰 테스트 방법](/docs/webview/test-guide)을 참고하세요. ### 파트너사가 준비할 항목 * 샌드박스·운영 환경의 게임 URL과 도메인 목록 * 출시 후에도 사용할 별도의 테스트 URL * iOS·Android, 폰·태블릿에서 확인할 테스트 시나리오 * 게임 화면 방향, Safe Area, 상태바 등 게임웹뷰 UI 기준 ## 개발 순서 1. **게임 진입 흐름을 확인합니다.** 카카오싱크 동의부터 게임 URL 로드까지의 조건과 분기를 확인합니다. 2. **게임 화면을 제작합니다.** 화면 크기·내비게이션·로딩·팝업 등 게임웹뷰 환경에 맞는 디자인 기준을 적용합니다. 3. **게임웹뷰 SDK를 연동합니다.** 웹뷰 닫기, 화면 방향, Safe Area, 상태바 등 게임에 필요한 네이티브 기능을 연결합니다. 4. **디바이스별 동작을 확인합니다.** iOS·Android와 폰·태블릿 환경을 구분하고 필요한 UI와 기능을 적용합니다. 5. **카카오톡과 테스트앱에서 검증합니다.** 실제 진입 조건과 SDK 동작을 확인한 뒤 심사를 준비합니다. ## 주제별 가이드 | 확인할 내용 | 가이드 | | --- | --- | | 게임 진입 조건과 화면 분기 | [게임 실행 흐름](/docs/webview/launch-flow) | | 게임 URL 등록과 테스트 | [게임웹뷰 테스트 방법](/docs/webview/test-guide) | | 화면·콘텐츠 제작 기준 | [게임 공통 제작 가이드](/docs/design/common-guide) | | 내비게이션·로딩·팝업 UI | [웹뷰 컴포넌트 가이드](/docs/design/webview-component-guide) | | 게임웹뷰 기능과 메서드 | [게임웹뷰 SDK](/api-sdk/sdk/kakaotalk-gameplay) | | iOS·Android·태블릿 구분 | [디바이스 구분 방법](/docs/webview/device-detection) | | 상태바와 Safe Area 처리 | [상태바 오버레이 설정 방법](/docs/webview/status-bar-overlay) | | 카카오톡·테스트앱 검증 | [게임웹뷰 테스트 방법](/docs/webview/test-guide) | ## 참고 문서 * [입점 안내](/docs/checklist/start-guide): 제휴부터 출시까지의 전체 과정 * [카카오싱크 설정](/docs/authentication/kakao-login-sync): 디벨로퍼스 앱과 동의 항목 설정 * [심사 가이드](/docs/checklist/review-guide): 출시 심사 과정과 준비 사항