Genymobile/scrcpy项目设备连接方式详解

Genymobile/scrcpy项目设备连接方式详解

前言

Genymobile/scrcpy是一款强大的Android设备屏幕镜像和控制工具。作为技术专家，我将详细介绍该工具的各种设备连接方式，帮助开发者更好地理解和使用这一工具。

设备选择机制

当系统中只连接一台Android设备时，scrcpy会自动选择该设备进行连接。但在多设备环境下，我们需要明确指定目标设备。

四种指定方式

1. 通过设备序列号指定

   scrcpy --serial=0123456789abcdef
   scrcpy -s 0123456789abcdef  # 简写形式
   

   对于TCP/IP连接的设备，序列号格式为IP:端口：

   scrcpy --serial=192.168.1.1:5555
   

2. 指定USB连接设备

   scrcpy --select-usb
   scrcpy -d  # 简写形式
   

3. 指定TCP/IP连接设备

   scrcpy --select-tcpip
   scrcpy -e  # 简写形式
   

4. 直接指定TCP/IP连接设备

   scrcpy --tcpip=192.168.1.1:5555
   scrcpy --tcpip=192.168.1.1  # 默认端口5555
   

环境变量指定

与adb工具类似，scrcpy也支持通过环境变量指定设备：

# Bash
export ANDROID_SERIAL=0123456789abcdef
scrcpy

:: CMD
set ANDROID_SERIAL=0123456789abcdef
scrcpy

# PowerShell
$env:ANDROID_SERIAL = '0123456789abcdef'
scrcpy

无线连接(TCP/IP模式)

scrcpy通过adb与设备通信，而adb支持TCP/IP无线连接。设备必须与电脑处于同一网络。

自动连接方式

--tcpip参数提供了两种自动连接方案：

1. 设备TCP/IP模式未启用时

   scrcpy --tcpip
   

   此命令会自动完成以下操作：

   • 查找设备IP和adb端口
   • 必要时启用TCP/IP模式
   • 连接设备并启动scrcpy

2. 设备已连接adb时

   scrcpy --tcpip=192.168.1.1       # 默认端口5555
   scrcpy --tcpip=192.168.1.1:5555
   

   使用"+"前缀强制重新连接：

   scrcpy --tcpip=+192.168.1.1
   

手动连接步骤

1. 通过USB连接设备
2. 确保设备和电脑在同一WiFi网络
3. 获取设备IP地址：
   • 设置 → 关于手机 → 状态
   • 或执行命令：

     adb shell ip route | awk '{print $9}'
     

4. 启用adb TCP/IP模式：

   adb tcpip 5555
   

5. 断开USB连接
6. 无线连接设备：

   adb connect DEVICE_IP:5555
   

7. 运行scrcpy
8. 完成后断开连接：

   adb disconnect
   

注意：Android 11及以上版本支持无线调试选项，可避免物理连接设备。

设备连接自动启动

配合AutoAdb工具，可以在检测到新设备连接时自动启动scrcpy：

autoadb scrcpy -s '{}'

技术要点总结

1. 多设备环境下必须明确指定目标设备
2. 无线连接需要设备与电脑处于同一网络
3. Android 11+支持纯无线调试流程
4. 自动连接功能简化了无线配置过程
5. 环境变量指定方式适合固定设备开发环境

掌握这些连接方式，开发者可以更灵活地在各种场景下使用scrcpy进行Android设备调试和演示。