firemail
标题: QtScrcpy [打印本页]
作者: Qter 时间: 2020-10-1 23:35
标题: QtScrcpy
Android实时投屏
文章目录
[url=][/url]
一、项目信息项目名称:QtScrcpy
项目简介:Android实时投屏软件,此应用程序提供USB(或通过TCP/IP)连接的Android设备的显示和控制。它不需要任何root访问权限
项目作者:Barryda
开发语言:C++ Qt Widgets
开源许可协议:Apache-2.0
关于开源协议:Apache-2.0
BSD、Apache 2.0 相对GPL/LGPL的开放源代码,BSD,Apache 2.0就宽松许多——商业软件可以任意的使用BSD,Apache 2.0发布的软件代码,而不需要开放源代码,只需要提及代码的原出处就可以了。BSD和Apache 2.0提及的方式稍有不同
二、项目详细介绍QtScrcpy可以通过USB(或通过TCP/IP)连接Android设备,并进行显示和控制。不需要root权限。
单个应用程序最多支持16个安卓设备同时连接。
同时支持GNU/Linux,Windows和MacOS三大主流桌面平台
它专注于:
- 精致 (仅显示设备屏幕)
- 性能 (30~60fps)
- 质量 (1920×1080以上)
- 低延迟 (35~70ms)
- 快速启动 (1s内就可以看到第一帧图像)
- 非侵入性 (不在设备上安装任何软件)
windows上运行
windows上运行
mac上运行
mac上运行
ubuntu上运行
ubuntu上运行
2.1 自定义按键映射(仅windows&MacOS平台开启)可以根据需要,自己编写脚本将PC键盘按键映射为手机的触摸点击,编写规则在这里。 默认自带了针对和平精英手游和抖音进行键鼠映射的映射脚本,开启平精英手游后可以用键鼠像玩端游一样玩和平精英手游,开启抖音映射以后可以使用上下左右方向键模拟上下左右滑动,你也可以按照编写规则编写其他游戏的映射文件,默认按键映射如下: 针对和平精英手游和抖音进行键鼠映射
自定义按键映射操作方法如下:
- 编写自定义脚本放入keymap目录
- 点击刷新脚本,确保脚本可以被检测到
- 选择需要的脚本
- 连接手机并启动服务之后,点击应用脚本
- 按~键(数字键1左边)切换为自定义映射模式即可体验(具体按什么键要看你按键脚本定义的switchKey)
- 再次按~键切换为正常控制模式
- 要想wasd控制开车记得在载具设置中设置为单摇杆模式
2.2 群控你可以同时控制所有的手机
群控
2.3 感谢关键点scrcpyQtScrcpy
界面sdlqt
视频解码ffmpegffmpeg
视频渲染sdlopengl
跨平台基础设施自己封装Qt提供
编程语言CC++
编程方式同步异步
按键映射不支持自定义支持自定义按键映射
编译方式meson+gradleQt Creator- 使用Qt可以非常容易的定制自己的界面
- 基于Qt的信号槽机制的异步编程提高性能
- 方便新手学习
- 增加多点触控支持
2.4 学习它如果你对它感兴趣,想学习它的实现原理而又感觉无从下手,可以选择购买我录制的视频课程, 里面详细介绍了整个软件的开发架构以及开发流程,带你从无到有的开发QtScrcpy:
或者你也可以加入我的QtScrcpy QQ群,和志同道合的朋友一块互相交流技术:
QQ群号:901736468
2.5 要求Android部分至少需要API 21(Android 5.0)。
2.6 下载这个软件Windows
Windows平台,你可以直接使用我编译好的可执行程序:
Mac OS
Mac OS平台,你可以直接使用我编译好的可执行程序:
Linux
目前只提供了windows和mac平台的可执行程序,如果需要linux平台的可执行程序,
目前只在ubuntu上测试过
2.7 运行在你的电脑上接入Android设备,然后运行程序,按顺序点击如下按钮即可连接到Android设备
运行
2.7.1 无线连接步骤(保证手机和电脑在同一个局域网):- 安卓手机端在开发者选项中打开usb调试
- 通过usb连接安卓手机到电脑 3.点击刷新设备,会看到有设备号更新出来
- 点击获取设备IP
- 点击启动adbd
- 无线连接
- 再次点击刷新设备,发现多出了一个IP地址开头的设备,选择这个设备
- 启动服务
备注:启动adbd以后不用再连着usb线了,以后连接断开都不再需要,除非安卓adbd停了需要重新启动
2.7.2 界面按钮介绍:- 启动配置:启动服务前的功能参数设置 分别可以设置本地录制视频的比特率、分辨率、录制格式、录像保存路径等。
- 仅后台录制:启动服务不现实界面,只是录制Android设备屏幕
- 窗口置顶:Android设备视频窗口置顶显示
- 自动息屏:启动服务以后,自动关闭Android设备屏幕节省电量
- 使用reverse:服务启动模式,出现服务启动失败报错more than one device可以去掉这个勾选尝试连接
- 刷新设备列表:刷新当前连接的设备
- 启动服务:连接到Android设备
- 停止服务:断开与Android设备的连接
- 停止所有服务:断开所有已连接的Android设备
- 获取设备ip:获取到Android设备的ip地址,更新到“无线”区域中,方便进行无线连接
- 启动adbd:启动Android设备的adbd服务,无线连接之前,必须要启动。
- 无线连接:使用无线方式连接Android设备
- 无线断开:断开无线方式连接的Android设备
- adb命令行:方便执行自定义adb命令(目前不支持阻塞命令,例如shell)
2.7.3 主要功能- 实时显示Android设备屏幕
- 实时键鼠控制Android设备
- 屏幕录制
- 截图为png
- 无线连接
- 最多支持16台设备连接(PC性能允许的情况下可以增加,需要自己编译)
- 全屏显示
- 窗口置顶
- 安装apk:拖拽apk到视频窗口即可安装
- 传输文件:拖拽文件到视频窗口即可发送文件到Android设备
- 后台录制:只录制,不显示界面
- 复制粘贴 在计算机和设备之间双向同步剪贴板:
- Ctrl + c将设备剪贴板复制到计算机剪贴板;
- Ctrl + Shift + v将计算机剪贴板复制到设备剪贴板;
- Ctrl +v 将计算机剪贴板作为一系列文本事件发送到设备(不支持非ASCII字符)。
- 群控
2.7.4 快捷键功能快捷键(Windows)快捷键 (macOS)
切换全屏Ctrl+fCmd+f
调整窗口大小为 1:1Ctrl+gCmd+g
调整窗口大小去除黑边Ctrl+x | 左键双击Cmd+x | 左键双击
点击 主页Ctrl+h | 点击鼠标中键Ctrl+h | 点击鼠标中键
点击 BACKCtrl+b | 右键双击Cmd+b | 右键双击
点击 APP_SWITCHCtrl+sCmd+s
点击 MENUCtrl+mCtrl+m
点击 VOLUME_UPCtrl+↑ (上)Cmd+↑ (上)
点击 VOLUME_DOWNCtrl+↓ (下)Cmd+↓ (下)
点击 POWERCtrl+pCmd+p
打开电源右键双击右键双击
关闭屏幕 (保持投屏)Ctrl+oCmd+o
打开下拉菜单Ctrl+nCmd+n
关闭下拉菜单Ctrl+Shift+nCmd+Shift+n
复制设备剪切板到电脑Ctrl+cCmd+c
粘贴电脑剪切板到设备Ctrl+vCmd+v
复制电脑剪切板到设备Ctrl+Shift+vCmd+Shift+v鼠标左键双击黑色区域可以去除黑色区域
如果电源关闭,鼠标右键双击打开电源;如果电源开启,鼠标右键双击相当于返回
三、TODO四、FAQ五、开发者欢迎大家一起维护这个项目,贡献自己的代码,不过请遵循一下几点要求:
- pr请提到dev分支,不要提到master分支
- 提pr之前请先rebase dev
- pr请以少量多次的原则提交(建议一个小的功能点提一个pr)
- 代码风格请保持和已有风格一致
六、为什么开发QtScrcpy?综合起来有以下几个原因,比重从大到小排列:
- 学习Qt的过程中需要一个项目实战一下
- 本身具有音视频相关技能,对音视频很感兴趣
- 本身具有Android开发技能,好久没用有点生疏,需要巩固一下
- 发现了scrcpy,决定用新的技术栈(C++ + Qt + Opengl + ffmpeg)复刻一下
七、如何编译尽量提供了所有依赖资源,方便傻瓜式编译。
PC端- 目标平台上搭建Qt开发环境(Qt >= 5.12.0, vs >= 2017 (不支持mingw))
- 克隆该项目
- 使用QtCreator打开项目根目录all.pro
- 编译,运行即可
Android端 (没有修改需求的话直接使用自带的scrcpy-server即可)- 目标平台上搭建Android开发环境
- 使用Android Studio打开项目根目录中的server项目
- 第一次打开如果你没有对应版本的gradle会提示找不到gradle,是否升级gradle并创建,选择取消,取消后会弹出选择已有gradle的位置,同样取消即可(会自动下载)
- 按需编辑代码即可,当然也可以不编辑
- 编译出apk以后改名为scrcpy-server并替换third_party/scrcpy-server即可
八、Licence由于是复刻的scrcpy,尊重它的Licence
[size=1em][size=1em]Copyright[size=1em] [size=1em]([size=1em]C[size=1em])[size=1em] [size=1em]2020[size=1em] Barry
[size=1em]
[size=1em]Licensed under the Apache License, Version [size=1em]2.0[size=1em] [size=1em]([size=1em]the [size=1em]"License"[size=1em])[size=1em];
[size=1em]you may not use [size=1em]this[size=1em] file [size=1em]except[size=1em] [size=1em]in[size=1em] compliance with the License.
[size=1em]You may obtain a copy [size=1em]of[size=1em] the License at
[size=1em]
[size=1em] http[size=1em]://www.apache.org/licenses/LICENSE-2.0[size=1em]
[size=1em]
[size=1em]Unless required by applicable law or agreed to [size=1em]in[size=1em] writing, software
[size=1em]distributed under the License is distributed on an [size=1em]"AS IS"[size=1em] BASIS,
[size=1em]WITHOUT WARRANTIES OR CONDITIONS [size=1em]OF[size=1em] ANY KIND, either express or implied.
[size=1em]See the License [size=1em]for[size=1em] the specific language governing permissions and
[size=1em]limitations under the License.
九、关于作者一枚普通的程序员,工作中主要使用C++进行桌面客户端开发,一毕业在山东做过一年多钢铁仿真教育软件,后来转战上海先后从事安防,在线教育相关领域工作,对音视频比较熟悉,对音视频领域如语音通话,直播教育,视频会议等相关解决方案有所了解。同时具有android,linux服务器等开发经验。
作者: Qter 时间: 2020-10-1 23:37
无功能限制的开源软件Scrcpy https://github.com/Genymobile/scrcpy
Simon Ma为它开发了一个直观简单易用的图形界面——Scrcpy-GUI https://github.com/Tomotoes/scrcpy-gui
还有一个GUI,QtScrcpy也非常优秀 https://github.com/barry-ran/QtScrcpy
欢迎光临 firemail (http://firemail.wang:8088/) |
Powered by Discuz! X3 |