设置:高级

自动启动活动,保持活动期间自动重启开启,解决相机预览黑屏,播放高帧率视频,设置错误处理,通过 GPU 包为换脸选择 CPU 或 GPU,并开启 Local API 和手机遥控器。

15 分钟阅读 更新于 8 Nov 2026 观看视频 (2:15)

高级选项卡包含技术性设置:自动启动活动、相机预览和视频的绘制方式、错误处理、在处理器或显卡上运行离线人脸和背景工具(换脸、人脸修复、背景更换)的计算引擎,以及 Local API 和手机遥控器。除非有明确原因,否则请保持默认值——下面每个选项都说明了何时需要修改。

注意

如果看不到高级选项卡,请打开应用设置窗口左下角的显示全部设置。

高级选项卡:实时预览渲染引擎、视频播放引擎、错误处理和计算引擎
高级选项卡(在当前版本中,“应用启动时自动运行 Event”、“活动期间自动重启”和“保留未加叠加层的原图”位于这些选项的上方和中间)。

应用启动时自动运行 Event

让电脑变成自动启动的拍照机(自 5.4.0.0 起):Q-Booth 打开时,会自动以全屏自助模式运行所选的活动。

  1. 开启应用启动时自动运行 Event。
  2. 选择要运行的 Event。
  3. 点击保存设置。

下次启动 Q-Booth 时会先显示倒计时。取消倒计时即可留在应用内(例如活动前还要修改某些内容)。如果所选活动之后被删除,自动启动会自行关闭。

提示

配合 Windows 登录后自动启动 Q-Booth,停电后拍照机可以自行恢复。请在活动中设置退出 PIN,防止访客退出自助模式——参见活动设置。

活动期间自动重启

从 5.9.0.0 起,这里有两个开关,默认都是开启的:

  • 背景视频停止时重启——如果某个页面的背景视频停止播放,拍照机会在两位访客之间重启,并重新打开该活动。
  • 内存过高时重启——如果 Q-Booth 占用的内存远超正常水平(约为电脑内存的一半,最多 12 GB),它会以同样的方式重启,每 30 分钟最多一次。
重要

请保持两个开关都开启。关闭视频重启后,视频停止后页面会变黑,而拍照机占用的内存会越来越多,直到电脑卡死。

重启在访客眼中是什么样子,以及频繁发生时该怎么办:参见活动期间拍照机自行重启。

实时预览渲染引擎

选项何时使用
GPU(默认)使用显卡绘制相机预览。流畅,处理器负担小。
CPU当这台电脑上的实时相机预览黑屏时使用(通常照片仍能正常拍摄)。适用于任何电脑,但处理器占用更高。

修改将在下次打开相机页面或相机窗口时生效,无需重启。如果 Q-Booth 完全检测不到可用的显卡,会自动用 CPU 运行预览,并在启动时提示(No GPU Detected);更新显卡驱动通常能解决问题。

在 5.9.0.0 之前的版本上,如果拍照机因背景视频停止而反复自行重启,请把这里设为 CPU 并点击保存设置:CPU 预览不会像旧版 GPU 预览那样逐渐耗尽显存。它占用更多处理器资源,请确认预览仍然流畅。最可能的原因已在 5.9.0.0 中修复,所以请先更新。

视频播放引擎

选项优点缺点
内置(默认)可播放大多数视频。屏幕上的按钮和对象可以显示在视频之上。高于 60 fps 录制的片段播放速度会比实际慢。
VLC以实际速度播放高帧率视频(120/240 fps)。按钮和对象无法显示在视频之上。需要一次性下载:选择 VLC 且尚未安装时,会出现下载 VLC 包按钮。

只有当高帧率片段(例如 GoPro 慢动作拍照机)卡顿或播放过慢时才切换到 VLC,并确认没有页面依赖显示在视频上方的按钮。在 5.9.5.0 之前的版本中,VLC 有时会在 AI 结果刚好完成时让"Please Wait"窗口卡住——参见 故障排除。

保留未加叠加层的原图

开启后,Q-Booth 会在添加叠加相框之前,为每张图片结果额外保存一份副本,存放在结果文件旁的 _original 文件夹中。这些副本不会显示在相册中,也不会被分享或打印——客户需要无相框照片时可手动复制。仅限图片,不含视频。默认关闭(自 5.4.0.0 起提供),且只对开启之后拍摄的照片有效。

错误处理

Q-Booth 遇到意外错误时的处理方式:Show Error Dialog(默认)显示错误信息。选择 Silent 时不会弹窗——应用会直接关闭,而且不会自动重新启动。错误仍会写入日志。

重要

除非有明确原因,请保持 Show Error Dialog。在无人值守的自助终端上,Silent 意味着拍照机可能突然消失,需要有人重新启动。

计算引擎

