게스트 영상 길게 누르기·우클릭 기본 메뉴 차단

마지막 업데이트 2026-10-19

947f0752 PR #1179 charles-na · 2026-10-19 Fix 6 files +255 −2

PPI-1390. 아동이 게스트 화면의 수업 영상이나 자기 카메라 영상을 길게 누르거나 우클릭하면 브라우저 기본 메뉴(저장·공유·복사 등)가 뜨던 문제를 막는다. 런타임 변경은 <video> 4곳에 속성 2개를 붙인 것뿐이고(+16/−2), 나머지는 테스트와 Storybook이다. 리뷰할 때는 바깥 영역의 메뉴와 영상 위 탭·터치는 그대로 동작하는지, 그리고 iOS·Android 실기기에서 실제로 막히는지(아직 확인 안 함)를 먼저 본다.

무엇이, 왜 바뀌었나

메뉴가 뜨는 경로는 두 가지다. 데스크톱 우클릭과 Android 길게 누르기는 contextmenu 이벤트로 오고, iOS Safari 길게 누르기는 이벤트 없이 -webkit-touch-callout으로 제어되는 시스템 callout이다. 그래서 두 수단을 함께 적용했고, 선택 강조를 막으려고 user-select: none도 더했다.

코드로 보는 핵심 지점

1. MeetVideo — 수업 영상과 대기 영상 두 분기에 같은 속성

apps/web/shared/ui/meet-video.tsx (1077, 1136) <video ref={videoRef} + onContextMenu={(event) => event.preventDefault()} + style={{ WebkitTouchCallout: "none", userSelect: "none" }} src={videoUrl}

2. GuestCamera — 기존 좌우 반전에 스타일만 추가

apps/web/widgets/guest/guest-camera/ui/guest-camera.tsx (overlay·sidebar 각각) + onContextMenu={(event) => event.preventDefault()} - style={{ transform: "scaleX(-1)" }} + style={{ + transform: "scaleX(-1)", + WebkitTouchCallout: "none", + userSelect: "none", + }}

3. 테스트 — 막는 것과 막지 않는 것을 함께 확인

apps/web/shared/ui/meet-video.test.tsx + expect(fireEvent.contextMenu(container.querySelector("video")!)).toBe(false); + expect(fireEvent.contextMenu(container)).toBe(true); + expect(fireEvent.touchStart(video)).toBe(true); + expect(container.querySelector("video")?.controls).toBe(false);

파일별 변경 요약

구분파일핵심 변경
UIapps/web/shared/ui/meet-video.tsx수업·대기 영상 <video>에 contextmenu 차단과 callout·선택 차단 스타일 추가 (+4)
UIapps/web/widgets/guest/guest-camera/ui/guest-camera.tsxoverlay·sidebar 카메라 <video>에 같은 처리, scaleX(-1) 유지 (+14/−2)
테스트apps/web/shared/ui/meet-video.test.tsxvideoSrc가 null일 때와 수업 영상일 때: 영상 메뉴 차단, 바깥 메뉴·touch·click 통과, controls 숨김
테스트apps/web/widgets/guest/guest-camera/ui/guest-camera.test.tsxoverlay·sidebar: 메뉴 차단, userSelect, 반전 유지, 바깥 메뉴·touch·click 통과
Storybookapps/web/shared/ui/meet-video.stories.tsx기본 폭·320px·768px에서 play 함수로 차단과 계산된 스타일 확인
Storybookapps/web/widgets/guest/guest-camera/ui/guest-camera.stories.tsxcanvas 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 수업 영상 요소의 재생·오디오 경로 설명