---
url: /docs/webview/navigation-guide.md
description: 모든 게임에 적용하는 내비게이션바·더보기 메뉴·고객센터와 외부 링크 기준
---

# 내비게이션바 설정

게임웹뷰의 내비게이션바와 더보기 메뉴에 적용할 공통 기준을 안내합니다.
**게임플레이 JS SDK와 개별 SDK 직접 연동 게임 모두 이 기준을 적용합니다.**

| 연동 방식 | 구현할 내용 |
| --- | --- |
| 게임플레이 JS SDK | [SDK UI](/api-sdk/sdk/gameplay-js/ui#navigation)를 사용하고 게임 화면과의 배치, 메뉴별 실제 동작을 확인합니다. |
| 개별 SDK 직접 연동 | 이 페이지의 공통 기능을 구현하고, [웹뷰 컴포넌트 가이드](/docs/design/webview-component-guide)의 크기·색상·배치 규격을 적용합니다. |

## 내비게이션바 

게임 화면 상단에 내비게이션바를 제공하고, 게임의 버튼·재화·주요 정보와 겹치지 않게 배치합니다.
가로 모드와 태블릿에서도 종료·더보기 버튼이 보이고 선택할 수 있어야 합니다.

| 기능 | 동작 기준 | 적용 여부 |
| --- | --- | --- |
| 닫기 | 게임 이름이 포함된 종료 확인 팝업을 표시하고, 확인을 선택하면 게임웹뷰를 닫습니다. | 필수 |
| 더보기 | 공유하기·문의하기를 순서대로 제공합니다. | 필수 |
| 게임 접기 기능 | 지원하는 iOS 환경에서 게임을 접고 플로팅 버튼으로 돌아올 수 있어야 합니다. | iOS 필수 |

게임플레이 JS SDK를 새로 연동하는 게임은 기본 내비게이션을 유지합니다.
SDK 옵션은 [Navigation](/api-sdk/sdk/gameplay-js/ui#navigation), 직접 구현 시 웹뷰 종료·접기 기능은 [게임웹뷰 SDK](/api-sdk/sdk/kakaotalk-gameplay)를 참고하세요.

## 더보기 메뉴 

기본 메뉴 2개와 선택 메뉴 최대 1개로 구성합니다.
전체 메뉴는 최대 3개이며, 선택 메뉴 이름은 10자 이내로 작성합니다.

| 순서·메뉴 | 동작 | 적용 여부 |
| --- | --- | --- |
| 1. 공유하기 | 카카오톡 친구 선택 화면을 열어 게임을 공유합니다. | 필수 |
| 2. 문의하기 | 파트너사의 고객센터 또는 준비한 문의 경로로 연결합니다. | 필수 |
| 3. 선택 메뉴 | 게임 안내 등 필요한 기능을 추가합니다. | 옵션 |

::: warning SDK 기본 메뉴의 동작도 확인하세요
현재 SDK 공개 설정에는 기본 공유·문의 메뉴의 동작을 지정하는 옵션이 없습니다.
메뉴가 표시되어도 실제 공유·문의가 실행되지 않는 경우, 사용 중인 SDK 버전과 재현 절차를 정리해 [기술 문의 채널](/docs/checklist/start-guide#문의-채널)로 문의하세요.
:::

### 공유하기 

기본 게임 공유(`GAME_SHARE`)를 제공하고, [공유 설정](/docs/share/settings)에 따라 단축 URL·템플릿·사용자 인자를 설정합니다.
게임플레이 JS SDK를 사용하는 게임도 환경별 공유 설정과 실제 메시지 발송·랜딩을 확인해야 합니다.

메뉴가 표시되는 것과 공유가 완료되는 것은 별개의 확인 항목입니다.
더보기에서 공유하기를 선택해 친구 선택 화면, 메시지 발송, 공유 링크의 게임 진입까지 확인합니다.

### 문의하기 

사용자가 문의를 보낼 경로를 제공합니다.
고객센터 URL 적용을 권장하며, 별도 페이지가 없다면 사용할 문의 방식을 정리합니다.

| 항목 | 설정 기준 |
| --- | --- |
| 고객센터 URL | 게임 실행 도메인과 다른 도메인을 사용합니다. |
| 실행 방식 | 고객센터를 카카오톡 인앱브라우저로 엽니다. |
| 복귀 | 고객센터를 닫은 뒤 진행 중인 게임으로 돌아올 수 있어야 합니다. |

**고객센터 도메인은 게임 실행 도메인과 반드시 분리합니다.**
게임이 `game.partner.com`이라면 고객센터는 `support.partner.com`처럼 다른 도메인을 사용합니다.
`game.partner.com/support`처럼 경로만 나누면 게임웹뷰로 열려 정상 동작하지 않을 수 있습니다.
게임웹뷰는 도메인당 하나만 유지되므로, 세부 실행 방식은 [인앱브라우저 스킴](/api-sdk/sdk/kakaotalk-gameplay#인앱브라우저-스킴)을 참고하세요.

## 게임 내 외부 링크 실행

고객센터·이벤트·정책 등 게임 밖의 페이지는 게임웹뷰 위에 카카오톡 인앱브라우저로 엽니다.
사용자가 외부 페이지를 닫은 뒤 원래 게임으로 돌아올 수 있도록 구성합니다.

| 링크 유형 | 실행 방식 |
| --- | --- |
| 게임 실행 URL | 게임웹뷰 |
| 고객센터·이벤트·정책 URL | 카카오톡 인앱브라우저 |

## 참고 문서

* [심사 체크리스트: 내비게이션 바 및 메뉴](/docs/checklist/review-checklist#내비게이션-바-및-메뉴): 심사 전 자체 점검 항목
* [게임플레이 JS SDK UI](/api-sdk/sdk/gameplay-js/ui#navigation): SDK 내비게이션 옵션
* [웹뷰 컴포넌트 가이드](/docs/design/webview-component-guide#드롭다운-메뉴): 직접 구현 시 디자인 규격
* [공유 설정](/docs/share/settings): 공유 메시지와 피커 설정
* [입점 안내: 개발 연동](/docs/checklist/start-guide#_3단계-개발-연동): 필수 작업과 구현 순서