企业官网建设流程全解析

iPhoneMirror 是一款面向 Windows 的 iPhone/iPad 本地投屏工具，通过 USB 私有采集与 AirPlay 无线镜像把手机画面送入 D3D11 原生预览。除了投屏本身，它还内置了截图、MP4 录制、RTMP/SRT/WHIP 直播推流和虚拟摄像头输出能力：一键把手机画面录成本地 MP4，或推送到 RTMP、SRT、WebRTC/WHIP 端点，供 OBS、直播平台和会议室软件使用。本攻略带你快速上手这套输出链路。

一、输出能力总览：一个窗口管四件事

开始投屏后，点击左侧导航的“输出”（对应源码中的输出设置窗口 MediaOutputSettingsWindow.xaml），即可进入“输出设置”窗口。它由三个选项卡组成：

所有输出共用同一组参数范围：

• 分辨率：160–3840 × 160–2160，且宽高必须为偶数；
• 帧率：10–60 fps；
• 码率：500–50000 kbps；
• 默认尺寸统一取当前预览的实际输出分辨率，无需手动对齐手机分辨率。

窗口顶部会实时提示当前可用端点（如 RTMP、SRT、WebRTC/WHIP）和编码器（如libx264），帮助判断本机输出能力是否齐全。

二、iPhoneMirror截图：干净画面，不含任何 UI

很多人用系统截图软件截投屏画面时，会不小心把窗口边框、按钮甚至鼠标指针一起截进去。iPhoneMirror 的截图走的是完全不同的路径：

• 截图由 ScreenshotService.cs 实现，直接读取核心解码后的最新 BGRA 帧写入 PNG；
• 不截取窗口画面，因此不含标题栏、边框、按钮和鼠标指针；
• 不受窗口缩放影响，得到的就是手机端原始画面比例；
• 没有收到有效视频帧时会提示“无可用画面”，而不是保存一张黑色占位图。

使用方法：

1. 投屏中点击预览区的“截图”按钮，或按快捷键Ctrl+S；
2. 先选择保存位置和文件名；
3. 以 PNG 格式保存，文件名为iPhoneMirror-日期时间-序号.png。

截图文件默认保存到系统“图片”目录，也支持指定其他目录，适合配合自动化脚本批量存档。

三、MP4 录制：点击即录，停止后再选保存位置

“录制”选项卡的操作流程非常简单：

1. 确认宽度、高度、帧率、码率（默认已按当前预览分辨率填充，如 994×2160、30 fps、6000 kbps）；
2. 点击“开始录制”，画面立即写入应用临时目录；
3. 点击“停止输出”，等待 MP4 封装（索引）完成；
4. 在弹出的保存对话框中选择最终位置和文件名。

几个容易忽略的细节：

• 取消保存不会删除已录内容：录制文件仍保留在临时区，下次打开输出窗口或重启应用时会再次提示保存，不会丢数据；
• 音频自动跟随：投屏源的 PCM 音频在编码器可用时会一并写入，MP4 使用AAC编码；没有可用音频或编码器时仍可开始纯视频录制；
• 麦克风混音可选：窗口支持显式选择麦克风并与来源音频混合（FFmpeg 处理 DirectShow 麦克风混音），默认关闭；开启混音时若音频管线缺失，需先关闭麦克风选项才能开始输出；
• 横竖屏切换时以黑边保持比例，不会拉伸变形；
• SDR 输出统一标记full-range BT.709，避免浅色 UI 在播放器中被二次扩灰阶而发白；HDR 源保留其 HDR 元数据。

四、直播推流：RTMP、SRT 与 WHIP 一键输出

“直播推流”选项卡通过随应用发布的 FFmpeg 8.1.2 运行时发送画面，三种协议各有所长：

WHIP 推流注意点：

• “服务器地址或 WHIP 端点”必须填写完整 URL；
• 若服务端需要鉴权，填写可选的WHIP Bearer 令牌——令牌只用于当前输出任务，请勿粘贴到日志或问题报告中；
• WHIP 的音频编码为Opus（RTMP/SRT/MP4 均为 AAC）。

