navigationBar.transparentBackground 적용 시 상단 영역(상태바+네비바 높이) 터치가 웹뷰에 전달되지 않습니다

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

질문 / 문제 해결

내용을 설명해주세요

안녕하세요. 게임 미니앱 설화를 개발 중입니다.

게임 미니앱 iOS 상단 상태바 영역이 흰색으로 남고 풀스크린이 안 됩니다 해당 게시글의 안내에 따라 navigationBar: { transparentBackground: true }를 적용해 상단 흰색 영역 문제는 해결했는데, 이후 상단 스트립 전체에서 터치가 웹뷰에 전달되지 않는 문제가 발생해 문의드립니다.

개발 환경

  • SDK: @apps-in-toss/web-framework 2.10.1
  • 웹 스택: React 19.2 + PixiJS 8.14 + Vite 6.3 (granite dev / ait build)
  • granite.config.ts 주요 설정:
    webViewProps: { type: ‘game’ },
    navigationBar: { transparentBackground: true },
  • index.html viewport: viewport-fit=cover 적용

테스트 환경

  • iOS 실기기: 아이폰17 / OS 26.5.1v
  • ait deploy 샌드박스 배포로 확인

문제 현상

transparentBackground: true로 설정후 화면 상단 스트립에서 터치가 웹뷰에 전혀 도달하지 않습니다.
토스 정지/나가기버튼과 동일한 높이값 좌측에 메뉴들을 설정해두었는데 터치가 되지않는 상태입니다.
혹시 의도된 동작일까요?

진단 빌드에서 window 레벨 pointerdown 카운터가 해당 영역 탭 시 증가하지 않는 것을 확인했습니다. 웹 쪽 hit-test 문제가 아니라 터치 이벤트가 웹뷰에 도달 자체를 못 하는 상태입니다.

appName (선택)

설화

안녕하세요 :slight_smile:
확인해보겠습니다!

안녕하세요, 혹시 원인 파악되었는지 문의드립니다

이슈 확인하였고, 빠르게 조치하겠습니다 :man_bowing:

@apps-in-toss/web-framework2.10.5 버전으로 업데이트 후 테스트 부탁드려도 될까요 ?

혹시 이버전에 iOS에서 네비게이션바가 흰색 불투명바로 나오는거 해결됐나요. SDK업데이트한 모든 게임에서 안드로이드는 투명바가 나오고 iOS는 불투명바가 나와서 너무 당황스럽습니다.

iOS, SDK 2.10.5에서 투명 네비게이션 바의 터치가 먹지 않던 문제가 수정된 것을 확인했습니다. 감사합니다.

안녕하세요, 해당 버전으로 업데이트 후 문제없이 정상작동하는것확인하였습니다. 빠른 처리 감사드립니다