Skip to content

Remote Control

星冉 edited this page Jul 21, 2026 · 1 revision

Remote Control

中文

The remote-control screen displays the target video and sends touch, key, text, and selected control messages.

Entry points

  • Connect directly from the session list and open remote control.
  • Establish ADB first, then start the remote-control path.

Capabilities

  • Display remote video.
  • Send touch actions and key events.
  • Send text input.
  • Synchronize clipboard text in both directions when clipboard sync is enabled.
  • Send a file to the target; APK files are installed, while other files are uploaded.
  • Apply configured screen-off, rotation, and related behavior.

Touch, keys, and text

Touch gestures on the video surface are forwarded to the target display. The remote-control path also supports Back, Home, Recents, text input, and clipboard paste. A one-character basic ASCII commit uses direct text injection; multi-character or non-ASCII text uses the clipboard path so Chinese, Emoji, newlines, and special characters are preserved.

Clipboard sync uses the scrcpy control channel. Android or the foreground app may still refuse clipboard reads or paste into protected fields.

Floating ball and menu

When the floating ball is enabled for the session:

  • Tap it to open or close the action menu.
  • Drag it normally to move it and snap it to an edge.
  • Long-press and drag left, right, up, or down for Back, Recents, Home, or notification-panel actions.
  • Continue holding without moving to capture a target-device screenshot.

The menu provides Back, Home, Recents, keyboard input, file upload, layout inspection, target-resolution adaptation/restoration, and disconnect. Haptic feedback is controlled separately in Settings.

Performance overlay

The setting Show FPS & Network Rates displays decoded/rendered FPS, video bitrate, and the app's network transmit/receive rates in the top-left corner of a scrcpy session. It is off by default and changes without reconnecting.

Game mode does not force the floating ball or performance overlay off. Each remains controlled by its own switch.

Display modes

  • Normal mode: based on SurfaceView, with lower latency.
  • Full-screen mode: based on TextureView, better suited to true full screen and background retention.

Background switching

The system can reclaim a normal-mode Surface more readily in the background. Full-screen mode tries to preserve its TextureView Surface for stability.

Audio

Audio is optional and adds a separate decode and playback path. When diagnosing basic remote control, disable audio first to reduce variables.

Sending files

Open file upload from the floating menu and select one local file. APK files follow the installation path; other files are uploaded to the target and the resulting remote path is shown. Keep the session connected until the completion or failure message appears.

Common symptoms

  • Black screen on first entry: confirm ADB, then verify the video path.
  • Connected but no image: inspect the scrcpy path and display parameters.
  • Recovery fails after backgrounding: check whether full-screen mode is enabled.
  • Text does not paste: confirm clipboard sync is enabled and test a normal editable field rather than a protected field.
  • No floating ball or statistics: verify the session's floating-ball option and the global performance-statistics setting independently.

Clone this wiki locally