计算引擎在本机运行离线人脸和背景工具——换脸、人脸修复和背景更换。它不影响在云端运行的 AI Online,也与运行 AI Offline 图像模板(Imagine、Re-Imagine…)的 AI Offline Server 无关——这里的设置不会启动、修复或加速该服务器;参见 AI Offline Studio。

计算设备

选项作用
自动(默认)在可能时使用显卡,否则使用处理器。适合大多数配置。
CPU始终使用处理器。适用于任何电脑,但换脸和人脸修复速度较慢。
GPU始终使用显卡,速度快得多。需要 NVIDIA RTX 30 系列或更新显卡以及 GPU 包。没有 NVIDIA 显卡的电脑上此项不可选。

下载 GPU 包

在装有 NVIDIA 显卡的电脑上,GPU 模式需要额外的包。如果尚未安装,选项卡会显示GPU 模式在 GPU 上运行前需要额外的包以及下载 GPU 包按钮。

  1. 确保网络稳定——这个包很大(约 2.4 GB)。请在工作室完成,不要在活动现场下载。
  2. 点击下载 GPU 包,等待下载和安装完成。
  3. 将计算设备设为 GPU(或保持自动)。
  4. 点击保存设置,然后重启 Q-Booth。

测试引擎

在 NVIDIA 电脑上选择 GPU 后,选项卡会显示检测到的 GPU和测试引擎按钮。测试会检查图形加速、换脸和人脸修复,并报告是否全部通过。修复问题后(例如更新显卡驱动)可点击重新测试。

引擎启动(预热)

决定 AI 引擎是常驻内存(更快)还是需要时才加载(更省内存)。可选项取决于设备:

设备选项效果
GPU自动由 Q-Booth 为你的显卡选择最佳模式。推荐。
预热启动切换模板时无需等待,但整个会话期间会保留约 3 GB 显存。
冷启动空闲时不占用额外内存。模板首次运行——以及切换模板后的首次运行——需要多等几秒。
CPU(或没有 NVIDIA 显卡时的自动)保持加载推荐。第一张照片时加载一次并保持就绪;关闭应用前约占用 2.5 GB 内存。
每张照片后释放每张照片后释放内存。仅适用于内存不足的电脑——每张照片都要重新加载引擎,最多可能多花一分钟。

CPU 的两个选项自 5.2.0.0 起提供。

重要

修改计算设备,或在 GPU 模式下修改引擎启动后,必须重启 Q-Booth 才会生效——选项卡会提示更改此项在重新启动应用后生效。CPU 的引擎启动选项从下一张照片起生效,无需重启。把计算设备设为自动时,引擎启动也会恢复为自动。切勿在活动进行中修改。

Local API 与遥控器

从 5.9.2.0 起,其他软件(在本机或同一网络中)可以控制正在运行的拍照亭:开启或结束活动、开始访客会话、选择模板、拍照、重拍、处理、打印、显示二维码以及返回首页。最简单的用法完全不需要写代码:手机上的遥控器。

高级选项卡中的 Local API 部分:开启 Local API、端口 8730、密码和生成新密码、允许网络中的其他设备、沙盒和遥控器的打开与二维码按钮
高级选项卡底部的 Local API 部分(图中密码已模糊处理;截图为英文界面)。
  • 开启 Local API — 默认关闭。点击保存设置后生效。
  • 端口 — 默认 8730。只有在其他程序已占用该端口时才需要修改。
  • 密码 — 每次调用都必须带上。留空则在保存时自动生成。生成新密码会生成新的密码,使用旧密码的软件和手机在拿到新密码前将无法使用。
  • 允许网络中的其他设备 — 关闭:只有本机上的软件可以连接。开启:同一网络中的任何设备凭密码都可以连接。Windows 可能会询问一次是否允许 Q-Booth 通过防火墙——请允许。
  • 沙盒 → 打开 — 在浏览器中打开测试页面,每个命令都有一个按钮(先输入密码),并附有 Documentation 链接。开发者请看:Local API 参考。
  • 遥控器 → 打开在本机显示遥控器;二维码显示一个用手机打开遥控器的二维码。

拍照亭的规则照常生效:付款、开始 PIN、打印 PIN 或打印次数限制依然适用,拍照亭屏幕上的对话框(付款、PIN、二维码、提示)必须先在拍照亭上关闭。通过这种方式结束活动不会要求输入退出 PIN。每次调用都会写入应用日志(log\local_api\)。

从 5.9.4.0 起,软件还可以显示自己的模板选择界面和结果界面:模板和分类列表可以附带每张卡片的封面图片,"result" 调用会以链接形式给出最近一位访客的照片和视频,软件可直接显示。只能取到最近一位访客的结果——从结果页显示起,到下一位访客开始为止——绝不会提供之前访客的照片。

