rPlayHub：iOS平台版scrcpy！支持iOS27+，电脑端镜像操控iPhone，手机无需装App

rPlayHub，被称作iOS端的scrcpy，也是苹果Device Hub的跨平台开源替代方案，能够在macOS、Linux电脑上镜像并操控iPhone，后续还将支持Windows与树莓派。该工具依托CoreDevice协议实现通信，iPhone设备上不需要安装任何App。

• GitHub：https://github.com/rPlayAI/rPlayHub
• 网盘：https://pan.quark.cn/s/cb1a78b8bac9 提取码：9BQs

苹果原生Device Hub仅能在macOS，随Xcode配套使用。而rPlayHub是从零实现的CoreDevice主机，直接对接协议，运行环境无需搭载Xcode与苹果后台守护进程，同一套引擎同时驱动macOS原生应用和Linux图形界面。类比Android的scrcpy依靠adb实现投屏控制，rPlayHub依靠CoreDevice协议完成iPhone的远程操作。

它不止面向开发者，普通用户也可以用作iPhone镜像工具：电脑窗口实时显示iPhone屏幕画面，音频输出到电脑扬声器，鼠标直接映射触屏操作，支持点击、滑动、滚动、打开应用。镜像过程中手机本身依旧可以正常握持操作。仅需USB连接，完成一次「信任此电脑」配对即可使用。

开发者还能获得完整的Device Hub配套能力：应用安装/卸载、配置描述文件管理、崩溃日志读取、设备参数读写。

rPlayHub属于rPlay通用镜像项目，Android侧已有对应的rPlayHub for Android，内置3D视图、折叠视图功能。项目和苹果无隶属、官方授权关系。

使用要求

1. iPhone系统版本 iOS 27及以上；rPlayHub遵循iOS27发布时的CoreDevice协议，旧版iOS不支持。老旧iPhone可使用同项目下rPlay，支持全版本iOS，USB/无线投屏，蓝牙控制。
2. 手机和电脑完成配对、信任电脑；
3. iPhone开启开发者模式，准备Apple开发者磁盘镜像DDI；手机每次重启后引擎会自动挂载镜像。Mac上可自动找到DDI文件，Linux下执行脚本一键下载。

平台发布进度

• macOS 14+（Apple Silicon）：已发布公证DMG安装包
• Linux x86_64（Ubuntu22.04+/Debian12+）：已发布deb安装包
• 树莓派arm64 Linux：开发中，搭载硬件解码器
• Windows：即将上线，复用同一引擎，采用FFmpeg或Media Foundation解码

当前可用功能

• 实时投屏控制：HEVC视频流，鼠标点击拖拽映射触屏坐标
• 音频同步：AAC-ELD音频传输，电脑端播放iPhone声音
• 设备管理：增删应用、描述文件，浏览媒体分区，读取崩溃报告、系统日志
• 设备设置读写：调整外观、字号、减弱动态效果、VoiceOver、模拟定位等

规划新增能力（Android版本现已实现）

• 3D视图：实时跟随手机姿态渲染3D模型，画面叠加在虚拟手机表面
• 折叠视图：适配折叠iPhone，模拟铰链结构，支持多种显示特效
• 传感器可视化查看，读取设备姿态运动数据
• 服务端常驻模式，配套CLI+GUI客户端
• 远程网络访问，跨网操控iPhone

补充说明：原生CoreDevice协议本身无法读取IMU、铰链传感器数据，3D/折叠视图等功能可选配套手机端小程序采集传感器数据；不安装该配套App，投屏、控制等核心功能不受影响。

技术栈

macOS客户端采用Swift+AppKit；跨平台核心引擎使用C/C++编写；Python仅用于原型验证，不作为正式发布程序。

受沙盒机制限制，该项目暂时无法上架Mac App Store。

核心要点

1. 定位：iOS版scrcpy，CoreDevice协议实现，对标Apple Device Hub；iPhone无需安装App，iOS27+可用；
2. 已支持macOS/Linux，Windows、树莓派版本开发中；
3. 能力：实时音视频镜像、鼠标操控、应用/描述文件管理、日志读取、修改设备系统设置；
4. 未来特色功能：3D模型视图、折叠机铰链模拟、跨网络远程控制；传感器相关附加功能需要可选手机端配套程序；
5. 门槛：iPhone必须开启开发者模式，准备DDI开发者镜像；老iOS设备改用同项目rPlay。