-
Notifications
You must be signed in to change notification settings - Fork 8
Remote Control
The remote-control screen displays the target video and sends touch, key, text, and selected control messages.
- Connect directly from the session list and open remote control.
- Establish ADB first, then start the remote-control path.
- 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 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.
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.
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.
- Normal mode: based on
SurfaceView, with lower latency. - Full-screen mode: based on
TextureView, better suited to true full screen and background retention.
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 is optional and adds a separate decode and playback path. When diagnosing basic remote control, disable audio first to reduce variables.
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.
- 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.
- Overview / 总览
- Quick Start / 快速开始
- Connection & Pairing / 连接设备与配对
- Session Management / 会话管理
- Remote Control / 远程控制
- Settings / 设置
- Management Features / 管理功能
- FAQ / 常见问题
- Overview / 总览
- Technical Index / 技术文档索引
- Audit Checklist / 初始化与更新清单
- Conventions / 文档维护约定
- Architecture / 架构
- Module Map / 模块地图与边界
- Runtime Path / 运行时主链路
- Session State / 会话状态与事件
- Session Lifecycle / 会话配置与连接生命周期
- ADB, USB & Wireless / ADB、USB 与无线
- ADB Lifecycle / ADB 连接生命周期
- Pairing / 设备配对与无线调试
- Codecs / 编码与解码
- Remote Interaction / 远程交互性能与悬浮菜单
- Clipboard / 剪贴板同步
- Management / 管理功能
- Events & Shell / 事件、监控与 Shell
- Logging / 日志系统与维护
- Troubleshooting / 分层排障方法
- UI Design / UI 设计系统
- Bilingual Copy / 双语与文案
- Remote UI Analysis / 远程 UI 布局分析
- Engineering Rules / 工程与验证规则
- External Research / 外部研究与取舍
Technical topics appear here only after their page-level audit is complete. / 技术主题仅在完成逐页审核后加入侧边栏。