手上有一台康佳的 Android TV，遥控器坏了，电视本身运行得没问题。这时候我想看看系统里到底出了什么状况，习惯动作是打开电脑，插上 ADB，

问题就在这里。电视在客厅，电脑在书房，或者干脆电脑今天没带回家。scrcpy 很好用，但它默认另一端是一台电脑。

AScrcpy 就是为这个场景做的小项目。把完整的 scrcpy 控制端装进一台 Android 手机或平板，不需要电脑，不需要 Root，目标设备上也不会留下任何安装。

手机上的 App 通过 ADB TCP 连上目标设备的 

，用 shell 身份把内置的 scrcpy-server 推上去并启动。目标端开始把屏幕编码成 H.264 传回来，手机这边用 

。你在预览画面上点一下，App 把这次触摸序列化成 scrcpy 控制消息发回去。

ADB Host 的实现、scrcpy 协议处理、视频解码、控制端界面，都在 Android 侧独立完成。控制端基于 Kotlin 和 Jetpack Compose 写的，界面用了 Material 3。

 是未经修改的 scrcpy 4.0 server，跟官方发布的产物逐字节一致，校验和写在 

 里。协议部分直接复用 scrcpy 上游的 wire protocol，客户端和 server 锁在同一版本。除此之外没有包含任何 scrcpy 客户端源码。Romain Vimont 和 scrcpy 的所有贡献者设计了这套协议和"不向设备安装任何东西就能镜像 Android"这个想法，AScrcpy 是站在他们成果上的下游项目，许可证同样是 Apache 2.0。

## 为什么手机控手机这件事以前不好做

scrcpy 的设计前提很清晰，另一端是有键盘和鼠标的电脑。控制信号靠鼠标点击和键盘按键，画面靠 SDL 窗口显示。

换成手机，这套输入输出都要重新想。手机没有物理键盘，导航得靠屏幕上的按钮；没有鼠标指针，触摸要转换成坐标和压力值；屏幕尺寸不固定，横竖屏、刘海、挖孔都会影响映射。

AScrcpy 的处理方式是把导航做成一个可以拖动的悬浮遥控器。停靠在屏幕边缘时收成一个小图标，拖离边缘就展开成完整面板，里面有方向键、返回、Home、菜单、音量、电源。松手时如果靠近左右边缘就自动吸附。横屏下这套布局等比缩放，仍然能用。长按停靠图标可以在全屏预览和主界面之间切换。

连上以后预览自动全屏，被控的康佳电视画面出现在手机上，悬浮遥控器拖到顺手的位置。

项目拆成三个 Gradle 模块，依赖方向是 

 是一个可以独立复用的 Android Library。它对外暴露 

 这几个接口和工厂，公开 API 里不会出现 

 或者任何第三方 ADB 库的类型。默认实现是 

这个设计是为了后面加 USB Host 传输留位置。写一个 

 模块负责 server 生命周期、流协议、

 解码和控制消息序列化，它只通过 

 在一条 transport 上跑一个后台 reader，按 local id 把 

，这样视频流、控制消息和 server shell 才能并行跑。

ADB 认证这块，首次连接目标设备可能要你确认一次 RSA 指纹。私钥存在 

，不会被 Android 自动备份带走。

控制端是 OnePlus PJE110，Android 16，装机、启动，以及包含主机输入框和悬浮遥控器行为的 Compose instrumentation 测试都跑过。目标设备是那台康佳 Android TV KKAML966D5，Android 14，ADB 连接与授权、Shell、server 上传与启动，以及 1920 × 1072 下的 H.264 编解码链路都验证过。

这里踩过一个坑值得记下来。用同一台设备既当控制端又当目标端时，即使编解码链路完全正常，也可能得到黑屏或者递归画面。所以要验证画面内容和触摸坐标的准确性，尽量用两台设备。

说清楚哪些还没做，比列一堆功能有用。

目前只支持已开启并已授权的 TCP ADB，默认端口 5555。控制端要求 Android 8.0 以上。目标设备需要开 USB 调试、授权这台控制端，并且 TCP 可以访问。多数手机要先执行一次 

，电视盒子通常直接开无线调试就能拿到地址和端口。

当前传输是明文 legacy ADB 连接，只在可信网络里用。

Android 11 以上的 TLS 无线调试配对和 mDNS 设备发现、USB Host 传输、音频转发、剪贴板同步、键盘手柄、让会话在界面重建后继续存活的前台服务，这些都还没实现。不过它们都已经按现有模块边界设计好了，想加的话每一项都限定在单个模块内，接口是现成的。

装到控制端手机上。目标设备开 USB 调试并通过 TCP 接入，或者开无线调试记下地址和端口。

在应用里填 IP 和端口，点 Connect。App 会记住这个主机，下次作为候选项提示。先点 Test shell 确认连上了，再点 Start mirroring，预览会自动全屏打开。

然后直接在画面上触摸，用悬浮遥控器发导航键。

音频、剪贴板、HID、录制这些功能目前不支持。

如果你也遇到过"我只是想控制一下 Android 盒子，为什么还得先找台电脑"这种场景，可以来试试，也欢迎提 Issue、PR、或者点个 Star。

手上有一台康佳的 Android TV，遥控器坏了，电视本身运行得没问题。这时候我想看看系统里到底出了什么状况，习惯动作是打开电脑，插上 ADB，adb shell 敲几条命令看看。

AScrcpy，让一台 Android 手机直接充当 scrcpy 客户端，去控制另一台 Android 设备

把完整的 scrcpy 控制端装进一台 Android 手机或平板，不需要电脑，不需要 Root，目标设备上也不会留下任何安装。

开发工具

客户端

网络与通信

AScrcpy是一款无需电脑或Root，通过Android手机/平板远程控制另一台Android设备（如电视盒子）的开源工具。它利用ADB TCP连接推送官方scrcpy 4.0 server，实现H.264硬件解码与触摸映射。采用Kotlin与Jetpack Compose构建，支持悬浮遥控器，适配Android 8.0+。提供清晰模块划分与详细验证步骤，为无电脑场景下的设备调试提供轻量解决方案。

Android

Kotlin

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

AScrcpy是一款无需电脑或Root，通过Android手机/平板远程控制另一台Android设备（如电视盒子）的开源工具。它利用ADB TCP连接推送官方scrcpy 4.0 server，实现H.264硬件解码与触摸映射。采用Kotlin与Jetpack Compose构建，支持悬浮遥控器，适配Android 8...

AScrcpy，让一台 Android 手机直接充当 scrcpy 客户端，去控制另一台 Android 设备

AScrcpy，让一台 Android 手机直接充当 scrcpy 客户端，去控制另一台 Android 设备

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