HandyCafe Docs
it-admin

원격 데스크톱

원격 데스크톱을 사용하면 관리자가 HandyCafe Server 인터페이스에서 직접 클라이언트 PC를 실시간으로 보고 제어할 수 있습니다. 인터넷 카페 또는 게이밍 센터에서 물리적으로 해당 컴퓨터까지 이동하지 않고도 문제 해결, 모니터링, 고객 지원을 수행할 수 있도록 설계되었습니다.

원격 데스크톱 세션 시작

  1. 관리자 패널에서 연결하려는 클라이언트를 찾습니다.
  2. 클라이언트 카드를 클릭하여 작업 버튼을 표시합니다.
  3. 원격 데스크톱 버튼을 클릭합니다.

원격 데스크톱 뷰어가 전용 창에서 열리며 인터랙티브 제어와 함께 클라이언트 화면을 표시합니다.

스트리밍 기술

H.264 코덱

클라이언트 화면은 낮은 대역폭에서 높은 시각적 품질을 제공하는 H.264 비디오 코덱으로 인코딩됩니다. 키 프레임은 빠른 초기 표시와 패킷 손실 복구를 위해 JPEG 인코딩을 폴백으로 사용합니다.

UDP 프레임 전송

인코딩된 프레임은 최소 지연 시간을 위해 UDP를 통해 전송됩니다. 각 프레임은 다음을 포함하는 30바이트 헤더를 가진 구조화된 프로토콜을 사용하여 청크로 분할됩니다.

헤더 필드 용도
매직 바이트 프로토콜 식별
버전 호환성을 위한 프로토콜 버전
프레임 유형 키 프레임 vs. 델타 프레임 표시
세션 ID 원격 데스크톱 세션 식별
시퀀스 번호 재조립을 위한 프레임 순서
타임스탬프 프레임 캡처 시간
청크 인덱스 프레임 내 이 청크의 위치
청크 수 프레임의 총 청크 수

이 청킹 방식을 통해 대용량 프레임이 네트워크를 안정적으로 통과하면서도 개별 UDP 패킷이 안전한 MTU 제한 내에 유지됩니다.

인터랙티브 제어

마우스 및 키보드 릴레이

연결되면 서버 운영자의 마우스 이동, 클릭, 키보드 입력이 클라이언트 PC로 전달됩니다. 클라이언트는 이러한 입력을 로컬에서 수행된 것처럼 실행하여 완전한 인터랙티브 제어가 가능합니다.

클립보드 동기화

원격 데스크톱 세션이 활성화된 동안 서버와 클라이언트 간에 클립보드가 동기화됩니다. 서버 측에서 복사한 텍스트를 클라이언트에 붙여넣을 수 있으며 그 반대도 가능합니다.

비트레이트 및 품질

스트리밍 비트레이트는 350 kbps에서 25,000 kbps 사이에서 구성할 수 있습니다. 자동 조정 메커니즘이 네트워크 상태를 모니터링하고 원활한 시청 경험을 유지하기 위해 비트레이트를 동적으로 조절합니다.

  • 빠르고 안정적인 네트워크에서는 비트레이트가 증가하여 더 선명한 이미지 품질을 제공합니다.
  • 혼잡하거나 느린 네트워크에서는 비트레이트가 감소하여 프레임 드롭과 지연을 방지합니다.

관리자는 다양한 사용 사례(예: 모니터링 vs. 적극적 제어)에 맞게 품질, FPS, 비트레이트의 균형을 맞춘 스트림 프리셋을 수동으로 선택할 수도 있습니다.

설정 가능한 항목

원격 데스크톱 뷰어는 다음 설정을 제공합니다.

  • 품질 -- 인코딩된 프레임의 이미지 품질 수준
  • FPS -- 스트림의 목표 초당 프레임 수
  • 비트레이트 -- 수동 비트레이트 설정 또는 자동 모드
  • 커서 표시 -- 원격 커서 오버레이 표시 여부
  • 스트림 프리셋 -- 일반적인 시나리오를 위한 사전 정의된 구성

세션 녹화

원격 데스크톱 세션은 나중에 검토할 수 있도록 MP4 파일로 녹화할 수 있습니다. 녹화는 수신되는 프레임 스트림을 표준 비디오 파일로 인코딩하는 FFmpeg 서브프로세스를 사용합니다. 녹화 파일은 타임스탬프가 포함된 파일명으로 config_dir/recordings/ 디렉토리에 저장됩니다.

패킷 손실 추적

뷰어에는 전송 중 손실된 프레임 또는 청크의 비율을 나타내는 드롭률 퍼센트가 표시됩니다. 높은 드롭률은 네트워크 혼잡을 시사하며, 비트레이트를 줄이거나 네트워크 문제를 조사해야 할 수 있습니다.