[iOS WebView 게임] 가로 전환 후 토스 흰색 내비게이션 바가 남아 전체화면이 되지 않습니다

개발
1

이 글의 성격은 무엇인가요?

질문 / 문제 해결

내용을 설명해주세요

[iOS WebView 게임] 가로 전환 후 토스 흰색 내비게이션 바가 남아 전체화면이 되지 않습니다.

가로형 WebView 게임에서 기기별 전체화면 동작이 달라 문의드립니다.

  • appName: office-worker-random-defense
  • 앱 유형: 게임 / WebView
  • 사용 SDK: @apps-in-toss/web-framework 3.4.1
  • 테스트 번들: 20260923-5
  • 테스트 환경: 실제 토스 앱에서 실행

재현 순서:

  1. 토스 앱에서 게임을 세로 화면으로 엽니다.
  2. ‘가로모드로 시작하기’를 눌러 가로 화면으로 전환합니다.
  3. 난이도 선택 화면과 인게임 화면의 상단을 확인합니다.

실제 결과:
Android 기기에서는 가로 전환 후 흰색 상단바가 보이지 않습니다. iPhone에서는 가로 전환 후에도 뒤로가기·앱 이름·더보기·닫기가 있는 흰색 토스 내비게이션 바가 화면 상단을 차지하여 게임 영역이 줄어듭니다. 세로 화면의 OS 상태바와는 별개의 현상입니다.

현재 앱 설정 파일은 navigationBar를 명시하지 않아 SDK 기본값을 사용합니다. 게임에서는 별도로 화면 방향 전환과 웹 전체화면을 요청하고 있습니다. 다만 이 설정 때문인지, iOS 토스 앱 호스트의 동작 또는 버전별 문제인지는 확인하지 못했습니다.

확인 부탁드립니다.

  1. SDK 3.4.1의 WebView 게임에서 iPhone 가로 화면에 흰색 내비게이션 바가 남는 것이 의도된 동작인가요?
  2. 게임에서도 navigationBar.transparentBackground 등의 설정으로 콘텐츠를 상단까지 확장하는 것이 지원·권장되나요? 이때 뒤로가기/더보기/닫기 버튼과 Safe Area는 어떻게 처리해야 하나요?

여러장 이미지 첨부가 어려워 iPhone 문제 화면 가로 인게임 캡처 1장만 첨부합니다.

끝.

appName (선택)

office-worker-random-defense

이미지 첨부

6. 아이폰 구동_인게임 플레이 화면(상단바 노출).jpg
6. 아이폰 구동_인게임 플레이 화면(상단바 노출).jpg1280×590 76.4 KB

2

안녕하세요 :slight_smile:
Android / iOS 동작방식이 다른건 한번 확인해보겠습니다.
게임에서는 기본적으로 몰입형 네비게이션바 (콘텐츠 상단 확장) 일텐데, apps-in-toss.config.ts 파일을 공유주실 수 있을까요 ?

Safe Area 관련 가이드 전달 드립니다.

3

요청하신 apps-in-toss.config.ts 전문 전달드립니다.
WebView 게임이며 SDK는 3.4.1입니다.
현재 navigationBar는 별도로 설정하지 않았습니다.
가로모드에서 일부 iPhone에는 흰색 토스 상단바가 계속 보이고, 비교한 Android 화면에서는 보이지 않습니다. 게임의 몰입형 상단 확장이 이 설정에서 자동 적용되는지, iOS에서 필요한 설정이나 콘솔 조건이 있는지 확인 부탁드립니다.
뒤로가기·닫기 동작을 유지하면서 적용할 수 있는 방법도 알려주시면 감사하겠습니다.

import { defineConfig } from '@apps-in-toss/web-framework/config';

export default defineConfig({
  appName: 'office-worker-random-defense',
  brand: {
    primaryColor: '#087f83',
  },
  permissions: [],
  webView: {
    bounces: false,
    pullToRefreshEnabled: false,
    overScrollMode: 'never',
    allowsBackForwardNavigationGestures: false,
    allowsInlineMediaPlayback: true,
    mediaPlaybackRequiresUserAction: false,
  },
  webBundleDir: 'dist',
});
4

확인해보니, 게임 미니앱 정보 검수가 승인되어야 몰입형 네비바(확장형) 이 적용되네요.
처음부터 몰입형 네비바가 보이는게 맞을 것 같아, 조치중입니다!