RayrenSX / iPhoneMirror

iPhoneMirror 
 Windows 上通过 USB 或 AirPlay 进行低延迟 iPhone 屏幕与系统声音采集。 
 Low-latency USB and AirPlay iPhone mirroring for Windows.
 简体中文 · English 
> [!IMPORTANT]
> 当前是公开预览版，尚未进行商业 Authenticode 签名，Windows 可能显示 SmartScreen
> 或“未知发布者”提示。Apple Screen Capture 使用私有协议，未来 iOS 更新可能需要适配。
> 官方构建目前仅支持 Windows x64；Windows ARM64 因 USB 内核驱动和无线运行库缺少 ARM64
> 版本而不受支持。
## 社区移植与特别致谢
感谢社区开发者将 iPhoneMirror 带到更多平台！以下移植项目由各自作者独立维护，
欢迎关注、体验并支持他们的工作。
| 平台 | 贡献者 | 适配方向 | 项目与说明 |
|---|---|---|---|
| **Linux** | **@furruka** | Linux 原生界面、音视频与设备通信适配 | 项目仓库 · 适配说明 |
| **HarmonyOS（鸿蒙 PC）** | **@zhangziqizZ** 哔哩哔哩：**@Fantasy_zzq** | 面向 HarmonyOS NEXT / 2in1 的 USB、AirPlay 投屏与原生音视频适配 | 项目仓库 · 适配说明 |
各平台的功能范围、发布包、构建方式及已知限制，请以对应项目的 README 和适配说明为准。
## 社区交流
欢迎加入 QQ 群，与其他用户交流使用体验、反馈问题、讨论功能建议。
QQ群号：**1050045279**
## 项目描述
iPhoneMirror 是一个面向 Windows 10/11 x64 的本地
iPhone/iPad 投屏与蓝牙反向控制工具，目标是
在不依赖云端中转的情况下，将 USB 有线采集和局域网 AirPlay 接收统一到同一套
预览、音频、截图、独立窗口、OBS 和多设备会话能力中。
项目按职责划分：C++ 核心负责 Apple 私有 USB 协议、QuickTime/CoreMedia
解析、H.264 解码、D3D11 渲染和 WASAPI 音频；WPF 主程序负责设备列表、会话控制
和用户界面；独立无线宿主负责 AirPlay 协议与解码，并通过有界命名管道传递媒体帧；
驱动安装、修复和卸载由单独的 `iPhoneMirror.Driver.exe` 负责，主程序只读检查
有线设备状态，不在投屏进程中修改系统驱动。
> [!TIP]
> 从安装驱动到 USB、AirPlay、多设备、独立窗口和 OBS 的完整步骤，请阅读
> 完整使用教程。
文档入口：文档索引 · 开发与测试 ·
架构说明。
## 核心亮点
### 按真实 iPhone/iPad 外形适配
iPhoneMirror 不给所有设备套用同一个通用圆角。程序会根据 Apple `ProductType`
识别 iPhone X、刘海屏、mini、标准/Max、Dynamic Island，以及 iPad Pro、Air、mini
和全面屏基础款等机型族，为每台设备匹配独立的屏幕圆角、曲线和裁切配置。带 Home 键
或已知直角屏设备保持直角；未知新设备会根据画面比例保守回退，避免把 iPad 误裁成手机。
这套适配同时作用于原生渲染和独立窗口轮廓。拖动、等比例缩放、横竖屏切换和全屏时，
窗口仍保持对应设备的视觉形状；用户也可以通过右键菜单手动去除或恢复圆角。
圆角参数属于基于公开外观和画面比例的视觉拟合，并非 Apple 公布的工业尺寸数据。
### 双通道、多设备和本地原生渲染
- USB 私有 Screen Capture 与局域网 AirPlay 使用同一套设备、预览、声音和 OBS 工作流；
- 每台设备拥有独立会话和独立窗口，可同时运行，不必切换时停止上一台；
- 设备卡片支持长按拖动排序，无线设备刚连接时只自动切换一次；
- H.264/CoreMedia 与 AirPlay 屏幕镜像帧在本机解码，通过 D3D11/DirectComposition 原生显示；
- 媒体不经过 iPhoneMirror 云端中转，USB 场景不依赖网络；
- 干净的独立窗口可直接用于 OBS，截图直接读取解码帧，不包含软件 UI。
- 可选 BLE HID 鼠标/键盘控制：配合 iOS 辅助触控，无需在手机安装 App 或越狱；
## 界面预览
### 与常见投屏方案的区别
| 对比维度 | iPhoneMirror | 常见通用方案 |
|---|---|---|
| 连接方式 | USB 与 AirPlay 统一 | 通常只提供一种连接，或分成两个程序 |
| 设备外形 | 按 iPhone/iPad 机型族匹配圆角与曲线 | 统一圆角、矩形窗口或额外黑边 |
| 多设备 | 独立会话、独立窗口、排序与同时投屏 | 多数围绕单设备切换设计 |
| 有线兼容 | A 演示、B AirPlay 实验、C 爱思模式按设备选择 | 通常使用固定协议参数 |
| OBS | 无 UI 的原生独立窗口 | 经常需要裁掉控制面板或捕获桌面 |
| 驱动 | 独立管理器按设备检查、修复和卸载 | 驱动操作常混在主程序内，诊断信息较少 |
| 数据路径 | 本机/局域网处理，无项目云端中继 | 部分方案要求登录、联网或云服务 |
iPhoneMirror 的蓝牙控制受 iOS 辅助触控和 Windows 蓝牙外设模式限制，不能注入多指触控；
项目也没有内建视频编辑器。Apple 私有协议和兼容 AirPlay 实现可能随未来 iOS 更新而需要适配。
## 下载
前往 Releases，优先下载
`iPhoneMirror-Setup-v*-x64.exe`。安装向导支持简体中文、繁体中文（香港）、繁體中文（台灣）和 English，可选择安装目录，
管理员安装默认到 `C:\Program Files\iPhoneMirror`，并创建开始菜单入口；桌面快捷方式为可选项。
选择按当前用户安装时，Inno Setup 会使用 Windows 的用户级程序目录。
需要免安装版本时，也可以下载 `iPhoneMirror-v*-win-x64.zip`，完整解压后运行
`iPhoneMirror.exe`。若 Windows 对 ZIP 版无线 DLL 报“损坏的映像”或错误
`0xc0e90002`，请改用 Setup；必须使用 ZIP 时，先在下载文件的“属性”中勾选
“解除锁定”，再重新解压，不能只处理已解压出的单个 DLL。
两种发布包都自带 .NET 运行时和独立的 `iPhoneMirror.Driver.exe` 驱动管理器，
无需另装 .NET Desktop Runtime 或单独下载驱动工具。可使用同一 Release 中的
`SHA256SUMS.txt` 验证下载文件完整性。