mirror of
https://github.com/viarotel-org/escrcpy.git
synced 2025-01-31 11:53:50 +01:00
docs: 📝 fix
This commit is contained in:
viarotel
parent
e4f137db0a
commit
218f85113d
158
README.md
158
README.md
@ -1,18 +1,154 @@
|
||||
# Vue 3 + TypeScript + Vite
|
||||
# Escrcpy
|
||||
|
||||
This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
|
||||
📱 使用图形界面的 Scrcpy 显示和控制您的 Android 设备，由 Electron 驱动
|
||||
|
||||
## Recommended IDE Setup
|
||||
📱 Use Scrcpy with a graphical interface to display and control your Android device, driven by Electron
|
||||
|
||||
- [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin).
|
||||
<div style="display:flex;">
|
||||
<img src="https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/570065a5683b4cf7af9cfa9743c06ab4~tplv-k3u1fbpfcp-jj-mark:0:0:0:0:q75.image#?w=1360&h=693&s=140693&e=jpg&b=ffffff" alt="viarotel-escrcpy" style="width: 100%;">
|
||||
</div>
|
||||
|
||||
## Type Support For `.vue` Imports in TS
|
||||
## 特点
|
||||
|
||||
TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin) to make the TypeScript language service aware of `.vue` types.
|
||||
- 🏃 同步：得益于 Web 技术，将更快速的与 Scrcpy 保持同步
|
||||
- 😎 轻巧度：本机支持，仅显示设备屏幕
|
||||
- ⚡️ 性能：30~120 帧每秒，取决于设备
|
||||
- 🌟 质量：1920×1080 或更高
|
||||
- 🕒 低延迟：35~70 毫秒
|
||||
- 🚀 快速启动：显示第一张图片仅需约1秒钟
|
||||
- 🙅♂️ 非侵入性：不会在安卓设备上留下任何安装文件
|
||||
- 🤩 用户收益：无需账户、无广告、无需互联网连接
|
||||
- 🗽 自由：免费且开源软件
|
||||
|
||||
If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a [Take Over Mode](https://github.com/johnsoncodehk/volar/discussions/471#discussioncomment-1361669) that is more performant. You can enable it by the following steps:
|
||||
## 获取软件包
|
||||
|
||||
1. Disable the built-in TypeScript Extension
|
||||
1. Run `Extensions: Show Built-in Extensions` from VSCode's command palette
|
||||
2. Find `TypeScript and JavaScript Language Features`, right click and select `Disable (Workspace)`
|
||||
2. Reload the VSCode window by running `Developer: Reload Window` from the command palette.
|
||||
[查看发布地址](https://github.com/viarotel-org/escrcpy/releases)
|
||||
|
||||
## 快速上手
|
||||
|
||||
### USB 连接
|
||||
|
||||
> 注意：如果手机上提示调试授权请点击允许
|
||||
|
||||
1. 安卓手机需开启开发者模式并打开 USB 调试
|
||||
2. 打开 Escrcpy 并将安卓手机连接到你的电脑
|
||||
3. 这时 Escrcpy 设备列表应该已经检测到你的手机，点击开始镜像
|
||||
4. 开始享受吧
|
||||
|
||||
### WIFI 连接
|
||||
|
||||
> 注意：如果首次无线连接失败，你可能需要无线配对请参阅 [常见问题](#常见问题)
|
||||
>
|
||||
> 注意：需同时开启无线调试功能，并在无线调试页面中获取你的当前设备的无线地址（通常为你连接WIFI时分配的IP地址）及端口号（默认为 5555）
|
||||
|
||||
1. 同 USB 连接中的 1-2 步骤
|
||||
2. 将获取到的设备 IP 地址及端口号填写到 Escrcpy 中，然后点击连接设备
|
||||
3. 这时 Escrcpy 设备列表应该已经检测到你的手机，点击开始镜像
|
||||
4. 开始享受吧
|
||||
|
||||
## 快捷键
|
||||
|
||||
请参阅 [scrcpy/doc/shortcuts](https://github.com/Genymobile/scrcpy/blob/master/doc/shortcuts.md)
|
||||
|
||||
## 高级配置
|
||||
|
||||
> 持续完善中 目前支持 Scrcpy 中以下常用配置
|
||||
|
||||
### 显示配置
|
||||
|
||||
- 分辨率
|
||||
- 比特率
|
||||
- 刷新率
|
||||
- 屏幕旋转
|
||||
- 视频解码器
|
||||
- 视频编码器
|
||||
|
||||
### 设备控制
|
||||
|
||||
- 保持设备清醒
|
||||
- 连接设备后自动关闭屏幕
|
||||
|
||||
### 音频控制
|
||||
|
||||
- 镜像时禁用音频
|
||||
|
||||
### 窗口控制
|
||||
|
||||
- 无边框模式
|
||||
- 全屏幕模式
|
||||
|
||||
## 下一步做什么？
|
||||
|
||||
> 优先级从高到低
|
||||
|
||||
1. 用户界面进行优化，制作合适的 Logo ✅
|
||||
2. 内置的软件更新功能 ✅
|
||||
3. 录制和保存音视频 ✅
|
||||
4. 添加设备快捷交互控制栏 ✅
|
||||
5. 支持自定义 Adb 及 Scrcpy 依赖，并支持生成精简版本和完整版本以满足不同用户需求
|
||||
6. 添加 macOS 及 linux 操作系统的支持 🚧
|
||||
7. 支持语言国际化功能 🚧
|
||||
8. 添加对游戏的增强功能，如游戏键位映射 🚧
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 电脑连接设备后无法检测到
|
||||
|
||||
1. 请重新插拔你的设备，并确认设备同意了 USB 调试授权窗口。
|
||||
2. 如果还不行，你的电脑可能缺少必要的驱动程序，请使用第三方工具 如：驱动精灵，安装必要的驱动后重试。
|
||||
|
||||
### 无法输入中文
|
||||
|
||||
该问题是已知的， Scrcpy 似乎并未直接对中文输入进行测试和支持 需要在手机端安装第三方输入法 以下输入法经测试可以很好支持
|
||||
|
||||
- 搜狗输入法
|
||||
- QQ输入法
|
||||
- 谷歌拼音输入法
|
||||
- Gboard
|
||||
|
||||
### 没有控制栏，无法通过点击返回上一步及桌面问题
|
||||
|
||||
> 后期会增加支持 目前可以使用以下方法
|
||||
|
||||
1. 在高级设置中开启 设备控制 => 虚拟控制栏 （如果该配置不起作用则需要在设备上手动开启）
|
||||
2. 通过快捷键，请参阅 [scrcpy/doc/shortcuts](https://github.com/Genymobile/scrcpy/blob/master/doc/shortcuts.md)
|
||||
|
||||
### 无线连接提示： 目标计算机积极拒绝访问
|
||||
|
||||
第一次无线连接可能需要配对 或 插入USB 以保证与电脑建立连接即授权成功后方可使用
|
||||
|
||||
### 通过数据线连接后点击无线模式没有反应
|
||||
|
||||
请再点一次，或点击刷新设备，一般不会超过两次，如果还不行，请提供机型和安卓版本信息到 [Issues](https://github.com/viarotel-org/escrcpy/issues)
|
||||
|
||||
### 设备交互控制栏为什么不设计为自动跟踪吸附的悬浮菜单?
|
||||
|
||||
采用悬浮菜单方案不可避免地会增加对 Scrcpy 的耦合性，并增加与 Scrcpy 同步更新的难度。许多类似的 ScrcpyGUI 软件在使用此方案后不得不投入大量精力，最终因难以维护而放弃开发。因此，综合考虑，我们决定采用现有的方案，并期待 Scrcpy 未来能够增加原生交互控制栏的支持。
|
||||
|
||||
## 获得帮助
|
||||
|
||||
> 因为是开源项目 全靠爱发电 所以支持有限 更新节奏不固定
|
||||
>
|
||||
> 注意：非 BUG 或计划外的需求，有偿处理；至于金额，根据问题难易程度，你觉得帮助了多少，看着给吧（维护这些项目已经耗费了大量精力，还要免费花时间解答问题就说不过去了吧...所以白嫖的一律不通过。）
|
||||
|
||||
- issues: [反馈问题](https://github.com/viarotel-org/escrcpy/issues)
|
||||
- email: viarotel@qq.com
|
||||
- weixin: viarotel
|
||||
- qq: 523469508
|
||||
|
||||
## 致谢
|
||||
|
||||
该项目的诞生离不开以下开源项目
|
||||
|
||||
- [scrcpy](https://github.com/Genymobile/scrcpy)
|
||||
- [adbkit](https://github.com/DeviceFarmer/adbkit)
|
||||
- [electron](https://www.electronjs.org/)
|
||||
|
||||
## 支持项目
|
||||
|
||||
> 如果该项目帮到你的话，可以请我吃包辣条，可以使我更有动力完善该项目
|
||||
|
||||
<div style="display:flex;">
|
||||
<img src="https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/79dcbc40246743e2b6870419e88e0392~tplv-k3u1fbpfcp-watermark.image?" alt="viarotel-wepay" style="width: 36%;">
|
||||
<img src="https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/1e5e69b83dd746deade95afd4a6864ec~tplv-k3u1fbpfcp-watermark.image?" alt="viarotel-alipay" style="width: 36%;">
|
||||
</div>
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user