Escrcpy 偏好设置完全指南从通用配置到设备、音频与摄像的 scrcpy 参数详解【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpyEscrcpy 是一款基于 scrcpy 的 Android 图形化投屏与控制桌面应用而「偏好设置」正是驱动整个应用与底层 scrcpy 命令行协同工作的核心配置面板。本篇指南以 docs/zhHans/guide/preferences.md 为骨架逐项讲解通用、视频、设备、窗口、音频、录制、输入与摄像八大类配置的实际含义并结合仓库中的偏好模型源码desktop/src/models/preference/还原每一项在底层对应的 scrcpy 命令行参数、默认值与可选项。读完本文你将能根据实际场景精准配置 Escrcpy并理解每一项设置最终如何转化为 scrcpy 的启动参数。偏好设置的结构与工作方式在 Escrcpy 中偏好设置并非孤立的表单而是一套完整的「配置声明 → 表单渲染 → 持久化 → 参数组装」链路配置声明desktop/src/models/preference/目录下按common通用、video视频、device设备、window窗口、audio音频、record录制、input输入、camera摄像、launch启动等模块拆分由 preference/index.js 统一汇总。每个配置项都带有labeli18n 文案键、field对应的 scrcpy 命令行参数、type渲染组件类型、value默认值等元信息。表单渲染配置页 preference/index.vue 通过 preference-form/index.vue 按type动态渲染Select、Switch、InputNumber、Input、PathInput、ColorPicker以及专用的VideoCodecSelect、AudioCodecSelect、DisplaySelect等组件组件清单见 preference-form/components因此新增配置项只需声明模型无需改表单代码。持久化与作用域设置通过 store/preference 管理配合 scope-select 区分全局作用域与设备作用域部分参数可针对单台设备覆盖。参数组装配置项中field字段本身就是 scrcpy 的命令行参数名如--max-size、--video-bit-rate最终由 middleware/scrcpy 组装进 scrcpy 启动命令。这也解释了为什么下面几乎所有小节都能精确到「某个界面开关 某个 scrcpy 参数」。通用配置General通用配置定义应用本身的运行方式模型定义见 preference/common/index.js配置项类型默认值 / 可选值说明主题风格themeSelectsystem可选light/dark/system跟随系统时为system语言选择languageSelect当前系统语言可选zh-CN、zh-TW、ja-JP、en-US、ru-RU、ar应用关闭行为appCloseCodeSelect-1-1询问、0退出、1最小化到托盘文件存储路径savePathPathInput桌面目录目录选择器openDirectory用于存放截图、录屏等文件ADB 路径adbPathPathInput内置默认路径通过getDefaultAdbPath()自动探测可手动指定 adb 可执行文件Scrcpy 路径scrcpyPathPathInput内置默认路径通过getDefaultScrcpyPath()自动探测Gnirehtet 路径gnirehtetPathPathInput内置默认路径通过getDefaultGnirehtetPath()自动探测Scrcpy 参数scrcpyAppendInput多行空以自由文本形式向 scrcpy 追加任意自定义参数适合界面未覆盖的高级选项Gnirehtet 参数gnirehtetAppendInput多行空同上追加给 gnirehtet 的额外参数环境变量environmentVariablesInput多行空为子进程注入自定义环境变量自动连接设备autoConnectSwitchtrue启动后自动尝试连接已发现的设备自动执行镜像autoMirrorSwitch关闭连接设备后自动开始投屏镜像Gnirehtet 修复gnirehtetFixSwitch关闭对 gnirehtet 反向后缀问题进行修复调试模式debugSwitch关闭开启后输出更详细的调试日志便于排查问题悬浮控制栏floatControlSwitch关闭在设备画面外层叠加悬浮控制按钮边栏隐藏edgeHiddenSwitch关闭窗口边缘悬停隐藏/呼出相关行为源码中带有 tips 提示开机自启autoLaunchSwitch关闭应用随系统登录自动启动并发上限concurrencyLimitInputNumber5取值范围 1100限制同时进行的镜像/操作任务数量此外文档还列出了「使用系统终端」与「首选终端」两项它们与项目的终端模块terminal 页面 及 electron/modules/terminal联动控制命令执行时是调用应用内置终端还是系统外部终端。视频Video Control视频类配置直接映射到 scrcpy 的视频相关参数模型定义见 preference/video/index.js界面项对应参数类型说明禁用视频传输--no-videoSwitch只传输音频/控制通道不传输视频流值为false时不附加该参数最大分辨率--max-sizeInputNumber限制传输画面的最长边像素值越小越省带宽视频比特率--video-bit-rateInput单位bps控制视频码率刷新频率--max-fpsInputNumber单位fps限制采集帧率上限视频编解码器--video-codeVideoCodecSelect预置「编码器 解码器」组合如h264 OMX.qcom.video.encoder.avc、h264 c2.android.avc.encoder、h265 OMX.qcom.video.encoder.hevc等高通的 OMX 编码器与通用 C2 编码器均可选显示方向--display-orientationSelect可选0°、90°、180°、270°及flip-0°、flip-90°、flip-180°、flip-270°翻转方向旋转角度--angleInputNumber单位deg对画面做额外角度旋转源码中带 tips 说明屏幕裁剪--cropInput按宽:高:x:y格式裁剪设备画面显示器选择--display-idDisplaySelect多屏设备指定显示器编号可过滤/手动输入视频缓冲区--video-bufferInputNumber单位ms视频解码缓冲时长值越大越流畅但延迟越高接收端v4l2缓冲区--v4l2-bufferInputNumber单位msLinux v4l2 接收端缓冲时长值得说明的是模型中还隐藏了--video-sourcedisplay/camera、--video-codec、--video-encoder等进阶字段hidden: true它们由「视频编解码器」这类定制组件在后台拆分处理或为未来版本保留界面暂不直接暴露。设备Device设备类配置控制 Android 设备端的电源与显示行为模型定义见 preference/device/index.js界面项对应参数说明显示触摸点--show-touches在设备画面中显示触摸位置指示点保持唤醒状态--stay-awake投屏期间阻止设备休眠控制时关闭屏幕--turn-screen-off开始投屏后立即关闭设备屏幕控制结束后关闭屏幕--power-off-on-close退出投屏时关闭设备屏幕禁用控制时自动亮屏--no-power-on投屏过程中不自动点亮设备屏幕屏幕关闭超时--screen-off-timeoutInputNumber单位s控制屏幕自动关闭的超时时间保持活跃--keep-active维持设备处于活跃状态避免连接被系统回收关于「模拟辅助显示器」它对应设备显示器管理能力与 utils/device/display 模块相关用于在多显示器或虚拟显示器场景下模拟辅助屏具体行为以设备与 scrcpy 版本支持为准。窗口Window窗口类配置控制投屏窗口的尺寸、位置与显示样式模型定义见 preference/window/index.js界面项对应参数说明窗口宽度--window-widthInputNumber模型中hidden: true主要交由窗口排布功能管理窗口高度--window-height同上窗口 X 坐标--window-x同上窗口 Y 坐标--window-y同上无边框模式--window-borderless去掉系统窗口边框全屏模式--fullscreen以全屏方式启动投屏窗口窗口置顶--always-on-top窗口始终保持在最上层禁用屏幕保护--disable-screensaver投屏期间阻止宿主机屏保/休眠窗口背景色--background-colorColorPicker 颜色选择器设置窗口底色模型源码中四个尺寸/坐标字段均为hidden: true这是因为 Escrcpy 提供了更强大的可视化窗口排布功能多窗口网格、自动排布、布局保存详见 docs/zhHans/guide/window-arrangement.md这也是实际控制窗口位置的主要入口。音频Audio音频类配置映射 scrcpy 音频相关参数模型定义见 preference/audio/index.js界面项对应参数说明禁用音频传输--no-audio不传输设备音频保留设备音频--audio-dup音频在投屏到电脑的同时设备扬声器继续发声不静音设备音频源选择--audio-source下拉选项非常完整default、playback、mic、mic-unprocessed、mic-camcorder、mic-voice-recognition、mic-voice-communication、voice-call、voice-call-uplink、voice-call-downlink、voice-performance覆盖录音、通话上下行等 Android 音频源音频编解码器--audio-codeAudioCodecSelect预置opus c2.android.opus.encoder、aac c2.android.aac.encoder、aac OMX.google.aac.encoder及raw原始音频音频比特率--audio-bit-rateInput单位bps音频缓冲区--audio-bufferInputNumber单位ms音频输出缓冲区--audio-output-bufferInputNumber单位ms宿主机播放侧缓冲与视频类似模型中还隐藏了--audio-codec、--audio-encoder两个拆分字段用于在定制音频编解码器选择时分别下发编解码器与编码器。录制Recording录制配置用于控制录屏行为模型定义见 preference/record/index.js包含录制视频格式选择录制的容器格式如 mp4/mkv录制视频方向录制流的画面方向可与播放方向解耦录制时长设定自动停止录制的时长上限禁用视频回放录制时不在本地实时预览禁用音频回放录制时不在本地播放音频。这组配置与 scrcpy 的录制参数一一对应详细的录制参数语义格式、时长、回放开关可参考仓库中的 scrcpy 录制参考文档。输入Input输入类配置控制鼠标、键盘与游戏手柄在投屏画面中的注入方式模型定义见 preference/input/index.js鼠标模式选择鼠标事件注入为触摸还是遥控器如 disabled / 触控 / 遥控两种模式鼠标绑定自定义鼠标按键与 Android 操作的绑定关系键盘模式选择键盘注入方式SDK / AOA / UHID 等键盘注入方式决定按键事件在按下、抬起还是询问时注入对应 preference-form 的 select-keyboard-inject 组件游戏手柄设置启用/配置游戏手柄事件注入。每种输入方式的原理与限制可分别参考 鼠标、键盘 与 游戏手柄 参考文档。摄像Camera摄像类配置用于将 Android 设备摄像头作为视频源进行投屏模型定义见 preference/camera/index.js摄像头源选择选择前摄 / 后摄 / 外接摄像头摄像头尺寸设置摄像头采集分辨率摄像头比例设置画面宽高比如 4:3、16:9摄像头帧率设置采集帧率上限对应 preference-form 的 select-camera-fps 组件配套的缩放相关组件见 slider-camera-zoom。摄像头投屏需要设备与 scrcpy 版本支持详细约束可参考 摄像头参考文档。配置的生效、持久化与进阶使用参数优先级界面配置项、scrcpyAppend自定义参数与环境变量最终都会汇入 scrcpy 启动命令组装逻辑位于 electron/middleware/scrcpy。当某项未设置时模型中的value: undefined表示「不附加该参数」从而交给 scrcpy 使用其内置默认值unset: [false]则表示布尔开关在关闭时干脆不传参避免覆盖 scrcpy 默认行为。作用域覆盖借助 scope-select部分配置可以按「全局 / 单设备」分级生效适合为不同设备保存不同参数组合。与窗口排布协同窗口的宽高与坐标虽已内置为 scrcpy 参数但 Escrcpy 推荐使用可视化排布见 window-arrangement.md来管理多窗口布局设置页保留底层参数以便需要精确控制的场景。小结正如文档开头标注的「持续完善中」Escrcpy 的偏好设置随着 scrcpy 能力演进不断扩充但整体设计保持了一致性每一个界面配置项都对应一个明确的 scrcpy 命令行参数。借助 preference 模型目录 这份「参数字典」你可以快速反查任意设置项底层的真实参数与默认值也可以在scrcpyAppend中直接写入界面未覆盖的高级参数实现界面之外的精细化调优。本指南所覆盖的八类配置已完整承接 preferences.md 的全部条目并补充了源码级的参数映射与默认值可作为日常配置与二次开发的双向参考。【免费下载链接】escrcpy Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考