sndcpy 深度实践指南:无需 root 将 Android 10 设备音频转发到电脑

原创2026-10-14 13:49:221,110 阅读
文章标签:音视频移动开发

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 按钮。

两个运行中的预期现象,无需惊慌:

  1. 首次启动时 VLC 可能打印如下错误:
main stream error: connection error: Connection refused

这是因为 VLC 在设备端服务完全就绪前就尝试连接了端口,属于"预期中的错误",忽略即可。

  1. 转发过程中手机扬声器依然有声。音频是"旁路捕获 + 转发",并非静音转移;手机端与电脑端音量可以各自独立调节,互不影响。

多设备场景:指定 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,步骤为:

  1. 用 keytool 生成签名用的 keystore:
keytool -genkey -v -keystore sndcpy.keystore -alias sndcpy \
        -keyalg RSA -keysize 2048 -validity 30000
  1. 在 ~/.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
  1. 执行发布脚本 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 的原生音频支持也印证了这套思路的正确性。

登录后查看全文
sndcpy