AirGame串流系统使用手册

一、简介

AirGame串流系统由AirGameServer(主机端)与AirGamePlay(客户端)两部分组成。主机端通过实时抓取屏幕输出，然后编码通过网络发送给客户端，客户端从网络接收编码数据流，然后解码再输出到客户端的屏幕。同时客户端把用户的键盘，鼠标，游戏手柄的输入转发到主机端，完成对主机端的实时控制。

二、特性列表

0. 全流程硬件编解码,支持NVIDIA， AMD， INTEL的硬件H264/H265编解码（与硬件能力相关）
1. 支持多种分辨率/刷新率. (720p,1080p,2k,4k/30,60,120,144,165,240)
2. 支持同一局域网内自动发现，WOL远程唤醒。
3. 支持NAT穿越， 支持自动UPNP
4. 极速连接，超低延时
5. 可以根据当前网络带宽自动调整编码率.
6. 可以根据当前丢包率自动调整前向纠错.
7. 同时支持最多4个xinput手柄, 支持手柄振动反馈.
8. 支持多个主机端屏幕切换.
9. 支持通过分享/链接码给第三方访问
10. 超低的CPU占用(0-1%)，不影响系统原有程序运行
11. 对于低端硬件无法开启硬件编解码的，也可以设置为软件(cpu)编解码.
12. 对于公网无法通过p2p打洞直接连接的，也可以通过部署私有的中继服务器来连接。
13. 支持远程剪贴板文本拷贝粘贴

三、安装环境

• AirGameServer 主机端

  1. Windows10及以上 64bit操作系统。
  2. 支持Nvidia,AMD, Intel的显卡硬件编码。
  3. 需要安装2020年后的显卡驱动。
  4. 需要directx11 runtime。
  5. <font color=red>如果想使用游戏手柄，需要在主机端预先安装ViGEmBus驱动，下载页面在https://github.com/ViGEm/ViGEmBus/releases </font>

• AirGamePlay 客户端

  1. Windows7/8/10 64bit操作系统。
  2. Nvidia，AMD, Intel显卡均可以支持硬件解码，需要驱动支持,硬解解码失败则使用软件解码。
  3. 需要directx9/11 runtime。
  4. 请优先使用win10及以上系统。

四、使用流程

• AirGameServer

  1. 安装的时候，会要求用户输入一个使用邮箱注册的账号，如果只需要在局域网内也可以跳过该设置， 如果设置了账户名， 主机端会自动连接服务器并保持一个长连接。

     

  2. 正常启动后，会在右下角托盘上有一个小图标。

  3. 如果安装的时候没有输入用户账号，也可以启动后，点击托盘图标后菜单里面选择设置对话框里面设置。

     

  4. 如果没有设置连接的用户账号，那么仅可以接收通过ip直接连接的客户端，需要设置本地直连的连接码。

     <font color=red>如果连接码为空，则无法在本地网络中输入ip来直接连接。</font>

  5. AirGameServer端默认会自动升级。

  6. 可以手工设置为开机启动与自动登录。如果不是开机启动，则需要自己手工启动主机端服务器才能连接。

• AirGamePlay

  1. 每天第一次启动，会检查一次有没有新的版本。如果有新版本，请到官网下载后手动升级。
  2. 主窗口上分别为首页，设置，关于，登录几个栏目。
  3. 如果要连接公网的远程机器，请先登录，登录页面有注册链接。
  4. 首页中可以看到所有连接过的主机端， 不再区分局域网/公网， 相关信息合并在一起显示。
  5. 如果该主机端还没有认证过，首次连接的时候会给一个提示。
  6. 如果仅在局域网内，可以不登录，直接在首页下面的手动栏里面输入目标ip,连接码。
  7. 连接后如果成功，则窗口内显示主机端的桌面，<font color=red>鼠标移动到窗口中间顶部，会自动浮现一个菜单栏 </font>，菜单栏的功能见快捷方式解释。
  8. 全屏模式可以设置为全屏独占(延时更低一些)或者无边框全屏窗口两种模式。
  9. 可以唤醒局域网内的主机，点击主机栏上的小按钮，会尝试给目标主机发送WOL唤醒包， 需要提前设置相关唤醒操作。
  10. 可以自动/手动搜索局域网内的可用主机。
  11. 本地手柄连接后， 按键后会显示一个红色的手柄的图标， 表示本地手柄已经检测到。 如果主机端的ViGem虚拟手柄驱动已经安装，那么还会显示一个蓝色的手柄图标，表示主机端的手柄已经检测到了。
  12. 登录后， 才可以看的同样登录的主机端的公网IP与NAT状态。如果把鼠标移动到该主机栏上， 主窗口下方会有一个滚动条显示本地(客户端)的公网IP与NAT状态。NAT状态显示阻塞的话，是表示没有查询到相关NAT信息。如果双方NAT状态都显示为对称NAT，那么双方无法直接连通，需要设置一个中继服务器。如果有一端是全锥形或者公网直连，那么NAT是肯定可以打洞成功的。如果是IP限定锥形或者端口限定锥形，则有一定可能无法连接。路由器上upnp打开且有效的话，可以提升NAT连通率。
  13. 如果需要部署中继服务器， 请下载对应操作系统版本的中继服务器. 目前提供windows/linux两种x64版本.

