테마 전환
게임웹뷰
게임웹뷰는 카카오톡 안에서 게임플레이 게임을 실행하는 전용 웹뷰 환경입니다.
파트너사는 카카오가 게임 URL을 불러온 이후의 게임 화면과 동작을 구현하고, 게임웹뷰 SDK를 연동해 카카오톡 네이티브 기능을 사용할 수 있습니다.
이 페이지에서 전체 개발 순서를 확인한 뒤 필요한 세부 가이드로 이동하세요.
카카오와 파트너사의 역할
| 구분 | 담당 영역 |
|---|---|
| 카카오 | 게임 진입 조건 확인, 카카오싱크 동의 분기, 공통 스플래시와 게임웹뷰 제공 |
| 파트너사 | 게임 화면과 로딩·오류 처리, 게임웹뷰 SDK 연동, 디바이스별 UI 대응과 테스트 |
파트너사의 게임 URL이 로드되기 전 흐름은 카카오가 제공합니다.
진입 조건과 화면 분기는 게임 실행 흐름에서 확인하세요.
개발 전 준비
게임 URL과 도메인 등록 필수
파트너사는 게임플레이 파트너센터오픈 예정의 게임 정보에 게임 URL을 입력합니다.
이 작업과 별도로 샌드박스·운영·테스트 환경에서 사용할 게임웹뷰 실행 허용 도메인(화이트리스트)을 카카오 담당자에게 전달해 등록을 요청합니다.
화이트리스트에 등록된 도메인만 카카오톡 안에서 게임웹뷰로 실행할 수 있습니다.
출시된 게임의 운영 URL은 테스트에 사용할 수 없으므로 별도의 테스트 URL도 함께 준비합니다.
카카오 담당자가 지정한 뒤에는 파트너사별 오픈채팅방에서 도메인 등록 상태와 테스트 일정을 확인하세요.
도메인 등록 후 카카오톡에서 확인하는 방법과 등록 없이 테스트앱을 사용하는 방법은 게임웹뷰 테스트 방법을 참고하세요.
파트너사가 준비할 항목
- 샌드박스·운영 환경의 게임 URL과 도메인 목록
- 출시 후에도 사용할 별도의 테스트 URL
- iOS·Android, 폰·태블릿에서 확인할 테스트 시나리오
- 게임 화면 방향, Safe Area, 상태바 등 게임웹뷰 UI 기준
개발 순서
- 게임 진입 흐름을 확인합니다.
카카오싱크 동의부터 게임 URL 로드까지의 조건과 분기를 확인합니다. - 게임 화면을 제작합니다.
화면 크기·내비게이션·로딩·팝업 등 게임웹뷰 환경에 맞는 디자인 기준을 적용합니다. - 게임웹뷰 SDK를 연동합니다.
웹뷰 닫기, 화면 방향, Safe Area, 상태바 등 게임에 필요한 네이티브 기능을 연결합니다. - 디바이스별 동작을 확인합니다.
iOS·Android와 폰·태블릿 환경을 구분하고 필요한 UI와 기능을 적용합니다. - 카카오톡과 테스트앱에서 검증합니다.
실제 진입 조건과 SDK 동작을 확인한 뒤 심사를 준비합니다.
주제별 가이드
| 확인할 내용 | 가이드 |
|---|---|
| 게임 진입 조건과 화면 분기 | 게임 실행 흐름 |
| 게임 URL 등록과 테스트 | 게임웹뷰 테스트 방법 |
| 화면·콘텐츠 제작 기준 | 게임 공통 제작 가이드 |
| 내비게이션·로딩·팝업 UI | 웹뷰 컴포넌트 가이드 |
| 게임웹뷰 기능과 메서드 | 게임웹뷰 SDK |
| iOS·Android·태블릿 구분 | 디바이스 구분 방법 |
| 상태바와 Safe Area 처리 | 상태바 오버레이 설정 방법 |
| 카카오톡·테스트앱 검증 | 게임웹뷰 테스트 방법 |