escrcpy 视频参数完全指南从尺寸码率到方向裁剪的 scrcpy 视频链路调优【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy导读scrcpy 镜像链路的视频参数直接决定了投屏的分辨率、流畅度、延迟与编码开销。本文以 escrcpy基于 scrcpy 的 Android 图形化投屏工具为背景系统梳理 scrcpy 视频链路的全部核心参数——从视频源选择、--max-size、码率、帧率、编解码器与编码器到方向、角度、裁剪、多显示、缓冲与播放控制并对照 escrcpy 的偏好模型源码与 scrcpy 中间件实现讲清每个参数在命令行和图形界面中的落点。读完本文你将能按场景低延迟游戏、高画质录屏、摄像头采集、V4L2 虚拟摄像头输出组合出正确的视频参数并能在 escrcpy 的视频偏好面板中定位到对应设置项。视频源Source屏幕镜像还是摄像头采集默认情况下scrcpy 镜像的是 Android 设备屏幕。视频链路的源头既可以是 display屏幕也可以是设备摄像头camera。# 默认镜像设备屏幕 scrcpy # 显式指定视频源为屏幕 scrcpy --video-sourcedisplay # 改用摄像头作为视频源 scrcpy --video-sourcecamera摄像头采集的完整能力--camera-id、分辨率、fps、zoom 等在专门的 camera 页面展开本文聚焦屏幕镜像这条主链路。在 escrcpy 中视频源对应 video 偏好模型 中的videoSource字段其选项就是display与camera。escrcpy 的摄像头录屏动作会通过 useRecordAction 自动追加--video-sourcecamera参数因此摄像头采集在图形界面中体现为摄像头录屏这一独立入口。尺寸Size用 --max-size 限制最大分辨率默认情况下scrcpy 尝试以 Android 设备的原始分辨率进行镜像。降低分辨率可以显著减轻编码与传输压力、提升流畅度适合性能较弱的设备或带宽受限的网络scrcpy --max-size1024 scrcpy -m 1024 # 短选项写法注意--max-size限制的是宽与高两个维度的最大值另一个维度会按设备原始宽高比自动计算因此 1920×1080 的设备以--max-size1024镜像时会得到 1024×576。两个值得注意的行为编码失败自动降级如果当前分辨率下编码失败scrcpy 会自动以更低分辨率重试除非显式传入--no-downsize-on-error禁用该行为。摄像头模式下语义不同对摄像头镜像而言--max-size不再是缩放后的目标尺寸而是在摄像头支持的可用分辨率中选择视频源尺寸。从 escrcpy 的 camera 解析器 可以看到摄像头信息会解析出每个camera-id对应的分辨率与 fps 列表--max-size正是在这些候选中做源尺寸选择。码率Bit rate默认 8 Mbps视频码率决定压缩质量与网络/存储开销之间的平衡。默认视频码率为8 Mbps可通过--video-bit-rate修改scrcpy --video-bit-rate2M scrcpy --video-bit-rate2000000 # 与上一条等价 scrcpy -b 2M # 短选项写法在 escrcpy 中该参数对应 video 偏好模型 的videoBitRate字段--video-bit-rateInput 输入框单位为 bps。码率值越大画面越清晰、但占用带宽越高在局域网内追求画质可以调高在公网或弱网环境则应适当下调。帧率Frame rate限制与统计可以通过--max-fps限制采集帧率常用于降低编码开销或适配网络带宽scrcpy --max-fps15实际采集帧率可以通过scrcpy --print-fps打印到控制台运行时也可以随时用快捷键MODi开关帧率显示快捷键体系见 shortcuts帧率本质上是变量的只有当屏幕内容发生变化时才会产生新帧。例如设备上播放 24fps 的全屏视频时scrcpy 中不会出现超过每秒 24 帧的画面。escrcpy 的 video 偏好模型 提供了maxFps字段--max-fpsInputNumber单位 fps在视频偏好面板中可直接配置。编解码器Codech264 / h265 / av1视频编码格式可通过--video-codec选择可选值为h264默认、h265、av1scrcpy --video-codech264 # 默认 scrcpy --video-codech265 scrcpy --video-codecav1选型建议H265同码率下画质更好适合追求画质/码率比的场景H264延迟更低硬件兼容性最好是低延迟场景的默认选择AV1当前 Android 设备上编码器并不普及选择需谨慎。对于高级用法可通过--video-codec-options向 Android 的 [MediaFormat] 传递任意参数具体可查阅scrcpy --help或 manpage。在 escrcpy 中--video-codec被封装为视频编码器组合选择器见 video 偏好模型 的videoCode字段内置了h264 OMX.qcom.video.encoder.avc、h264 c2.android.avc.encoder、h265 OMX.qcom.video.encoder.hevc等常用编解码器 具体编码器组合用户选择后会同时拆分为--video-codec与--video-encoder两个参数写入偏好见 select-video-codec。编码器Encoder列出并切换设备端编码器Android 设备上可能同时存在多个可用的编码器可以用--list-encoders列出scrcpy --list-encoders当默认编码器出现问题甚至崩溃时可以显式指定其他编码器scrcpy --video-codech264 --video-encoderOMX.qcom.video.encoder.avcescrcpy 的 scrcpy 中间件desktop/electron/middleware/scrcpy/index.js实现了getEncoders()内部正是执行scrcpy --serialserial --list-encoders再用 parseScrcpyCodecList 解析输出中的--video-codecxxx --video-encoderxxx行得到{ video: [...], audio: [...] }结构化列表。在偏好面板中选择视频编码器时select-video-codec 会实时调用该接口拉取当前设备真实可用的编码器组合作为下拉选项——这就是图形界面中编码器列表来自真机的实现原理。方向Orientation三级旋转体系方向处理分三个层次各管一段快捷键请求MODr请求设备切换横竖屏当前运行的 App 若不支持该方向可能拒绝--capture-orientation改变镜像方向作用于设备端发送到电脑的视频流因此会影响录屏--orientation在客户端应用影响显示与录屏显示方向可通过快捷键动态切换。采集侧方向--capture-orientationscrcpy --capture-orientation0 scrcpy --capture-orientation90 # 顺时针 90° scrcpy --capture-orientation180 # 180° scrcpy --capture-orientation270 # 顺时针 270° scrcpy --capture-orientationflip0 # 水平翻转 scrcpy --capture-orientationflip90 # 水平翻转 顺时针 90° scrcpy --capture-orientationflip180 # 水平翻转 180° scrcpy --capture-orientationflip270 # 水平翻转 顺时针 270°采集方向可以用锁定使物理设备的旋转不再改变采集视频的方向scrcpy --capture-orientation # 锁定为初始方向 scrcpy --capture-orientation0 # 锁定为 0° scrcpy --capture-orientation90 # 锁定为顺时针 90° scrcpy --capture-orientation180 # 锁定为 180° scrcpy --capture-orientation270 # 锁定为顺时针 270° scrcpy --capture-orientationflip0 # 锁定为水平翻转 scrcpy --capture-orientationflip90 # 锁定为水平翻转 顺时针 90° scrcpy --capture-orientationflip180 # 锁定为水平翻转 180° scrcpy --capture-orientationflip270 # 锁定为水平翻转 顺时针 270°客户端方向--orientationscrcpy --orientation0 scrcpy --orientation90 # 顺时针 90° scrcpy --orientation180 # 180° scrcpy --orientation270 # 顺时针 270° scrcpy --orientationflip0 # 水平翻转 scrcpy --orientationflip90 # 水平翻转 顺时针 90° scrcpy --orientationflip180 # 垂直翻转水平翻转 180° scrcpy --orientationflip270 # 水平翻转 顺时针 270°方向可以针对显示与录屏分别设置即--display-orientation与--record-orientation# 显示保持原始方向录屏旋转 90° scrcpy --display-orientation0 --record-orientation90需要特别注意的是录屏文件的方向是通过向 MP4/MKV 目标文件写入显示变换信息display transformation实现的而翻转flip操作不被容器支持因此录制时只允许 4 个前值0/90/180/270。在 escrcpy 中显示方向对应 video 偏好模型 的displayOrientation字段--display-orientationSelect含 0°/90°/180°/270° 与 flip0~flip270录屏方向则对应 record 偏好模型 的recordOrientation字段--record-orientationSelect仅 4 个非翻转值——与录制仅支持旋转、不支持翻转的限制完全一致。变换顺序视频链路上的变换顺序为--crop→--capture-orientation→--angle。角度Angle任意角度旋转除 90° 整倍数外还可以用--angle按顺时针方向旋转任意角度scrcpy --angle23旋转中心为可视区域的中心。该变换在--crop与--capture-orientation之后应用。escrcpy 的 video 偏好模型 提供了angle字段--angleInputNumber单位 deg可在偏好面板中直接填写任意角度。裁剪Crop只镜像屏幕的一部分--crop可以裁剪屏幕只镜像其中一部分。典型场景如只镜像 Oculus Go 的单眼画面scrcpy --crop1224:1440:0:0 # 1224x1440起点偏移 (0,0)参数格式为宽:高:x偏移:y偏移且以设备的自然方向为坐标基准手机为竖屏方向平板为横屏方向。裁剪在--capture-orientation与--angle之前执行。关于与--max-size的配合顺序屏幕镜像--max-size在裁剪之后应用先裁后缩放摄像头--max-size在裁剪之前生效因为它是选择源尺寸而非缩放内容。escrcpy 的 video 偏好模型 提供了crop字段--cropInput可直接填写裁剪矩形。多显示Display选择要镜像的显示器如果 Android 设备存在多个显示输出可以指定镜像哪一个scrcpy --display-id1可用显示 ID 列表通过以下命令获取scrcpy --list-displays两个限制条件副屏控制需要 Android 10若设备系统低于 Android 10副屏只能以只读方式镜像无法交互控制也可以通过 virtual_display 创建虚拟显示。escrcpy 通过 scrcpy 中间件的 getDisplayIds() 执行scrcpy --serialserial --list-displays并由 parseDisplayIds 用正则/--display-id(\d)/g提取并去重排序所有显示 ID偏好模型中的displayId字段video 偏好模型即为--display-id使用支持动态加载真机显示列表的DisplaySelect组件。缓冲Buffering以延迟换平滑默认情况下 scrcpy不进行视频缓冲以追求最低延迟。缓冲的引入会延迟视频流以补偿网络抖动jitter换取更平滑的播放体验。配置项对显示、V4L2 sink 与音频播放相互独立scrcpy --video-buffer50 # 视频播放增加 50ms 缓冲 scrcpy --audio-buffer200 # 音频播放设置 200ms 缓冲 scrcpy --v4l2-buffer300 # v4l2 sink 增加 300ms 缓冲也可以同时应用多个缓冲scrcpy --video-buffer50 --v4l2-buffer300音频缓冲细节见 audio 文档的 Buffering 一节V4L2 缓冲细节见 v4l2 文档。escrcpy 的 video 偏好模型 提供了videoBuffer--video-buffer单位 ms与v4l2Buffer--v4l2-buffer单位 ms两个字段音频缓冲则由音频偏好模型管理。无播放No playback只采集不播放在只录屏或启用 V4L2 输出时常常不需要在电脑上播放音视频scrcpy --v4l2-sink/dev/video2 --no-playback scrcpy --recordfile.mkv --no-playback # 用 CtrlC 中断也可以分别禁用视频与音频播放# 视频送 V4L2 sink 但不播放同时保留音频播放 scrcpy --v4l2-sink/dev/video2 --no-video-playback # 同时录制音视频但只播放视频 scrcpy --recordfile.mkv --no-audio-playbackescrcpy 的 record 偏好模型 提供了noVideoPlayback--no-video-playbackSwitch与noAudioPlayback--no-audio-playbackSwitch两个开关对应录屏场景下的只录不播需求。无视频No video仅转发音频彻底关闭视频转发、只保留音频通道scrcpy --no-video典型用途包括纯音频录屏--no-video --recordfile.opus、辅助命令执行等。escrcpy 的 video 偏好模型 提供了noVideo字段--no-videoSwitch值得注意的是scrcpy 中间件的helper()方法desktop/electron/middleware/scrcpy/index.js在后台执行应用列表等辅助命令时会强制附带--no-window --no-video --no-audio以完全静默地完成设备端查询。Video4Linux把视频导出为虚拟摄像头如果需要把 Android 画面导出为 Linux 下的 V4L2 虚拟摄像头设备请参阅专门的 Video4Linux 文档其中包含--v4l2-sink与--v4l2-buffer的完整用法。在 escrcpy 中管理这些参数从界面到命令行理解上述参数后在 escrcpy 中管理视频配置遵循一条清晰的链路偏好模型即参数字典desktop/src/models/preference/video/index.js 把每个参数声明为字段field就是 scrcpy 命令行参数本身如--max-size、--video-bit-ratetype决定界面控件InputNumber / Select / Switch / 自定义组件。全局与设备级作用域偏好数据按global与设备维度存储读取时通过 mergePreferenceConfig 将设备级配置与全局配置合并未设置的字段回退到全局默认值scrcpyParameter 在生成命令行时过滤掉null/undefined//false等未设置值与开关关闭项。进程实际执行生成的参数字符串最终交给 createScrcpyProcess以scrcpy --serialserial --window-titletitle args的形式经 shell 启动镜像或录屏进程并通过--record实现录屏、通过 readyPattern 等待 scrcpy 就绪。追加自定义参数偏好面板的通用分组中还有scrcpyAppend字段common 偏好模型允许向每次生成的 scrcpy 命令尾部追加任意自定义参数如--video-codec-options...用于覆盖模型尚未覆盖的高级选项。总结scrcpy 视频链路的核心调优点可以归纳为一张速查表目标参数典型值降低分辨率提升性能--max-size/-m1024控制码率--video-bit-rate/-b2M、8M限制采集帧率--max-fps15切换编码格式--video-codech264/h265/av1更换具体编码器--video-encoderOMX.qcom.video.encoder.avc采集侧旋转/翻转--capture-orientation90、90、flip0客户端旋转/翻转--orientation180、flip90任意角度旋转--angle23裁剪局部画面--crop1224:1440:0:0选择副屏镜像--display-id1增加缓冲换取平滑--video-buffer/--audio-buffer/--v4l2-buffer50/200/300ms只采集不播放--no-playback/--no-video-playback/--no-audio-playback—仅转发音频--no-video—这些参数既可全部在命令行直接使用也可以在 escrcpy 的偏好设置中以图形化方式配置二者共用同一套参数语义。结合本文梳理的变换顺序--crop→--capture-orientation→--angle与录制不支持翻转等边界约束即可按需搭建出低延迟、高画质或纯录制的视频链路方案。【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考