推流与录制共用底部“停止输出”按钮，停止时会等待 FFmpeg 完成文件或网络收尾，避免文件损坏或推流截断。

五、虚拟摄像头与 OBS：两种把手机画面送进直播台的方式

方式一：iPhoneMirror Virtual Camera

“虚拟摄像头”选项卡基于 Windows 11 Media Foundation 软件摄像头 API，安装后在设备列表中出现iPhoneMirror Virtual Camera：

• 首次安装、更新或卸载媒体源需要管理员权限，安装完成后普通用户即可随时启动/停止；
• 会议软件、Zoom 类应用、浏览器均可像选择普通摄像头一样选择它；
• 虚拟摄像头只提供视频，需要声音时在 OBS 30.1+ 添加“应用程序音频捕获”并匹配iPhoneMirror.exe。

方式二：OBS 窗口采集（免安装回退方案）

iPhoneMirror 的独立预览窗口只显示手机画面，没有按钮和状态叠层，天然适合作为 OBS 的“窗口采集”来源：

1. 为设备打开独立窗口（快捷键Ctrl+Shift+P）；
2. OBS 添加“窗口采集”，选择标题包含iPhoneMirror与设备名称的窗口；
3. 捕获方法优先选Windows Graphics Capture，可稳定捕获 DirectComposition 窗口与圆角透明区域；
4. 对来源执行“变换 → 适配屏幕”；
5. 双显卡笔记本请让 OBS 与 iPhoneMirror 使用同一块 GPU。

多设备同时投屏时，按设备标题分别创建窗口采集来源即可；音频若已走“桌面音频”，不要再重复捕获同一输出设备，否则会产生回声。完整配置见 docs/OBS_OUTPUT.md。

六、本地推流自测：不连直播平台也能验证链路

仓库内置了本地推流验证环境 tools/srs-lab，可以在不依赖任何直播平台的情况下检查 RTMP、SRT、WHIP/WHEP 与虚拟摄像头：

.\tools\srs-lab\Start-SrsLab.ps1

启动后访问http://127.0.0.1:8090，页面会显示当前后端（Docker SRS 或 MediaMTX）对应的实际推流地址，把它填进 iPhoneMirror 的直播推流窗口即可完成一次完整闭环测试。Docker 不可用时脚本会自动下载并校验 MediaMTX Windows 后端。更多参数见 tools/srs-lab/README.md。

七、常见问题

问：录制的 MP4 文件在哪里？点击“停止输出”并完成封装后，通过保存对话框选择位置。若在窗口未关闭时取消保存，文件保留在应用临时目录，下次打开窗口或重启应用会再次提示。

问：推流时音频没有声音？MP4/RTMP/SRT 要求音频编码器可用（AAC），WHIP 需要 Opus 支持。缺少麦克风或编码器时应用允许纯视频输出；若开启了麦克风混音但音频管线缺失，需关闭麦克风选项后再开始。

问：WHIP 报错“请输入 HTTP(S) WHIP 端点地址”？该错误对应 Strings.zh-CN.xaml 中的MediaOutputWhipAddressRequired，说明端点不是完整的http(s)://地址，请补全协议头与路径。

问：输出设置窗口关着时，预览分辨率变了会影响设置吗？窗口保持打开时，预览方向或尺寸变化只会更新仍处于默认值的宽高控件，不会覆盖你手动选择的尺寸。

八、参考文档

• 完整使用教程：docs/USER_GUIDE.md
• OBS 输出、录制与虚拟摄像头详解：docs/OBS_OUTPUT.md
• 截图实现源码：src/App/Services/ScreenshotService.cs
• 输出设置窗口：src/App/Windows/MediaOutputSettingsWindow.xaml
• 本地推流自测环境：tools/srs-lab/Start-SrsLab.ps1

排查输出问题时，可按Ctrl+L展开实时日志确认解码器是否持续收到有效帧，并结合关于窗口的诊断工具定位。掌握以上步骤后，你就能用 iPhoneMirror 把手机画面稳定地输出为 MP4 文件，或实时推送到 RTMP、SRT、WHIP 端点，配合 OBS 完成专业级直播画面采集。