Local API 仅限本地连接。它不能通过互联网使用,也不是云打印服务——别人无法把自己的照片发到拍照亭打印。现成的示例软件见 Local API 示例。

遥控器

一个带大按钮的简单拍照亭遥控器,可在连接同一 Wi-Fi 的任何手机或平板上使用,无需安装任何东西。

  1. 打开开启 Local API和允许网络中的其他设备,然后点击保存设置。如果 Windows 询问防火墙,点击允许。
  2. 在遥控器旁边点击二维码。
  3. 用与拍照亭电脑连接同一 Wi-Fi 的手机扫描二维码。手机会直接打开遥控器并自动连接。
遥控器二维码窗口,显示遥控器地址和二维码包含密码的提示
二维码窗口。二维码包含密码,请勿分享(图中的二维码仅为示意)。
手机上的遥控器:Online 指示灯、状态面板、Event 的 Start event 和 Stop event、Session 的 Start session 和 Home、Template 的 Pick、Camera 的 Retake、Shoot 和 Process、Result 的 Print 和 QR Share
手机上的遥控器:活动正在运行,拍照亭处于相机页面。

绿色的 Online 指示灯表示遥控器已连接;下方的面板显示活动、拍照亭当前所在的页面和相机步骤。遥控器上的按钮为英文,从上往下使用:

  • Event — 选择活动,然后点 Start event 或 Stop event。
  • Session — Start session 相当于访客的开始按钮;Home 结束会话并返回欢迎页。
  • Template — 选择模板,然后点 Pick。从 5.9.4.0 起,遥控器会显示模板封面供选择。
  • Camera — 大的 Shoot 按钮在拍照亭上开始倒计时;之后点 Retake 或 Process。
  • Result — 对屏幕上的结果使用 Print 和 QR Share。从 5.9.4.0 起,处理完成后遥控器还会显示访客的照片。
提示

按钮变暗表示拍照亭此刻无法执行该操作(页面不对、有对话框打开、照片正在处理)。开始 PIN、付款或打印 PIN 仍会显示在拍照亭屏幕上,并在拍照亭上完成,而不是在手机上。

重要

二维码包含密码:任何扫描它的人都能操作拍照亭。不要发布或转发;如果泄露,请点击生成新密码并保存。遥控器只在局域网内工作——它不是远程协助,不会让任何人进入这台电脑。

故障排除

相机预览黑屏。

将实时预览渲染引擎设为 CPU,保存后重新打开相机页面。另请参阅相机故障排除。

AI Offline Server 一直离线。

本选项卡的计算引擎设置不影响 AI Offline Server——修改计算设备解决不了问题。该服务器的要求请参阅 AI Offline Studio。如果在配有 RTX 显卡的 Pro 授权上它始终不变绿,请把日志发送给技术支持(导出日志)。

换脸非常慢。

有 NVIDIA RTX 显卡时:把计算设备设为 GPU(或自动),下载 GPU 包,然后重启。没有 NVIDIA 显卡时会在处理器上运行,速度较慢。

我改成了 GPU,但没有变化。

请重启应用——计算设备需要重启后才会改变。

应用总是自己关闭,没有任何提示。

检查错误处理是否设为 Silent,然后把日志发送给技术支持。

GPU 选项是灰色的。

未检测到 NVIDIA 显卡。GPU 模式需要 NVIDIA RTX 30 系列或更新显卡;否则请使用自动或 CPU。请查看系统要求。

部分引擎检测失败。

更新 NVIDIA 显卡驱动,重启电脑后运行重新测试。在通过之前,请使用自动或 CPU。

高帧率视频卡顿或播放过慢。

将视频播放引擎切换为 VLC 并下载 VLC 包。注意 VLC 视频上方无法显示按钮。

会话中第一张换脸照片很慢。

这是引擎正在加载。使用预热启动(GPU——修改后需重启应用)或保持加载(CPU),并在访客到来前先拍一张测试照片。

沙盒或遥控器打不开。

先打开开启 Local API并点击保存设置。如果开关下方显示 Could not start,说明端口被其他程序占用——换一个端口并保存。

手机打不开遥控器。

打开允许网络中的其他设备并保存,在 Windows 防火墙提示中允许 Q-Booth,并确认手机连接的是与拍照亭电脑相同的 Wi-Fi(不是移动数据,也不是隔离设备的访客网络)。然后重新显示二维码并扫描。

遥控器按钮变暗,或命令被拒绝。

拍照亭此刻无法执行——它在其他页面、拍照亭屏幕上有对话框打开,或照片正在处理。在拍照亭上关闭对话框(付款、PIN、二维码、提示)后再试。

下一步

仍需要帮助?

我们的团队在 WhatsApp 上为您解答。请告知 Q-Booth 版本及屏幕上显示的内容。

WhatsApp 联系