sndcpy 深度实践指南:无需 root 将 Android 10 设备音频转发到电脑
sndcpy 深度实践指南:无需 root 将 Android 10 设备音频转发到电脑
导读
sndcpy 是一个面向 Android 10 及以上设备的音频转发工具,它能在不获取 root 权限的前提下,把设备上正在播放的音频实时转发到电脑端,并可配合 scrcpy 实现"手机画面 + 声音"同步投放到电脑。本文以项目 README.md 为主线,结合仓库内启动脚本与 Android 源码实现,完整讲解它的安装、运行、卸载、环境变量配置、应用限制与延迟问题,并深入剖析"设备端录音 → 本地 socket → adb 端口转发 → 电脑端 VLC 播放"的完整调用链,帮助你从"会用"进阶到"理解其原理"。
项目定位:scrcpy 生态中的音频补充方案
sndcpy(当前版本 v1.1)最初的设计动机非常明确:在 scrcpy 同步镜像手机画面的同时,补上"音频转发"这一环——手机画面可以投到电脑,声音却还留在手机扬声器里,观感割裂。sndcpy 正是为解决这个缺口而生的轻量级概念验证(Proof-of-Concept,PoC)应用。
需要注意两个事实层面的定位:
- 它是独立工具,不依赖 scrcpy。虽然设计初衷是与 scrcpy 配合,但 sndcpy 单独运行也完全成立,电脑端只需用 VLC 接收音频流。
- 它明确是 PoC。作者在 README 中直言"这只是概念验证,远非完美",并且由于 Android 音频捕获策略的限制,很多应用无法被转发(详见下文"应用限制"章节)。
- 生态现状:README 更新说明指出,scrcpy 2.0 已原生支持音频转发。也就是说,sndcpy 更适合被当作理解 Android 10 音频捕获机制的参考实现,而非继续作为长期依赖的日常工具。
前置条件
运行 sndcpy 需要同时满足两端要求:
| 端 | 要求 |
|---|---|
| Android 设备 | 系统版本至少为 Android 10(API level 29),并开启 USB 调试 |
| 电脑 | 已安装 VLC 媒体播放器(sndcpy 依赖 VLC 播放收到的原始音频流) |
支持的操作系统为 GNU/Linux、Windows 与 macOS。其中 macOS 与 Linux 使用同名的 Bash 脚本 sndcpy,Windows 使用批处理脚本 sndcpy.bat。
获取应用
项目的发布产物是 zip 压缩包,共提供两个版本:
sndcpy-v1.1.zip—— 包含 APK 与启动脚本(sndcpy、sndcpy.bat);sndcpy-with-adb-windows-v1.1.zip—— Windows 用户建议直接选用此包,因为其中额外内置了adb可执行文件,省去单独配置 adb 的麻烦。
两个包均提供了官方 SHA-256 校验值,下载后可用 sha256sum(Linux/macOS)或 certutil / Get-FileHash(Windows)核对文件完整性,防止下载损坏或被篡改:
b045320ddddbc5a237d6d95213c664f03b2f46ef8bbfcef91c2d95644ed42bbc # sndcpy-v1.1.zip
0b93c846f574df3f38f53eeee44b1a35b863a49465da8f5cd5b1b69a29305901 # sndcpy-with-adb-windows-v1.1.zip
除此之外,也可以按照 BUILD.md 从源码自行构建 APK,本文末尾会给出完整步骤。
快速上手:运行与停止
将已开启 USB 调试的 Android 10 设备用数据线连接到电脑,然后在仓库(或解压后的发布目录)中执行:
./sndcpy
脚本会自动完成一整套动作(详见下文"底层调用链"章节):等待设备连接 → 安装 APK → 授予媒体投影权限 → 建立端口转发 → 启动设备端捕获服务 → 在电脑端拉起 VLC 播放音频流。
停止转发的三种方式:
- 在运行脚本的终端中按下
Ctrl+c; - 断开设备连接(Windows 下推荐);
- 下拉手机通知栏,在 sndcpy 的前台服务通知上点击 Stop 按钮。
两个运行中的预期现象,无需惊慌:
- 首次启动时 VLC 可能打印如下错误:
main stream error: connection error: Connection refused
这是因为 VLC 在设备端服务完全就绪前就尝试连接了端口,属于"预期中的错误",忽略即可。
- 转发过程中手机扬声器依然有声。音频是"旁路捕获 + 转发",并非静音转移;手机端与电脑端音量可以各自独立调节,互不影响。
多设备场景:指定 serial
当电脑同时连接了多台设备时(可通过 adb devices 查看),脚本无法自动判断该操作哪一台,需要在命令行参数中显式指定设备序列号:
./sndcpy <serial> # 用实际序列号替换 <serial>
Windows 下则对应:
sndcpy.bat <serial>
脚本内部会将该序列号拼装为 adb -s <serial> ... 形式,把后续所有 adb 命令都限定到目标设备上(见 sndcpy 脚本第 9–15 行)。
卸载
sndcpy 是标准的 Android 应用,卸载同样通过 adb 完成:
adb uninstall com.rom1v.sndcpy
包名 com.rom1v.sndcpy 在 app/build.gradle 的 applicationId 中定义,同时也是 AndroidManifest.xml 的包名。
应用限制:Android 的音频捕获策略(capture policy)
sndcpy 并非对任何应用的声音都能转发。Android 为"播放捕获"(playback capture)制定了策略,规则直接决定某个 app 的声音是否允许被 AudioRecord 捕获,核心规则如下:
- 默认情况下,targetSdkVersion ≤ Android 9.0(API 28) 的应用不允许被捕获其播放音频;若希望允许,需在其
AndroidManifest.xml中声明android:allowAudioPlaybackCapture="true"。- 默认情况下,targetSdkVersion 为 Android 10(API 29)或更高 的应用允许被捕获;若希望禁止,则声明
android:allowAudioPlaybackCapture="false"。
因此,如果你在转发过程中发现某个 app(尤其是老应用)的声音完全收不到,往往不是 sndcpy 的问题,而是该应用尚未在清单文件中声明允许捕获。这类应用需要开发者升级后才能被 sndcpy 转发。
此外,sndcpy 本身也不是"有声音就抓"——设备端在构建捕获配置时只匹配了三种音频用途(usage),见 RecordService.java:
AudioPlaybackCaptureConfiguration.Builder confBuilder =
new AudioPlaybackCaptureConfiguration.Builder(mediaProjection);
confBuilder.addMatchingUsage(AudioAttributes.USAGE_MEDIA);
confBuilder.addMatchingUsage(AudioAttributes.USAGE_GAME);
confBuilder.addMatchingUsage(AudioAttributes.USAGE_UNKNOWN);
从源码结构可以推断:常规媒体播放(USAGE_MEDIA)、游戏(USAGE_GAME)以及未指定用途的音频(USAGE_UNKNOWN)会被捕获,而通话(USAGE_VOICE_COMMUNICATION)等用途不在匹配范围内。
音频延迟:抖动引发的缓冲问题
作为 PoC,sndcpy 的延迟控制并不完美。音频流通过网络转发时会产生抖动(jitter),VLC 检测到抖动后会自动增大缓冲,导致延迟急剧恶化。典型报错为:
main input error: ES_OUT_SET_(GROUP_)PCR is called too late (pts_delay increased to 377 ms)
pts_delay increased to 377 ms 意味着播放缓冲区被拉大到了 377ms,画面与声音不同步将非常明显。应对办法很朴素:重启转发(重新执行脚本)即可让缓冲回到初始状态。从实现上看,脚本本身已尽量把延迟压低:VLC 启动参数中的 --network-caching=0 关闭了网络缓冲,设备端录音线程也只缓存 15ms 的数据(详见下一节)。
环境变量:覆盖脚本默认值
启动脚本 sndcpy(Linux/macOS)与 sndcpy.bat(Windows)内置了一系列默认值,均可用同名环境变量覆盖:
| 环境变量 | 含义 | 默认值(Linux/macOS) | 默认值(Windows) |
|---|---|---|---|
ADB |
adb 可执行文件的完整路径 |
adb(依赖 PATH) |
adb(依赖 PATH) |
VLC |
vlc 可执行文件的完整路径 |
vlc(依赖 PATH) |
C:\Program Files\VideoLAN\VLC\vlc.exe |
SNDCPY_APK |
sndcpy.apk 的完整路径 |
sndcpy.apk(当前目录) |
sndcpy.apk(当前目录) |
SNDCPY_PORT |
与设备通信的本地转发端口 | 28200 |
28200 |
典型用法:当 adb 或 VLC 不在 PATH 中时,显式指定完整路径:
ADB=/opt/android-platform-tools/adb \
VLC=/usr/bin/vlc \
SNDCPY_APK=/tmp/sndcpy.apk \
SNDCPY_PORT=28201 \
./sndcpy
注意 SNDCPY_PORT 同时影响端口转发与 VLC 拉流地址:脚本会执行 adb forward tcp:$SNDCPY_PORT localabstract:sndcpy,VLC 则从 tcp://localhost:$SNDCPY_PORT 拉流,两者必须一致。
底层调用链:从脚本到设备端的完整链路
这一节把"运行 ./sndcpy 之后发生了什么"逐条拆开,所有证据均来自 sndcpy 脚本与 Android 端源码。
1. 等待设备并安装 APK
"$ADB" $serial wait-for-device
"$ADB" $serial install -t -r -g "$SNDCPY_APK"
wait-for-device阻塞至设备在线;- 安装参数
-t允许安装测试 APK、-r覆盖安装、-g安装后立即授予所有运行时权限(此处即RECORD_AUDIO)。
如果安装失败(通常是版本签名冲突),脚本会先卸载旧版再重装:
"$ADB" $serial uninstall com.rom1v.sndcpy
"$ADB" $serial install -t -g "$SNDCPY_APK"
2. 授予媒体投影权限
"$ADB" $serial shell appops set com.rom1v.sndcpy PROJECT_MEDIA allow
Android 10 引入了 PROJECT_MEDIA 这一 AppOps 权限,用于约束"通过媒体投影捕获音频"的能力。这一步相当于以 adb 方式为用户授予该权限,否则 AudioPlaybackCapture 将无法生效。
3. 建立端口转发
"$ADB" $serial forward tcp:28200 localabstract:sndcpy
设备端 RecordService 会创建一个名为 sndcpy 的 LocalServerSocket(见 RecordService.java),adb forward 把电脑本地的 tcp:28200 与设备端该 abstract socket 打通,使电脑程序能像访问本机端口一样读取设备数据。
4. 启动设备端捕获服务
"$ADB" $serial shell am start com.rom1v.sndcpy/.MainActivity
接着就是 Android 端的两段式启动:
- MainActivity.java 检查
RECORD_AUDIO权限,随后通过MediaProjectionManager.createScreenCaptureIntent()弹出系统的"屏幕/媒体投影"授权对话框; - 用户确认后,
RecordService以前台服务方式启动(foregroundServiceType="mediaProjection",见 AndroidManifest.xml),创建通知提示"Waiting for connection…"(等待连接中)。
5. 录音、编码与转发
捕获线程的核心实现在 RecordService.java:
recorder.startRecording();
int BUFFER_MS = 15; // 最多缓存 15ms 的音频
byte[] buf = new byte[SAMPLE_RATE * CHANNELS * BUFFER_MS / 1000];
while (true) {
int r = recorder.read(buf, 0, buf.length);
socket.getOutputStream().write(buf, 0, r);
}
关键参数(见 RecordService.java 与 RecordService.java):
| 参数 | 值 | 说明 |
|---|---|---|
采样率 SAMPLE_RATE |
48000 Hz | 与设备播放管线常用的 48kHz 对齐 |
声道 CHANNELS |
2(立体声) | 对应 CHANNEL_IN_STEREO |
| 编码 | ENCODING_PCM_16BIT |
16-bit 线性 PCM,即裸 PCM 流 |
AudioRecord 缓冲区 |
1 MB(1024 * 1024 字节) |
缓冲足够大以吸收调度抖动 |
| 读取块大小 | 15ms × 48kHz × 2ch ≈ 1440 字节 | 刻意不缓存更多数据,压低端到端延迟 |
音频被录制成未压缩的 PCM 原始流直接写入 socket,不经过任何转码——这正是电脑端 VLC 需要使用 rawaud demuxer 的原因。
6. 电脑端 VLC 拉流播放
"$VLC" -Idummy --demux rawaud --network-caching=0 --play-and-exit tcp://localhost:28200
| 参数 | 作用 |
|---|---|
-Idummy |
使用无界面(dummy)接口,不弹播放器窗口 |
--demux rawaud |
以 raw audio demuxer 解析裸 PCM 流 |
--network-caching=0 |
关闭网络缓冲,最小化延迟 |
--play-and-exit |
播放结束后自动退出进程 |
tcp://localhost:28200 |
从本地转发端口读取音频数据 |
至此,"设备录音 → local socket → adb forward → 电脑 VLC"的完整链路闭合,声音在电脑端播出。
从源码构建与发布
如果不想使用预编译包,或希望修改后自行构建,可参考 BUILD.md 与仓库脚本。
Debug 构建
项目是常规 Gradle Android 工程(模块定义见 settings.gradle,Gradle 7.0.2 wrapper 见 gradle/wrapper/gradle-wrapper.properties):
./gradlew assembleDebug
仓库还提供了 run 脚本,它会先自动执行 assembleDebug 再调用 sndcpy,保证运行的始终是最新构建(因为构建很快,run 每次都重新构建),支持传入 serial:
./run
./run <serial> # 多设备时指定序列号
也可以在 Android Studio 中直接打开工程构建运行。Android 端关键构建参数见 app/build.gradle:minSdkVersion 29(Android 10)、targetSdkVersion 31、compileSdkVersion 31、versionName "1.1"。
Release 构建与签名
发布版需要签名 APK,步骤为:
- 用
keytool生成签名用的 keystore:
keytool -genkey -v -keystore sndcpy.keystore -alias sndcpy \
-keyalg RSA -keysize 2048 -validity 30000
- 在
~/.gradle/gradle.properties中写入签名信息(路径与口令按实际调整):
SNDCPY_STORE_FILE=/path/to/your/sndcpy.keystore
SNDCPY_STORE_PASSWORD=the_keystore_password
SNDCPY_KEY_ALIAS=sndcpy
SNDCPY_KEY_PASSWORD=the_key_password
- 执行发布脚本 release.sh,产物输出到
dist/目录:
./release.sh
release.sh 会以 git describe --tags --always 生成版本号,执行 assembleRelease,并把 app-release.apk 重命名为 sndcpy.apk,连同 sndcpy、sndcpy.bat 一起打包为 zip,结构与官方发布包一致。
需要提醒的一点:BUILD.md 中给出的属性名为 SNDCPY_* 前缀,而 app/build.gradle 实际读取的是 RELEASE_STORE_FILE、RELEASE_STORE_PASSWORD、RELEASE_KEY_ALIAS、RELEASE_KEY_PASSWORD,且以 SNDCPY_STORE_FILE 是否被定义作为启用签名配置的开关。从源码结构推断,实际构建时需保证 SNDCPY_STORE_FILE 存在以触发签名配置,同时提供对应的 RELEASE_* 四个属性供取值,两者缺一不可。
总结
sndcpy 用不到百行的设备端代码 + 两个平台脚本,完整演示了 Android 10 音频转发的最小可行方案:MediaProjection 授权捕获、AudioPlaybackCaptureConfiguration 按 usage 筛选音频、LocalServerSocket + adb forward 打通传输通道、VLC 以 rawaud 无缓冲模式低延迟播放。作为 PoC,它在延迟与 app 兼容性上并不完美,但其架构清晰、链路简单,是理解 Android 播放捕获机制与 adb 转发原理的绝佳参考;而 scrcpy 2.0 的原生音频支持也印证了这套思路的正确性。