五、参数设置

• AirGameServer的参数设置

  1. 需要公网远程登录，则必须要注册并设置用户名。
  2. 可以手动设置主机名，主机名会显示在客户端的可连接项上。
  3. 如果要支持局域网内直连，则需要手动设置6位数连接码。
  4. 如果某些硬件编码不能启用(硬件太古老或者驱动版本太低)， 那么可以强制设置为cpu编码。
  5. cpu编码仅仅支持h264, 会占用大量cpu，尽量避免使用。
  6. 仅在局域网内使用，可以不打开自动登录。

• AirGamePlay的参数设置

  1. 强制软解，一般情况不需要，但是某些情况下硬件码没有正确显示的时候，可以设置为强制软件解码。
  2. 缺省开启平滑渲染， 一般如果不是极致追求超低延时，都可以开启这个功能。开启后会增加轻微延时(<1帧)，画面会相对更加平滑。独占全屏比无模式窗口全屏延时更低。
  3. 编码分辨率宽，高， 这里是设置编码输出的分辨率，缺省为1080p， 即1920x1080。
  4. 编码码率， 缺省情况下 60fps/1080p，码率为30M bps。设置过高码率(>100M)可能会失败。
  5. 如果主机端客户端均能支持h265/hevc，可以在相同的画质/帧率下再降低一半码率。 h265/hevc目前不支持cpu软解码。
  6. 编码帧率， 预设的帧率，缺省为60fps，编码实际帧率受输入帧影响，但是不会超过主机端连接的显示器刷新率，如果画面没有任何变化，则不会刷新帧。
  7. 自动前向纠错缺省设置为打开，如果是局域网内全有线连接可以选择关闭，否则建议打开。
  8. 无模式窗口全屏的时候， 请关闭其他浮动窗口(比如各种流量悬浮窗)， 否则会造成性能降低以及不够平滑。
  9. 尽量保持主机端与客户端的刷新率一致。对于刷新率不一致的，在平滑性上有一定影响， 比如59.951/60，那么两端会在运行20秒后有一帧误差，在测试上就可能会看到轻微的一下抖动。

六、常见问题

0/

• 通用问题

  1. 缺少directx runtime， 表现为弹出对话框显示缺少xxx动态库。

  2. 驱动版本太低，表现为可能无法运行，或者也可能是黑屏无图像。

  3. 手柄不能正常使用。目前仅支持xinput兼容的手柄， ps4的手柄请安装ds4windows。 串流主机端需手动安装ViGEmBus驱动。

  4. 画面延时过高，有多种可能， 请点击菜单 显示当前会话信息， 观察RTT(网络延时), encode(编码时间), decode(解码时间), 网络延时根据环境不同，变化较大， 无线/公网/跨运营商这些条件都会带来附加的延时与抖动。参考值 内网有线在1毫秒左右， 内网无线wifi5 2.4G/5G大概是5-15毫秒不定， 公网有线深圳到北京机房延时在35-45毫秒， 公网深圳移动到深圳电信 可能会有35-45毫秒的延时。网络延时在50毫秒以内一般不会有太明显的延时感。 编码时间以1080p/30Mbps为例， 一般不超过8毫秒，高端显卡可能达到1-2毫秒， 解码时间类似。 如果以上数据正常， 请在客户端的UI界面内设置为全屏模式再测试， 或者设置为dx9的无边框窗口/全屏模式(注意，设置为dx9以后需要重启)。Nvidia卡请把控制面板中的全局3D设置的低延时模式 设置为 开 或者 超高。

  5. 无声音。请在主机端/客服端设置默认播放设备的声音输出为16bit双通道48000采样率。如果缺省的默认播放设备有变化， 请重启主机端/客户端。

     

  6. 画面抖动卡顿， 首先尽量设置主机端的显示器刷新率 与 客户端的显示器刷新率一致， 如果两端不一致是会导致一定的卡顿感， 对于敏感的人来说， 即使是60/59.541这样的差异(20秒左右会有一帧的差异)， 都可以感觉到轻微的抖动。其次，无线网络如果干扰较大的时候，也是会带来卡顿和跳帧的。

七、快捷方式与功能

• 快捷键
  1. ctrl+alt+enter 全屏/窗口切换
  2. ctrl+alt+c 关闭窗口
  3. ctrl+alt+1 显示远程主机端的快捷方式目录
  4. ctrl+alt+2 远程主机睡眠
  5. ctrl+alt+3 远程主机休眠
  6. ctrl+alt+4 远程主机关机
  7. ctrl+alt+5 远程主机重启
  8. ctrl+alt+6 远程主机ctrl+alt+del
  9. ctrl+alt+7 远程主机显示器轮询
  10. ctrl+alt+8 远端主机锁屏
  11. ctrl+alt+d 显示当前会话信息