Skip to content

Remote View ​

Remote View를 사용하면 대시보드에서 직접 지원되는 IDE 세션의 화면을 보고 상호작용할 수 있습니다.

인터넷 facing 원격 접근의 주요 경로는 클라우드입니다. 셀프호스트에서는 동일한 뷰가 로컬/LAN 대시보드 경로를 통해서만 작동합니다.

Remote View 열기 ​

  1. 대시보드 또는 머신의 Workspace 탭에서 IDE 세션을 엽니다.
  2. 해당 세션의 Remote를 엽니다.
  3. ADHDev가 원격 표면을 열고 해당 IDE 세션의 스크린샷 스트림을 시작합니다.

보기 모드 ​

분할 뷰 ​

데스크탑에서 표준 원격 표면은 한쪽에 채팅, 다른 쪽에 IDE 화면이 있는 분할 대화로 열립니다.

원격 전용 뷰 ​

화면이 전체 워크스페이스를 차지하도록 하려면 동일한 대화를 원격 전용 모드로 전환할 수 있습니다.

미리보기 표면 ​

일부 레이아웃은 전체 원격 대화를 열기 전에 더 작은 스크린샷 미리보기를 표시하기도 합니다.

상호작용 ​

Remote View가 활성화되면 IDE 세션을 제어할 수 있습니다:

액션데스크탑모바일
클릭마우스 클릭탭
우클릭오른쪽 마우스 버튼길게 누르기
더블 클릭더블 클릭더블 탭
입력물리적 키보드화면 키보드
스크롤마우스 휠 / 트랙패드두 손가락 스와이프
줌—핀치 줌

시각적 피드백 ​

모든 클릭은 클릭이 등록됐음을 알 수 있도록 클릭 위치에 리플 효과를 표시합니다.

성능 ​

직접 연결 (STUN) ​

P2P가 직접 연결되면 (릴레이 없이) 스크린샷이 빠르고 반응성이 좋습니다:

  • 새로고침 속도가 자동으로 조정됩니다 (화면이 변경될 때 더 빠르고, 정적일 때 더 느림)
  • 품질: 높음 (WebP 품질 25)

릴레이 연결 (TURN) ​

P2P가 TURN 릴레이를 통하는 경우 (일반적으로 엄격한 NAT 뒤에서):

  • 약간 더 느린 새로고침 속도
  • 대역폭 감소를 위한 낮은 품질 (WebP 품질 12)
  • 모니터링 및 제어는 여전히 완전히 작동

플랜 기반 제한 ​

클라우드 계정 제한:

플랜플랜 최소 간격릴레이 예산
Free5초60분/일
Pro2초4시간/일
Ultra2초무제한
Enterprise추가 플랜 최소 간격 없음무제한

INFO

릴레이 예산은 TURN 릴레이 스크린샷 시간에 적용됩니다. 직접 P2P 경로는 클라우드 릴레이 예산을 소비하지 않습니다.

INFO

이 할당량은 클라우드 플랜 제한입니다. 셀프호스트는 클라우드 스크린샷 예산을 사용하지 않지만, 네트워크 외부에서 호스팅 원격 접근 경로를 제공하지도 않습니다.

문제 해결 ​

"CDP not connected" 경고 ​

IDE가 CDP 활성화로 실행되고 있어야 합니다. 다음으로 다시 실행하세요:

bash
adhdev launch <supported-ide>

검은 화면 / 스크린샷 없음 ​

  • IDE가 머신에서 실제로 열려 있고 표시되는지 확인하세요
  • P2P 연결 상태를 확인하세요
  • Remote View를 닫고 다시 여세요

느리거나 끊김 ​

  • TURN 릴레이를 사용 중인지 확인하세요 (연결 정보에 표시됨)
  • 다른 P2P 집약 애플리케이션을 닫으세요
  • 더 나은 NAT 트래버설이 있는 네트워크를 시도하세요 (STUN 직접 연결이 가장 빠름)

세션이 열리지만 원격 컨트롤이 제한적으로 느껴짐 ​

  • Remote View를 포괄적인 원격 데스크탑 약속이 아닌 먼저 IDE 워크플로우로 취급하세요
  • Cursor는 현재 Remote View를 위한 가장 강력한 공개 시작점입니다
  • IDE 자체가 부분적으로만 검증된 경우 채팅이 여전히 원격 컨트롤보다 더 잘 작동할 수 있습니다

다음 단계 ​

호스팅 클라우드 문서는 여기에 있습니다. 오픈소스 및 셀프호스트 문서는 OSS 레포지토리에 있습니다.