架构

概述

Scrcpy采用客户端-服务器架构，通过电脑显示和控制Android设备

客户端运行在您的计算机上（Linux、Windows或macOS）
服务器运行在Android设备上
通信主要通过套接字进行，初始设置使用ADB（Android Debug Bridge）

这种分离使得系统能够高效地处理来自设备的视频和音频流，同时保持计算机的响应式控制。

高级架构图

来源：app/src/scrcpy.c47-92 server/src/main/java/com/genymobile/scrcpy/Server.java34-43

连接建立

客户端和服务器之间的连接过程涉及几个步骤

服务器准备：客户端通过ADB将服务器JAR推送到Android设备
服务器启动：客户端使用ADB shell命令执行服务器
套接字连接：服务器为视频、音频和控制创建套接字
协议握手：客户端和服务器建立通信通道

连接序列图

来源：app/src/server.c57-70 app/src/server.c204-464 app/src/scrcpy.c468-547

客户端架构

客户端负责

启动和与服务器通信
解码视频和音频流
显示设备屏幕
捕获用户输入并将其发送到设备
录制和文件推送等可选功能

客户端组件图

来源：app/src/scrcpy.c47-92 app/src/scrcpy.c368-1056

主要客户端组件

组件	目的	关键文件
`sc_server`	管理服务器连接和ADB交互	server.c, server.h
`sc_screen`	处理显示窗口和渲染	screen.c, screen.h
`sc_demuxer`	接收和处理视频/音频流	demuxer.c, demuxer.h
`sc_decoder`	解码视频/音频帧	decoder.c, decoder.h
`sc_controller`	处理和发送控制消息	controller.c, controller.h
`sc_recorder`	将设备屏幕录制到文件	recorder.c, recorder.h
`sc_file_pusher`	将文件发送到设备	file_pusher.c, file_pusher.h

来源：app/src/scrcpy.c47-92

客户端主处理循环

客户端围绕一个事件循环运行，该循环处理

SDL事件（键盘/鼠标输入、窗口事件）
内部事件（连接状态、错误）
用于显示和录制的帧处理

来源：app/src/scrcpy.c167-207 app/src/scrcpy.c368-1056

服务器架构

服务器运行在Android设备上，负责

捕获屏幕内容或摄像头馈送
捕获音频（如果已启用）
编码视频和音频
将编码数据流式传输到客户端
处理来自客户端的控制消息

服务器组件图

来源：server/src/main/java/com/genymobile/scrcpy/Server.java34-201

主要服务器组件

组件	目的	关键类
`服务器`	控制整体流程的主服务器类	Server.java
`选项`	从客户端传递的配置设置	Options.java
`SurfaceCapture`	屏幕/摄像头捕获的基类	SurfaceCapture.java
`ScreenCapture`	捕获设备屏幕内容	ScreenCapture.java
`CameraCapture`	捕获设备摄像头馈送	CameraCapture.java
`SurfaceEncoder`	使用MediaCodec编码视频	SurfaceEncoder.java
`AudioCapture`	捕获设备音频	AudioCapture.java
`AudioEncoder`	使用MediaCodec编码音频	AudioEncoder.java
`控制器`	处理控制消息	Controller.java
`DesktopConnection`	管理客户端连接	DesktopConnection.java

来源：server/src/main/java/com/genymobile/scrcpy/Server.java34-262

服务器处理流程

服务器使用在独立线程中运行的异步处理器进行操作

来源：server/src/main/java/com/genymobile/scrcpy/Server.java76-202

数据流

系统运行有三个主要数据流

视频流：设备屏幕/摄像头 → 编码 → 客户端 → 解码 → 显示
音频流：设备音频 → 编码 → 客户端 → 解码 → 播放
控制消息：客户端输入 → 设备操作

配置系统

Scrcpy可以通过命令行选项进行高度配置。这些选项会影响客户端和服务器的行为。

配置流程

来源：app/src/cli.c19-116 app/src/server.c204-464 server/src/main/java/com/genymobile/scrcpy/Options.java291-526

关键配置选项

类别	选项	目的
显示	max-size, display-id, fullscreen, video-source	控制设备显示方式
视频	video-codec, video-bit-rate, video-encoder	配置视频编码
音频	audio-codec, audio-bit-rate, audio-source	配置音频编码
输入	keyboard, mouse, gamepad	配置输入方法
连接	port, tunnel-host, tcpip	配置连接参数
特性	record, show-touches, stay-awake	启用附加功能

来源：app/src/options.h230-330 server/src/main/java/com/genymobile/scrcpy/Options.java23-289

总结

Scrcpy的架构围绕清晰的客户端-服务器模型设计，实现了高效的屏幕镜像和设备控制。

客户端（在计算机上）负责
- 用户界面和输入捕获
- 视频/音频解码和播放
- 录制和其他功能
服务器（在Android上）负责
- 屏幕/摄像头捕获
- 音频捕获
- 视频/音频编码
- 处理控制消息
通信通过以下方式进行
- 视频流套接字
- 音频流套接字
- 控制消息套接字

这种关注点分离允许高效的资源利用，并支持广泛的功能，同时在不同平台上保持良好的性能。