마지막 업데이트 2026-10-19
PPI-1390. 아동이 게스트 화면의 수업 영상이나 자기 카메라 영상을 길게 누르거나 우클릭하면 브라우저 기본 메뉴(저장·공유·복사 등)가 뜨던 문제를 막는다. 런타임 변경은 <video> 4곳에 속성 2개를 붙인 것뿐이고(+16/−2), 나머지는 테스트와 Storybook이다. 리뷰할 때는 바깥 영역의 메뉴와 영상 위 탭·터치는 그대로 동작하는지, 그리고 iOS·Android 실기기에서 실제로 막히는지(아직 확인 안 함)를 먼저 본다.
메뉴가 뜨는 경로는 두 가지다. 데스크톱 우클릭과 Android 길게 누르기는 contextmenu 이벤트로 오고, iOS Safari 길게 누르기는 이벤트 없이 -webkit-touch-callout으로 제어되는 시스템 callout이다. 그래서 두 수단을 함께 적용했고, 선택 강조를 막으려고 user-select: none도 더했다.
MeetVideo의 수업 영상과 기본 대기 영상(ghostwhite), GuestCamera의 overlay·sidebar 카메라 영상friend-choice-screen.tsx가 이미 같은 onContextMenu={(event) => event.preventDefault()}를 쓴다(#1008)GuestCamera는 guest-layout.tsx(/client-guest/session)에서만 쓴다. MeetVideo는 guest-layout-content.tsx를 거쳐 렌더링되는데, 이 컴포넌트를 monitor-media-display.tsx(/monitor-dashboard/[group]/[roomId])와 guest-monitor-view.tsx도 쓰기 때문에 진행자 모니터의 수업 영상에서도 기본 메뉴가 막힌다| 구분 | 파일 | 핵심 변경 |
|---|---|---|
| UI | apps/web/shared/ui/meet-video.tsx | 수업·대기 영상 <video>에 contextmenu 차단과 callout·선택 차단 스타일 추가 (+4) |
| UI | apps/web/widgets/guest/guest-camera/ui/guest-camera.tsx | overlay·sidebar 카메라 <video>에 같은 처리, scaleX(-1) 유지 (+14/−2) |
| 테스트 | apps/web/shared/ui/meet-video.test.tsx | videoSrc가 null일 때와 수업 영상일 때: 영상 메뉴 차단, 바깥 메뉴·touch·click 통과, controls 숨김 |
| 테스트 | apps/web/widgets/guest/guest-camera/ui/guest-camera.test.tsx | overlay·sidebar: 메뉴 차단, userSelect, 반전 유지, 바깥 메뉴·touch·click 통과 |
| Storybook | apps/web/shared/ui/meet-video.stories.tsx | 기본 폭·320px·768px에서 play 함수로 차단과 계산된 스타일 확인 |
| Storybook | apps/web/widgets/guest/guest-camera/ui/guest-camera.stories.tsx | canvas captureStream() 영상으로 sidebar·overlay 모바일 형태 확인 |
검증: 단위 테스트 2개 파일, 8/8 통과. typecheck와 Storybook 정적 빌드는 실행하지 않았다.
iOS의 길게 누르기 차단은 실기기에서만 확인할 수 있다. jsdom과 데스크톱 Chromium은 시스템 callout을 재현하지 못한다. -webkit-touch-callout은 링크와 이미지에 대한 효과가 문서화되어 있지만, <video>의 길게 누르기 메뉴까지 막는지는 iPad·iPhone에서 직접 확인해야 한다. 안 막히면 영상 위에 투명 레이어를 덮거나 pointer-events를 조정하는 방안을 검토한다.
모바일 autoplay 해제 탭이 그대로 동작하는지. MeetVideo는 모바일에서 사용자가 탭해야 소리를 켠다(hasUserUnmutedRef). 이번 변경은 contextmenu만 막고 touch·click은 건드리지 않아 영향이 없을 것으로 보이지만, 실기기에서 길게 누르기 → 메뉴 없음 → 짧은 탭으로 소리 켜짐 순서를 함께 확인한다.
같은 속성 묶음이 3개 파일에 반복된다. friend-choice-screen.tsx까지 합치면 <video> 5곳이 각자 같은 처리를 한다. 앞으로 영상 요소가 늘어나면 공통 props 상수나 CSS 클래스(.no-native-menu)로 묶을 수 있다. 지금 규모에서는 인라인으로 두어도 무방하다.
진행자 모니터에도 적용된다. 모니터의 수업 영상(GuestLayoutContent → MeetVideo)에서도 우클릭 메뉴가 사라진다. 진행자가 이 메뉴로 영상을 조작하던 운영 흐름이 있는지 확인이 필요하다. 녹화와 미디어 경로(WebRTC·loopback)에는 영향이 없고, 원복은 속성 삭제만으로 끝난다.
관련 문서: 영상 오디오 WebRTC loopback·iOS 덕킹 회피 코드레벨 동작흐름 — 이번에 바꾼 MeetVideo 수업 영상 요소의 재생·오디오 경로 설명