기능 목록으로 돌아가기
웹 대시보드Screen Mirror5 min read

웹 대시보드의 화면 미러링

브라우저에서 Android 휴대폰 화면을 보고 제어하세요 — 라이브 캔버스, 전체 화면, HD/부드러움 품질 모드, 전체 원격 제어(탭, 스와이프, 스크롤, 탐색 키), 녹화 및 원클릭 스크린샷.

웹 대시보드의 Screen Mirror 보기는 브라우저 탭에서 Android 휴대폰 화면을 렌더링합니다 — 이 기능이 실제 사용자 인터페이스를 가진 유일한 장소입니다. 휴대폰 측에는 전용 Screen Mirror 화면이 없습니다. 브라우저에서 세션을 시작하면 백그라운드 서비스가 스트리밍을 시작하며, 모든 컨트롤은 여기에 있습니다.

스트림은 WebCodecs로 디코딩되어 <canvas>에 그려지므로, 페이지는 보안 컨텍스트(HTTPS 또는 localhost)에서 제공되어야 합니다. PlainApp의 로컬 서버는 이미 이 요구 사항을 충족하지만, non-localhost 주소에서 일반 HTTP로 대시보드를 로드한 경우, 페이지는 스트림을 시작하는 대신 needs HTTPS 프롬프트와 함께 보안 URL 링크를 표시합니다.

Screenshot: Screen Mirror
Screen Mirror

주요 기능

  • 라이브 캔버스 미러 — 프레임이 WebCodecs로 디코딩되어 <canvas> 요소에 그려집니다. 플러그인이나 네이티브 클라이언트 없이 브라우저만으로 작동합니다.
  • 전체 원격 제어 — 제어가 활성화되면, 캔버스에서 클릭, 드래그 및 스크롤이 실제 화면 좌표로 정규화되어 휴대폰에서 실제 탭, 길게 누르기, 스와이프 및 스크롤로 변환됩니다. 전용 버튼으로 Back, Home 및 Recents를 보낼 수 있습니다.
  • 전체 화면 모드 — 캔버스를 확장하여 화면을 채우고, Esc(또는 도구 모음 토글)를 눌러 종료합니다.
  • HD / 부드러움 품질 모드 — 세션 중간에 품질을 전환합니다: HD는 선명도를 우선시하고, Smooth는 혼잡한 Wi-Fi에서 지연 시간을 낮추기 위해 해상도를 희생합니다.
  • 스크린샷 캡처 — 한 번의 클릭으로 현재 프레임의 .png를 다운로드합니다.
  • 세션 녹화 — 실행 중인 녹화 타이머와 함께 도구 모음에서 캔버스를 비디오 파일로 로컬에 녹화합니다.
  • 오디오 미러링 — 휴대폰에서 오디오 패스스루를 요청하고 브라우저에서 독립적으로 음소거/음소거 해제할 수 있습니다.
  • 재시작 및 일시 중지 — 세션을 종료하지 않고 스트림을 일시 중지하여 대역폭 소비를 중단하거나, 휴대폰의 미러 서비스가 중단되면 재시작할 수 있습니다.

사용 방법

  1. 대시보드 사이드바에서 Screen Mirror 페이지를 엽니다. 휴대폰이 현재 미러링 중이 아닌 경우 Start를 클릭하여 휴대폰이 캐스팅을 시작하도록 요청합니다.
  2. 라이브 미러를 봅니다 — 휴대폰이 화면 캡처 권한을 부여하면 1-2초 내에 캔버스에 프레임이 나타납니다.
  3. 도구 모음에서 원격 제어를 활성화한 후, 캔버스에서 클릭, 드래그 또는 스크롤하여 휴대폰을 직접 쥐고 있는 것처럼 상호작용하며, 전용 Back/Home/Recents 버튼도 사용할 수 있습니다.
  4. 전체 화면 버튼을 클릭하여 전체 화면으로 전환하고, Esc를 눌러 대시보드 레이아웃으로 돌아갑니다.
  5. 도구 모음의 HD/Smooth 토글로 품질을 변경합니다 — 다음 키프레임에서 전환이 적용됩니다.
  6. 도구 모음에서 스크린샷을 캡처하거나 녹화를 시작하고, 완료되면 Stop하여 세션을 종료합니다.

팁 & 요령

  • 공유 공간에서 미러링할 때는 도구 모음에서 오디오를 음소거하세요 — 휴대폰의 스피커가 아닌 브라우저에만 영향을 줍니다.
  • 연결을 끊지 않고 일시 중지하려면 재생/일시 중지 버튼을 클릭하세요 — 업데이트에 대역폭을 소모하지 않고 정적 화면을 읽어야 할 때 유용합니다.
  • 휴대폰의 미러 서비스가 중단된 경우 도구 모음에서 앱을 재시작하세요 — 휴대폰을 재부팅하지 않고 다시 시작합니다.
  • 원격 제어 좌표는 실제 비디오 해상도로 정규화되므로, 브라우저 창 크기를 조정하거나 전체 화면으로 전환해도 제어가 올바르게 정렬됩니다.

개인정보 및 보안 정보

  • 웹 대시보드는 자체 서명 인증서를 사용하는 HTTPS(으)로 제공되며, 모든 트래픽은 TLS 위에 XChaCha20-Poly1305(으)로 한 번 더 암호화됩니다.
  • 웹 대시보드는 로컬 네트워크에만 바인딩됩니다. 포트 포워딩을 명시적으로 설정하지 않는 한 인터넷에서 접근할 수 없습니다.
  • WebCodecs API는 이 보안 컨텍스트를 필요로 합니다 — 누락된 경우 페이지에 needs HTTPS 프롬프트가 표시됩니다.
  • 원격 제어 입력은 세션에 대해 명시적으로 활성화한 경우에만 수락되며, 미러를 닫거나 중지하면 즉시 취소됩니다.

관련 기능