Java 21与Swing打造可视化scrcpy控制中心

1. 项目背景与核心价值

去年在调试Android设备时，我发现自己频繁地在命令行和图形界面之间切换。虽然scrcpy作为开源投屏工具已经非常强大，但纯命令行操作对于需要批量管理设备的场景还是不够直观。于是萌生了一个想法：能否用Java 21的新特性，结合经典的Swing框架，打造一个带可视化界面的scrcpy控制中心？

这个工具的核心价值在于：

• 将命令行参数可视化，通过GUI降低使用门槛
• 集成设备管理、画面调节、快捷键配置等常用功能
• 保留scrcpy的高性能特性，仅作为控制前端存在
• 展示Java 21在桌面应用开发中的现代实践

2. 技术选型解析

2.1 为什么选择Java 21？

• 虚拟线程（Loom项目）：处理设备连接时的阻塞IO操作
• 模式匹配增强：简化设备状态判断逻辑
• Record类：完美适配设备信息的数据载体
• SequencedCollection：管理设备列表时更直观的排序操作

2.2 Swing的现代实践

虽然JavaFX更现代，但选择Swing出于以下考虑：

1. 兼容性需求：需支持企业内老版本JDK环境
2. 轻量级：整个工具包大小可控制在10MB以内
3. FlatLaf加持：通过UIManager.setLookAndFeel()应用现代皮肤

java复制// 典型的外观配置代码
UIManager.setLookAndFeel(new FlatDarkLaf());
JFrame.setDefaultLookAndFeelDecorated(true);

2.3 与scrcpy的集成方案

采用ProcessBuilder启动原生scrcpy进程，通过参数管道进行控制：

java复制ProcessBuilder pb = new ProcessBuilder("scrcpy",
    "--serial", deviceId,
    "--bit-rate", "8M",
    "--max-fps", "60");
pb.redirectErrorStream(true);
Process process = pb.start();

3. 核心功能实现

3.1 设备管理模块

使用ADB命令获取设备列表，通过表格展示关键信息：

注意：ADB命令执行需要处理超时情况，建议设置30秒超时限制

3.2 画面调节面板

实现实时参数调节的关键代码片段：

java复制// 使用PropertyChangeListener实现实时更新
bitRateSlider.addPropertyChangeListener(e -> {
    if(connectedDevice != null) {
        sendCommand("bitrate:" + bitRateSlider.getValue());
    }
});

// 封装命令发送方法
private void sendCommand(String cmd) throws IOException {
    if(process != null && process.isAlive()) {
        process.getOutputStream().write(cmd.getBytes());
        process.getOutputStream().flush();
    }
}

3.3 快捷键映射方案

采用分层设计：

1. 基础键位：继承scrcpy默认配置（Ctrl+O等）
2. 自定义层：JSON配置文件热加载
3. 宏功能：支持操作序列录制

json复制// 快捷键配置示例
{
  "screenshot": {
    "combination": "Alt+S",
    "action": "adb exec-out screencap -p > ${DATE}.png"
  }
}

4. 性能优化实践

4.1 虚拟线程的应用

设备监控场景的典型模式：

java复制Thread.startVirtualThread(() -> {
    while(!Thread.currentThread().isInterrupted()) {
        updateDeviceList();
        Thread.sleep(3000);
    }
});

对比测试结果（100设备模拟）：

4.2 画面渲染优化

采用双缓冲策略解决Swing闪烁问题：

1. 后台线程：通过BufferedImage获取scrcpy帧数据
2. 前端显示：使用JLabel+ImageIcon实现异步更新
3. 引入差值算法：在分辨率缩放时保持清晰度

java复制// 图像更新示例
BufferedImage newFrame = grabFrame();
SwingUtilities.invokeLater(() -> {
    if(displayLabel != null) {
        displayLabel.setIcon(new ImageIcon(
            newFrame.getScaledInstance(
                displayLabel.getWidth(),
                displayLabel.getHeight(),
                Image.SCALE_SMOOTH)
        ));
    }
});

5. 常见问题解决方案

5.1 设备连接失败排查

1. ADB未授权：

   • 检查adb devices输出
   • 重新触发授权：adb kill-server && adb start-server

2. 端口冲突：

   • 查看已占用端口：netstat -ano | findstr 5555
   • 指定备用端口：scrcpy --port 5556

3. 编码器不支持：

   • 强制指定编码器：--video-codec=h264
   • 降低画质参数：--bit-rate=2M

5.2 内存泄漏预防

重点监控区域：

• Process对象未关闭
• Image资源未释放
• 监听器未注销

推荐使用Java 21的ScopedValue进行资源管理：

java复制ScopedValue.where(DEVICE_SCOPE, device)
          .run(() -> {
              // 设备相关操作
          }); // 自动清理资源

6. 扩展功能设计

6.1 插件系统架构

采用Java SPI机制实现扩展点：

1. 定义接口：

java复制public interface ScrcpyPlugin {
    String getName();
    void init(JPanel container);
}

2. 示例插件实现：

java复制// META-INF/services/com.example.ScrcpyPlugin
com.example.ClipboardPlugin
com.example.FileTransferPlugin

6.2 多显示器支持

通过JNA调用本地API：

java复制public interface User32 extends Library {
    int GetSystemMetrics(int index);
}

User32 user32 = Native.load("user32", User32.class);
int monitorCount = user32.GetSystemMetrics(80); // SM_CMONITORS

实际开发中发现，Java 21的Swing在多显示器环境下存在DPI缩放问题，最终采用以下解决方案：

1. 主窗口创建时指定GraphicsConfiguration
2. 手动计算缩放比例：

java复制double scaleX = config.getDefaultTransform().getScaleX();
double scaleY = config.getDefaultTransform().getScaleY();

这个项目让我深刻体会到，即使是被视为"过时"的技术栈，结合现代语言特性依然能焕发新生。特别是在企业级工具开发中，稳定性和兼容性往往比追逐新技术更重要。后续计划加入WebSocket远程控制功能，让这个工具能适应更多运维场景。