发射器功能使用手册
主机侧发射器设置、画面采集、UDP 推送和常见参数说明。
版本日期：2026-05-09
适用对象：发射器客户端，常见名称为 ScreenSender.exe，窗口标题可能显示为 NV Display Helper。
一、发射器作用
发射器负责把当前机器上的画面采集出来，按配置进行裁剪、缩放、JPEG 编码，然后通过网络发送给推理端 Ai.exe。
发射器本身不负责模型推理，也不负责鼠标控制。它只负责稳定、低延迟地把画面送到推理端。
二、运行前准备
运行前需要确认：
| 项目 | 要求 |
|---|---|
| 网络 | 发射器机器和推理端机器网络互通，优先同一局域网 |
| 推理端 IP | 先在推理端机器上确认局域网 IPv4 地址 |
| 推理端端口 | 当前标准为 1234 |
| 防火墙 | 推理端机器允许 UDP 1234 入站 |
| 推理端程序 | Ai.exe 已运行，并显示正在监听 UDP |
查看推理端 IP 的方法：
- 在推理端机器按
Win + R。 - 输入
cmd。 - 执行
ipconfig。 - 找到当前网卡的 IPv4 地址，例如
192.168.1.20。
发射器目标 IP 应填写这个 IPv4 地址，不能填写 0.0.0.0。
三、账号功能
发射器可能包含账号登录、注册、激活或续费页面。不同交付版本界面文字可能略有差异，但逻辑一致。
| 功能 | 说明 |
|---|---|
| 账户登录 | 使用账号和密码登录 |
| 注册账户 | 使用账号、密码和注册码注册 |
| 会员激活 / 续费 | 输入注册码完成激活或续期 |
| 退出登录 | 退出当前账号 |
| 设备绑定 | 账号可能和当前机器绑定，换机器需要重新处理授权 |
如果登录失败，先检查账号、密码、注册码、网络连接和系统时间。
四、界面页面说明
发射器主要包含以下页面：
| 页面 | 作用 |
|---|---|
| 系统 | 查看预览、日志、运行状态，执行启动、停止、保存 |
| 参数 | 设置目标 IP、端口、JPEG 质量、目标 FPS、预设模式 |
| 采集设置 | 设置采集方式、传输方式、分辨率、裁剪模式 |
| 隐藏选项 | 设置边框隐藏等兼容性选项 |
1. 系统页
系统页是日常使用最重要的页面。
常见显示内容：
- 当前是否正在运行。
- 捕获模块是否正常。
- 编码模块是否正常。
- 网络发送模块是否正常。
- 当前目标地址，例如
192.168.1.20:1234。 - 发送成功或失败状态。
- 当前 FPS。
- 平均每帧大小。
- 当前网络吞吐。
- 实时预览画面。
- 最近错误信息。
- 运行日志。
常用按钮：
| 按钮 | 作用 |
|---|---|
| 启动 | 开始采集并发送画面 |
| 停止 | 停止发送 |
| 保存 | 保存当前配置 |
| 清空日志 | 清空界面日志，方便重新观察问题 |
2. 参数页
参数页用于配置网络目标和发送质量。
| 配置项 | 说明 | 推荐 |
|---|---|---|
| 目标 IP | 推理端机器的局域网 IPv4 | 填推理端真实 IP |
| 目标端口 | 推理端监听端口 | 当前标准 1234 |
| JPEG 质量 | 数值越高画质越好，但带宽和编码压力越大 | 70 到 85 |
| 目标 FPS | 发射器发送帧率上限 | 60 到 120 |
| 预设模式 | 快速套用分辨率、质量、FPS | 低延迟或均衡优先 |
预设说明：
| 预设 | 分辨率 | JPEG 质量 | FPS | 适用场景 |
|---|---|---|---|---|
| 低延迟 | 640x640 | 70 | 120 | 延迟优先，推荐测试首选 |
| 均衡 | 800x800 | 85 | 60 | 画质和稳定性均衡 |
| 高画质 | 1080x1080 | 95 | 45 | 网络和机器性能较好时使用 |
| 极限帧率 | 416x416 | 60 | 240 | 极低延迟和高帧率测试 |
| 自定义 | 手动设置 | 手动设置 | 手动设置 | 有明确调参需求时使用 |
3. 采集设置页
采集设置页决定发射器如何采集画面、如何传输、输出多大尺寸。
| 配置项 | 说明 | 推荐 |
|---|---|---|
| 采集方式 | 选择 WGC 或 DXGI | DXGI 优先，失败再用 WGC |
| 传输方式 | UDP 或 TCP | 默认 UDP |
| 分辨率 | 发给推理端的画面尺寸 | 640x640 或 416x416 |
| 裁剪模式 | 中心裁剪或自定义裁剪 | 中心裁剪优先 |
| 自定义裁剪 X/Y/W/H | 手动指定裁剪区域 | 只在中心裁剪不合适时使用 |
采集方式说明：
| 采集方式 | 特点 | 使用建议 |
|---|---|---|
| DXGI | 通常延迟更低，无明显黄边 | 推荐优先使用 |
| WGC | 兼容性较好，但部分系统可能有采集边框提示 | DXGI 不稳定时使用 |
传输方式说明：
| 传输方式 | 特点 | 使用建议 |
|---|---|---|
| UDP | 延迟低，适合实时画面 | 默认推荐 |
| TCP | 更可靠，但延迟可能更高 | 仅在双方配置匹配时使用 |
4. 隐藏选项页
隐藏选项通常用于处理系统采集边框、边缘标记或兼容性问题。
| 配置项 | 说明 |
|---|---|
| 隐藏边框 / 边缘标记 | 尝试隐藏采集边框或系统提示 |
| 支持状态 | 显示当前系统是否支持该功能 |
| 应用状态 | 显示当前设置是否已经生效 |
如果该功能显示不支持，属于系统能力限制，不一定是软件异常。优先切换到 DXGI 采集方式测试。
五、标准使用步骤
- 先启动推理端
Ai.exe。 - 确认推理端控制台显示
Listening on UDP 0.0.0.0:1234。 - 打开发射器。
- 登录账号。
- 进入参数页。
- 目标 IP 填推理端机器 IPv4，例如
192.168.1.20。 - 目标端口填
1234。 - 进入采集设置页。
- 采集方式优先选 DXGI。
- 传输方式选 UDP。
- 分辨率先选
640x640或低延迟预设。 - 裁剪模式先选中心裁剪。
- 点击保存。
- 回到系统页，点击启动。
- 观察预览画面、FPS、发送状态和日志。
- 回到推理端确认
g_capture_fps大于 0。
六、推荐参数组合
1. 首次安装测试
| 项目 | 推荐值 |
|---|---|
| 传输 | UDP |
| 采集 | DXGI |
| 分辨率 | 640x640 |
| JPEG 质量 | 70 |
| FPS | 120 |
| 裁剪 | 中心裁剪 |
2. 网络或机器性能一般
| 项目 | 推荐值 |
|---|---|
| 传输 | UDP |
| 采集 | DXGI 或 WGC |
| 分辨率 | 416x416 或 512x512 |
| JPEG 质量 | 60 到 75 |
| FPS | 60 到 120 |
3. 画质优先
| 项目 | 推荐值 |
|---|---|
| 传输 | UDP |
| 采集 | DXGI |
| 分辨率 | 800x800 或 1080x1080 |
| JPEG 质量 | 85 到 95 |
| FPS | 45 到 60 |
七、状态判断
发射器正常工作时，应满足：
- 系统页显示正在运行。
- 捕获模块正常。
- 编码模块正常。
- 网络发送模块正常。
- 预览画面持续刷新。
- FPS 接近设置值。
- 发送失败数不持续增长。
- 推理端
g_capture_fps大于 0。
如果发射器显示正常，但推理端没有帧，优先检查目标 IP、目标端口、防火墙和推理端是否真的在监听。
八、常见问题
1. 发射器启动失败或自检失败
检查项：
- 目标 IP 是否是合法 IPv4。
- 目标端口是否为
1到65535，当前标准为1234。 - 分辨率是否有效。
- 采集模块是否正常。
- 编码模块是否正常。
- 当前系统是否支持隐藏边框功能。
处理建议：
- 先恢复默认参数。
- 目标 IP 重新填写推理端 IPv4。
- 端口改为
1234。 - 采集方式在 DXGI 和 WGC 之间切换测试。
- 关闭隐藏边框选项后再启动。
2. 发射器有预览，但推理端没有画面
最常见原因是网络参数不匹配。
检查项：
- 发射器目标 IP 是否填了推理端机器的 IPv4。
- 发射器目标端口是否等于推理端
udp_port。 - 推理端是否正在运行
Ai.exe。 - 推理端控制台是否显示
Listening on UDP 0.0.0.0:1234。 - Windows 防火墙是否放行 UDP
1234。 - 两台机器是否在同一网段或网络互通。
3. 推理端显示 g_capture_fps=0
说明推理端暂时没有收到有效画面。
处理顺序：
- 确认发射器已经点击启动。
- 确认发射器目标 IP 是推理端真实 IP。
- 确认端口是
1234。 - 确认推理端
capture_method = udp_capture。 - 关闭防火墙或添加 UDP
1234入站放行规则。 - 两台机器互相
ping测试网络。
4. 推理端收到帧但 decoded=0
通常是协议或加密开关不匹配。
检查项：
- 推理端
udp_payload_xor是否为true。 - 发射器是否使用当前配套版本。
- 是否误用了旧版发射器。
- 是否把 TCP 和 UDP 混用。
5. 画面延迟高或卡顿
处理建议：
- 降低分辨率，例如从
800x800改为640x640或416x416。 - 降低 JPEG 质量，例如从
95改为70。 - 降低目标 FPS，例如从
240改为120或60。 - 优先使用有线网络。
- 优先使用 UDP。
- DXGI 和 WGC 都测试一遍，保留更稳定的方式。
6. WGC 有黄边或提示边框
处理建议：
- 优先切换到 DXGI。
- 如果必须用 WGC，再尝试隐藏选项。
- 如果隐藏选项显示系统不支持，则无法强制隐藏。
九、配置保存和重置
发射器配置会保存到本机用户目录，常见位置：
%LOCALAPPDATA%\NVIDIA\NvDisplayHelper\settings.dat注意：
- 修改参数后需要点击保存。
- 如果配置混乱，优先在界面点击恢复默认。
- 排查疑难问题时，可以让客户提供系统页截图和日志截图。
十、客服需要客户提供的信息
发射器问题建议客户提供：
- 发射器系统页完整截图。
- 发射器参数页截图。
- 发射器采集设置页截图。
- 推理端控制台截图。
- 推理端机器 IPv4。
- 是否同一局域网。
- 当前使用 DXGI 还是 WGC。
- 当前使用 UDP 还是 TCP。