故障排除

查找相机、打印机、QR、邮件、AI、视频、自助机、模板、更新、性能和授权问题的原因与解决方法。

75 分钟阅读 更新于 8 Nov 2026

遇到问题?在下面找到对应的类别,展开与你看到的情况相符的问题,然后按步骤解决。每一条都包含症状、常见原因和解决步骤,并附有相关文章的链接。

先做这些检查

提示

很多问题在新版本中已经修复,所以请先查看版本:关于 › 版本。如果下面的条目写着"已在 5.x 修复",请先通过 关于 › 检查更新 更新,再尝试其他方法。切勿在活动进行中更新——更新时应用会关闭。

很多问题通过以下快速检查就能解决:

  • 修改后是否点击了 保存设置(应用设置中)或 保存(Event 编辑器中)?启动 不会替你保存 Event。
  • 有些选项需要重新打开相机页面或重启 Q-Booth 才会生效——该选项下方的说明会注明。
  • 找不到这里提到的选项?在应用设置窗口左下角打开 显示全部设置。简易模式在打开它之前会隐藏高级页面。
  • 网络是否正常?AI Online、Web QR、邮件、授权登录和更新都需要联网;拍摄、打印、AI Offline、Face Swap 和本地 QR 不需要。

相机

实时预览是黑屏,但仍然可以拍照

原因:这台电脑的显卡无法绘制实时预览。

解决:

  1. 打开 设置 › 高级。
  2. 将 实时预览渲染引擎 设为 CPU,然后点击 保存设置。
  3. 关闭并重新打开相机页面或相机窗口。更改会在下次打开时生效。

启动活动时,Q-Booth 也可能提示未检测到显卡、预览正以 CPU 模式运行。相机仍可正常工作;请从显卡厂商网站安装或更新显卡驱动。(该提示说设置在"设置 › 其他",但 实时预览渲染引擎 实际位于 高级 页面。)

设为 CPU 后仍然黑屏?那就是相机本身的问题——请看下面的条目。

应用设置的高级选项卡,包含实时预览渲染引擎、视频播放引擎、错误处理和计算设备
高级 选项卡:实时预览渲染引擎(黑屏预览)、视频播放引擎(高帧率视频)和 计算设备。
提示"未检测到相机",或设备列表中没有相机

原因:相机未开机、未连接、类型选错,或在列表加载后才接上。

解决:

  1. 打开 设置 › 硬件,确认 相机 1 的 状态 已开启。
  2. 确认 类型 与你的相机一致:网络摄像头、Canon、GoPro,或(自 5.9.4.0 起)Nikon、Sony。
  3. 检查线缆并确认相机已开机,然后点击设备列表旁的刷新图标。换一个 USB 接口和线缆试试——避免使用过长的 USB 延长线和无供电的集线器。
  4. 关闭可能正在使用同一相机的其他程序(视频通话软件、Windows 相机应用;Canon 还包括 EOS Utility 或 Camera Connect),再试一次。
  5. 重启 Q-Booth,然后重启电脑。

更新后网络摄像头一直停在"正在加载相机",而 Windows 相机应用却能用:已在 5.5.3.1 修复——更新后在 配置 中重新选择 分辨率。帧率极高的相机(部分虚拟摄像头)导致网络摄像头设置窗口卡死的问题已在 5.6.0.2 修复。

更多:相机设置。Nikon 或 Sony 相机请看下一条。

Nikon 或 Sony:检测不到、不拍照,或提示"电池电量过低"

自 5.9.4.0 起支持 Nikon 和 Sony 相机。完整设置步骤和支持的机型见 Nikon 与 Sony 相机。常见解决方法:

  • 检测不到:打开相机电源,检查线缆,并关闭 Nikon 或 Sony 的相机软件。Sony 相机还要在相机菜单中将 USB 连接 设为 PC Remote。
  • Nikon 不拍照:在相机里插入存储卡。
  • "相机忙":稍等片刻再试。
  • "相机电池电量过低,无法实时取景":充电或更换电池,或改用电源适配器,然后点击 Retry。
  • 活动中线缆被拔出:会显示错误。把相机重新插上——Q-Booth 会自动重连,或点击 Retry。
Canon:"相机无响应",或活动中相机卡住

原因:相机自动关机、拍照亭闲置时相机或 USB 进入休眠、电池电量不足,或 USB 线短暂松动。

解决:

  • 把相机的自动关机时间设得长一些;全天活动请使用交流电源适配器而不是电池。
  • 在 Windows 电源选项中关闭 USB 选择性暂停(USB selective suspend),避免 USB 连接休眠。
  • 使用质量好、插紧的 USB 线。
  • 活动中出现"Camera connection lost. Reconnecting...":重新插好线缆;相机恢复后 Q-Booth 会自动重新连接。如果相机框上出现 重试,点击即可。
  • "The camera connection could not be closed cleanly and is now stuck…"(新版文字:"The camera connection is stuck. Unplug the camera's USB cable…"):拔下相机的 USB 线再插回,然后关闭并重新打开 Q-Booth——重启后相机即可恢复工作。自 5.9.5.0 起,活动中应用会在两位宾客之间自动完成这次重启,并直接回到 Event。只有在 10 分钟内再次卡住时,提示才会一直留在屏幕上。

如果卡住的提示反复出现,说明 USB 连接在断断续续。笔记本电脑上常见:重新插拔后相机能用,过一阵又坏了。

  • 把线缆直接插在电脑上,不要经过集线器(Hub)。
  • 笔记本电脑保持插着充电器。
  • 相机使用交流电源适配器供电,并关闭相机的自动关机。
  • 关闭 Windows 的 USB selective suspend(USB 选择性暂停)。

拍照亭闲置后卡在"connecting to camera...":自 5.0.1.0 起 Q-Booth 会自动重试。拍照时应用卡死(常见于拍条状照片中途)的问题已在 5.3.0.0 和 5.3.1.0 修复。如果版本较旧,请更新。

Canon:实时取景和测试拍摄都正常,但 Event 相机页上每次拍摄都失败

现象:先显示“保持姿势…”,然后没有反应,接着提示“相机无响应”。自 5.9.0.0 起,提示也可能是“相机在切换到拍照设置时停止响应……”。

原因:选择 实时取景模式 › 使用独立设置 时,Q-Booth 会在每次拍摄前把相机切换到拍照设置,而这一切换可能在 Event 的相机页上卡住(在 EOS 700D 上出现过)。这是 Q-Booth 的问题,不是相机故障,已在 5.9.0.0 修复。

解决:

  1. 更新 Q-Booth。
  2. 如果是旧版本,或更新后仍然出现:关闭并重新打开 Q-Booth——卡住的相机需要重启才能恢复。
  3. 如果再次出现,把 实时取景模式 设为 使用拍摄设置。如果之后实时取景显得太暗,请给宾客加一盏常亮灯。
Canon:"No Canon camera available…"

原因:相机未连接,或被其他应用占用。

解决:关闭 EOS Utility、Camera Connect 等类似应用,检查 USB 线,将相机关机再开机,然后点击刷新图标。

闪光灯不闪:在 配置 中开启 外置闪光灯模式。按闪光灯设置曝光后实时取景太暗:实时取景模式 › 使用独立设置。

Canon:提示相机发送了无法读取的 RAW / HEIF 文件

原因:相机设置为保存 RAW 或 HEIF。

解决:在相机自身的菜单中把图像画质设为 JPEG,然后重新拍摄。

Canon:无法从 Q-Booth 调整 ISO、光圈或快门速度

原因:相机模式转盘处于全自动档,会拒绝手动指令。转盘位置也会限制可调项(Av 档只能调光圈,Tv 档只能调快门,M 档两者都可以)。

解决:把模式转盘转到创意或手动档(例如 M),然后重新打开 配置。

如果在不支持的机身上选择开尔文白平衡,Q-Booth 会自动改为自动白平衡并提示你——这是正常现象。

Canon:开尔文白平衡不起作用

现象:无论设置多少开尔文值,照片和实时取景的颜色都不变(例如在 EOS 60D 上)。

原因:这是一个程序问题——Q-Booth 从未真正把相机切换到色温模式,反而是选择 Shade 才做到了这一点。已在 5.8.2.0 修复,但自定义开尔文值直到 5.9.0.0 才真正作用到照片上。

解决:更新到 5.9.0.0 或更高版本,然后在 配置 中检查一次白平衡。旧版本的变通方法:先在相机机身自己的菜单里设好开尔文值,再在 Q-Booth 中选择 Shade——在旧版本中,正是这个选项会让相机进入开尔文模式,并使用机身上设置的数值。

Canon:倒计时结束了却没有拍下照片(“无法拍摄照片”)

原因:相机拒绝了这次拍摄。自 5.8.0.0 起,相机框会变成黑色错误框:无法拍摄照片、错误代码,以及用通俗语言写的原因。它会一直显示,直到有人点击 [ 继续 ],重新拍摄这一张;条状照片中之前拍好的照片都会保留。联系技术支持时,请拍下屏幕。

最常见的原因:

  • 镜头处于收回状态(代码 0x8D0F)——RF-S 18-45 等套机镜头收纳时会缩回。转动变焦环,直到镜头伸出并解锁。
  • 无法对焦(0x8D01)——对准有反差的物体,或把镜头切到 MF。在部分机身上(见于 R100),对焦失败之后可能导致相机卡死、应用重启;自 5.9.6.1 起,对焦失败后 Q-Booth 会释放相机以避免这种情况。如果经常对焦失败,仍需要改善光线或对焦设置。
  • 没有存储卡、存储卡被锁定或损坏(0x8D06 – 0x8D08)。
  • "Can't take a photo in its current state"(0x8D0C – 0x8D0E)——相机处于短片模式,或开启了 外置闪光灯模式 却没有接闪光灯。

5.8.0.0 之前,Event 画面上什么也不显示(镜头收回时,Canon 配置 的测试拍摄显示"UNKNOWN_ERROR_0x00008D0F"),原因只记录在 log\canon\canon_log_<日期>.txt 中(查找 TakePicture result)——请更新。冻结画面 拍摄模式可以绕过此问题,因为它从不按下快门,但保存的是实时取景画面(画质较低),所以还是应该把相机问题解决掉。

Canon:闪光后过了几秒才拍下照片,宾客已经动了

原因:相机快门反应慢,通常是在昏暗的场地里自动对焦来回寻找。EOS 1100D 等较旧的机身每张可能都要约 3 秒。

解决:给宾客补光,或在对准宾客站立的位置后把镜头切换到手动对焦(MF)。

自 5.8.1.1 起,相机仍在忙时会显示“保持姿势…”。自 5.8.2.0 起,它是相机页上独立的 保持姿势提示 元素,有自己的大小、字体和颜色;该元素的 延迟显示 决定提示多快出现,用眼睛图标隐藏即可关闭。(在 5.8.1.1 中它显示在倒计时框里:相机页 › 等待相机时显示提示。)

“保持姿势…”字太小,看不清

原因:在 5.8.1.1 中,这条提示被挤在倒计时框里。

解决:更新到 5.8.2.0 或更高版本,然后在相机页选中 保持姿势提示 元素,调大字号。也可以设置自己的文字、颜色和背景,并移动或调整它的大小。

每次拍摄后,照片上会闪过一个旋转图标

原因:这是照片准备期间显示在定格画面上的加载图标。照片很快就准备好时,图标只会一闪而过。

解决:更新到 5.8.2.0 或更高版本。默认情况下,只有照片准备超过 1 秒时图标才会出现。如需调整:相机页 › 页面 标签页 › 准备照片时显示加载图标——将其关闭,或调高 延迟显示,让它只在照片确实很慢时出现。

闪光后画面又回到实时取景,照片要过好几秒才出现

原因:版本较旧。宾客还没看到照片就走开了。

解决:请更新。自 5.8.1.0 起,画面会定格在拍摄瞬间并显示加载图标,单反照片也会快得多;自 5.8.1.1 起,带相机滤镜的照片也会更快准备好。

Canon:“照片无法保存到这台电脑”(旧版本:程序以“SDK Error: 0xA8”关闭)

原因:照片已从相机传出,但无法写入电脑。通常是磁盘已满、杀毒软件或 Windows 的 Controlled folder access 阻止了本程序的文件夹,或传输途中 USB 线松脱。

解决:释放磁盘空间,在杀毒软件中允许 Q-Booth,并重新插好数据线。然后点 继续 重拍这一张。

5.8.1.1 之前,这种情况会弹出“Fatal Exception”窗口并关闭程序(SDK Error 0xA8、0xA9 或 0x2A)。请更新以改为显示此提示。

Canon:测试拍摄后应用卡住约一分钟,之后又恢复正常

原因:在 Canon 设置窗口中使用很慢的快门速度(几秒)时出现过。目前仍在调查中,在 Event 的相机页上尚未出现过。

解决:目前测试拍摄时请使用正常的快门速度。

GoPro:配对或连接失败

原因:相机未处于配对模式、电脑的蓝牙或 Wi-Fi 未开启,或相机距离太远。Q-Booth 需要 GoPro HERO 9 或更新机型。

解决:

  • 在相机自身的屏幕上让 GoPro 进入配对模式:Preferences › Wireless Connections › Connect Device › GoPro Quik App。保持手机上的 GoPro Quik 应用关闭。
  • 在 Windows 中开启蓝牙。电脑需要蓝牙 4.0 或更新版本,以及一块 Wi-Fi 网卡。
  • 如果 Windows 拒绝该应用访问 Wi-Fi,请在 Windows 设置中允许。
  • 把相机靠近电脑(约 10 米以内)再试;仍失败时,重启相机并重新配对。
  • 测试录制前:给电池充电,并确认相机内已插入 SD 卡。

"实时预览不可用"表示 GoPro 的预览画面没有出来。相机仍然可以录制:准备好后按拍摄按钮,视频会照常返回。活动中的 GoPro 问题(倒计时消失、结果视频卡住、重拍画面错乱)已在 5.0.1.2 修复。

GoPro:连接 GoPro 后拍照亭断网

原因:用于 GoPro 的那块 Wi-Fi 网卡被专门用来连接相机的热点。

解决:为拍照亭准备第二条网络连接——网线,或在 WiFi 适配器 中选择的第二块 Wi-Fi 网卡——用于 Web QR、邮件和 AI Online。

活动中:相机页面打开很慢,或没有"切换摄像头"按钮
  • 提前连接摄像头(Event 的 常规 › 设置 › 相机,默认开启)会在宾客选择模板时就启动相机,让相机页面立即打开。未使用的相机会在 2 分钟后自动关闭(自 5.6.0.2 起)。
  • 只设置了一台相机时,切换摄像头 按钮会自动隐藏。
  • 倒计时停在第一个数字,或在较慢的电脑上中途停止的问题,已在 5.1.2.2 和 5.2.0.0 修复。

如果相机在其他 Windows 应用中可用、在最新版 Q-Booth 中却不行,或者线缆和电源都良好却反复断开,请联系技术支持。请先导出日志——其中记录了每次相机连接和拍摄的时间线。

最终照片是镜像的(文字是反的)

原因:实时预览特意做了镜像,让宾客感觉像在照镜子,结果也跟着镜像了。

解决:在 配置网络摄像头(或 Canon 设置)中,保持镜像的 方向 用于预览,并勾选 翻转结果图片,让最终照片方向正确。

照片画质差、发软或模糊

可能的原因(按常见程度排列):

  1. 网络摄像头分辨率太低:在 设置 › 硬件 › 配置 › 分辨率 中,选择相机能稳定输出的最大分辨率。
  2. Canon 设成了 Freeze Frame:在 Canon 的 配置 › 高级设置 › 拍摄模式 中改用 Quick Shoot。Freeze Frame 保存的是实时取景画面,画质较低。同时把相机本身的 JPEG 尺寸设为最大。
  3. 失焦或运动模糊:这是相机的问题,不是 Q-Booth——检查对焦、光线和快门速度。
  4. 图片质量设置:设置 › 其他 › 图片质量。Optimal (85) 用于普通打印已经完美;High (92) 适合 A4 或大尺寸打印。它对文件大小的影响比肉眼看到的差别大得多。
  5. 拼贴画布太小(照片条、多照片版式):画布尺寸就是结果的像素尺寸,而 2:3 Portrait 预设只有 1333 × 2000。在 Collage Studio 中选择 画布 › 自定义尺寸,保持相同比例但放大,例如 2400 × 3600。图层位置保持不变。
  6. 叠加图太小:比打印尺寸小的叠加图会被拉伸。请按打印尺寸制作。
  7. 裁切过多:模板比例与相机画面比例相差很大时,会裁掉大部分画面。请选择接近相机比例的形状。

旧版本:工作室相机照片按预览尺寸保存的问题已在 5.0.1.1 修复,叠加图分辨率变低在 5.5.4.0 修复,Motion 视频有颗粒感在 5.0.1.4 修复。Event 相机页面上的 Zoom to crop 只放大屏幕上的实时预览,不会改变照片。

打印机

打印出多份,或打印了没人要的照片
  • 快速连点打印导致打印多份:已在 5.5.0.0 修复。自 5.8.3.0 起,每次打印后打印按钮还会停用 5 秒。
  • 没人点打印,每张照片都被打印:Event 的 其他 › 打印 中开启了 启用自动打印。
“打印了吗?”——点击打印后看不到任何反馈

Q-Booth 只知道照片已发送到打印机,无法知道纸是否真的出来了(卡纸、缺纸、打印机关机)。屏幕上一闪而过的是 Windows 自己的“Printing page 1”窗口。

  • 打印机离拍照亭较远:在 Event 的 其他 › 打印 中开启 显示"已发送到打印机"提示。每次打印后会出现一条简短提示,确认已发送;5 秒后自动关闭(自 5.8.3.0 起)。
  • 要确认纸是否真的出来了,请查看打印机或 Windows 打印队列。

QR 与分享

Web QR:宾客扫码后打不开,或上传失败

原因:云订阅未生效、FTP 信息有误,或现场网络阻止了上传。

解决:

  1. 打开 设置 › QR 分享。
  2. 云服务方式:查看方式下方显示的订阅状态,点击 ↻ 立即检查(自 5.9.4.0 起;旧版本:点击 检查授权状态)。订阅过期后上传会停止。
  3. FTP 方式:检查账户信息。Result URL(生成 QR 用的公开地址)与 Upload URL 不是同一个地址。
  4. 点击 测试 QR,用手机扫描生成的二维码。
  5. 宾客到场前,在现场网络上再测试一次。

印在照片上的 QR 要等这张照片上传完成后才能打开。如果链接以前能打开、几周后却打不开:云端上传只保留 21 天,之后会被删除。如有需要,请在此之前从会员控制台(Image Gallery › Manage)下载该 Event 的照片。更多:QR 分享设置。

FTP:上传文件到服务器时出错

自 5.8.0.0 起,上传错误提示的下一行会显示 FTP 服务器自己给出的原因。请看这一行:

  • "552 … Disk full"——你的网站主机空间已满。Q-Booth 这边无需修改:删除主机上的旧照片,或向主机服务商申请更多空间。
  • "530 …" / login incorrect——FTP 用户名或密码错误。
  • "550 …" / permission denied——该 FTP 账户没有写入这个文件夹的权限。
结果页上的 QR 一直在转圈

原因:照片仍在上传,或上传卡住了。

解决:

  1. 检查拍照亭的网络。
  2. 几秒后 QR 下方会出现类似 Q-XXXXXX 的短代码——在任务监视器中查找它(见下文)。
  3. 因断网而失败的上传会等待,并在网络恢复后自动继续,即使重启过也一样。上传完成后宾客的链接即可使用。
任务监视器——查看等待中或失败的任务

上传、后台邮件和后台结果都在队列中运行。打开方式:设置 › 其他 › 后台任务 › 打开任务监视器,或在任何地方按 Ctrl + Shift + J。Event 运行期间,只有在 Event 的 常规 › 设置 › 键盘控制 中开启 允许打开 Background Jobs 窗口 时,此快捷键才有效。

  • 状态:等待中(例如在等网络)、运行中、已成功、已终止(多次尝试后放弃)、已取消、已暂停。
  • 最后错误 显示任务失败的原因。解决原因(网络、FTP 密码、订阅)后,用 重试 把 已终止(或 已取消)的任务从头重新发送,并重新计算尝试次数。它会上传到该 Event 自己的云端文件夹。
  • 如果这张照片在此期间已经手动分享过,重试 不会再次上传——任务会直接变为 已成功,并沿用已有的链接。
  • 横幅"队列已暂停 — 没有任务正在被领取。"表示队列已暂停——点击 恢复全部。
  • 搜索 id / token… 可按 Q 代码找到宾客的上传。
  • 在主菜单中显示以便快速访问(设置 › 其他)会在主菜单中显示等待和失败任务的小计数。

如果 Studio 提示正在生成后台结果,请等待,或先在任务监视器中 暂停 队列。宾客弄丢了 QR:打开 Event 相册(或 报告 › 交易记录 › 查看结果),找到该会话,使用 分享 或 合并 QR。

上传失败(已终止)的照片跑到了云端主相册,而不是 Event 的文件夹:在 5.9.6.1 之前的版本中,用相册的 合并 QR 重新生成 QR 时,会上传到账户的主相册。已在 5.9.6.1 修复。旧版本上,任务 已终止 后请改用任务监视器中的 重试,或相册的 分享 › Web QR——两者都会上传到 Event 的文件夹。已经在主相册里的照片会留在那里。

本地 QR:宾客打不开下载页面

原因:本地服务器未运行、手机连在其他网络上,或防火墙阻止了端口。

解决:

  • 如果 Q-Booth 提示"本地 QR 服务器未运行",请在 设置 › QR 分享 › 本地 QR 中选择一个会话并点击 保存设置。点击 检查状态 确认服务器在运行,再点击 测试 QR。
  • 自 5.9.3.0 起,会话列表最上方有 关闭 选项,选中一个会话会立即启动服务器,检查状态 也会说明启动失败的原因——例如端口被其他程序占用:编辑该会话,换一个端口(如 8001)。5.9.3.0 之前没有开关(提示中说"启用本地 QR"):选择会话并保存就会开启。
  • 宾客必须与拍照亭连接同一个 Wi-Fi。在会话中填写 Wi-Fi 名称和密码,二维码即可帮宾客自动连网。如果电脑的 IP 地址变了,请在会话中重新检查。
  • 拍照亭电脑可以用网线连接同一台路由器——这样没问题。但如果手机连的是路由器的访客网络,或路由器开启了 AP / 客户端隔离,手机就无法访问电脑。
  • 确认 Windows 防火墙没有阻止本地 QR 端口(默认 8000)。

iPhone 无法保存视频,或 Safari 不停重新加载:已在 5.9.3.0 修复——请更新。现在本地 QR 会打开一个带 Download 按钮的页面,视频在 iPhone 上也能正常播放。视频会存到文件(Files)应用的“下载”中;点开视频,再点 Share › Save Video 即可存入相册。旧版本中,安卓手机可以保存,或者改用 Web QR。

邮件

结果邮件发不出去或收不到

原因:未设置邮件账户、Web QR 不可用、SMTP 信息有误,或现场网络屏蔽了 SMTP 端口(587 / 465)。

解决:

  1. "未设置邮件账户":在 设置 › QR 分享 › 邮件分享 中选择 方式 和账户,然后点击 保存设置。
  2. 邮件中带的是照片链接,所以 Web QR 也必须能用。
  3. 在 测试发送 旁输入你的邮箱并点击。失败时会显示原因。检查收件箱和垃圾邮件文件夹。
  4. Gmail / Yahoo 出现"authentication"错误:请使用应用专用密码(App Password,需要账户开启两步验证),而不是普通密码。
  5. 如果 SMTP 只在现场失败,换个网络试试(手机热点),或把 方式 改为 Qbooth 云服务(需要有效订阅——状态显示在方式下方,点击 ↻ 可重新检查;旧版本:检查授权状态)。
  6. 宾客没收到邮件:请对方检查垃圾邮件文件夹,并在 报告 › 联系人 中核对他输入的地址。

宾客邮件在后台发送。断网时邮件会等待,网络恢复后再发出——可在 任务监视器 中查看。

宾客没有发送邮件的选项

原因:没有"启用邮件"开关——邮件是通过按钮提供的。

解决:在 页面设计器 中,把 分享:邮件 按钮(5.8.0.0 之前叫 发送邮件),或勾选了邮件的 分享 按钮,放到结果页上,并确认设置中已配置邮件分享。

短信

短信(Twilio):短信发不出去或收不到

自 5.9.2.0 起,短信通过您自己的 Twilio 账户发送(设置 › QR 分享 › 短信分享 (Twilio))。短信里的链接与 QR 和邮件相同,所以 Web QR 也必须能用。请逐项检查(错误信息为英文,与应用中显示的一致):

  1. 在该卡片中点击 测试发送,发到你手边的手机。失败时会显示 Twilio 自己的错误信息。
  2. "Twilio 572006" / "Trial accounts can only use predefined SMS templates":Twilio 账户仍是试用账户。试用账户完全无法发送 Q-Booth 的短信,只能发 Twilio 自带的预设短信——请升级账户(在 Twilio 中添加付款信息)。"Twilio 21608":该号码未在账户中验证——在 Twilio 中验证,或升级账户。
  3. "Twilio 20003" / authentication:Account SID 或 Auth Token 有误。从 Twilio Console 首页重新复制这两项。
  4. 测试发送显示已发送,但在美国收不到(连自己的手机也收不到),或美国宾客收不到:该 Twilio 号码尚未获准在美国发短信。在 Twilio 中注册(本地号码用 A2P 10DLC,免费号码用 toll-free verification)并等待批准——在此之前,美国运营商会悄悄丢弃每一条短信。Twilio 的消息日志(Monitor › Logs › Messaging)会显示错误 30032(免费号码)或 30034(本地号码)。
  5. 国家不对:键盘始终使用设置中的 国家区号。号码来自其他国家的宾客无法更改——请改用邮件或 QR。
  6. 拍照亭断网:短信会在 任务监视器 中等待,网络恢复后再发出。被 Twilio 拒绝的短信会在那里显示错误。
  7. 短信发送链接 是灰色的,或宾客没有短信选项:短信分享或 Web QR 未设置,所以 Q-Booth 把它隐藏了。

Twilio 账户的分步设置指南(英文):SMS with Twilio(美国拍照亭:美国版)。

AI Offline

AI Offline 服务器一直显示加载中或红色(离线),或处理时提示服务器不在线

原因:AI 引擎仍在启动(大约需要一到两分钟)、NVIDIA 显卡驱动太旧,或这台电脑无法运行它。

解决:

  1. 活动当天提前打开 Q-Booth,等到菜单底部的 AI Offline 服务器 状态显示 在线。
  2. 如果一直是红色,请先把 NVIDIA 显卡驱动更新到最新版本——从 nvidia.com 下载,或在 NVIDIA 应用中更新。AI 引擎需要 580 或更新 的驱动。然后重启电脑,再重新打开 Q-Booth。驱动过旧是服务器无法启动最常见的原因。
  3. 仍然是红色:双击 AI Offline 服务器 框 › 启动服务器,观察日志。关闭其他占用资源的大型程序以释放内存,并确认没有杀毒软件或安全软件拦截 Q-Booth。
  4. 更新驱动后仍然不在线?在该日志窗口中点击 导出到文件,同时导出应用日志(见下文),把两者一起发给技术支持。
提示

要查看已安装的驱动版本,请打开命令提示符(Command Prompt)并输入 nvidia-smi。第一行会显示“Driver Version”。

AI Offline 需要 Pro 授权和 NVIDIA RTX 显卡。如果 Q-Booth 提示这台电脑无法使用本地 AI 引擎,说明缺少其中一项。

看不到 AI Offline 服务器 框:授权不是 Pro,或应用处于简易模式。AI Offline 中只有 Face Swap:这是 Advanced 授权——其他 AI Offline 模板需要 Pro。

Face Swap 不需要 AI Offline 服务器。AI 太慢?调低 质量 滑块,并在拍照亭电脑上测试。更多:AI Offline Studio。

服务器日志停在“Checkpoint files will always be loaded safely.”,然后显示“Server process exited.”

原因:电脑有 RTX 显卡,但 NVIDIA 驱动对 AI 引擎来说太旧了。需要 580 或更新的驱动。

解决:

  1. 检查驱动:打开命令提示符(Command Prompt),输入 nvidia-smi。第一行会显示“Driver Version”。
  2. 从 nvidia.com 或 NVIDIA 应用为这块显卡安装最新驱动。
  3. 重启电脑,然后重新启动服务器。
服务器日志中出现“Bad git executable”或“comfyui-manager PRESTARTUP FAILED”

无害——直接忽略即可。它从来不是服务器停止的原因。如果服务器无法启动,请看上面的条目。

提示"未检测到 NVIDIA GPU"、"GPU 模式需要一个额外包"或 GPU 无法初始化

原因:计算设备 设为 GPU,但电脑没有 NVIDIA RTX 30 系列或更新的显卡,或尚未安装 GPU 包。

解决:

  1. 打开 设置 › 高级。
  2. 有受支持的 NVIDIA 显卡:点击 下载 GPU 包 并等待完成。否则把 计算设备 设为自动或 CPU。
  3. 点击 保存设置 并重启 Q-Booth——更改在重启后生效。
  4. 点击 测试引擎,确认所有检查都通过。
Face Swap 或 Face Restore 很慢

原因:在处理器上运行,或每张照片都要重新加载引擎。

解决:在 NVIDIA RTX 显卡上使用 GPU 模式(见上一条)。在没有显卡的电脑上,把 引擎启动 设为 保持加载,这样只有第一张照片需要等待。如果更看重速度,可关闭 智能换脸 / 面部修复。参见 高级设置。

Face Swap 失败,或把脸换到了错误的位置

原因:宾客照片中看不到人脸,或人脸顺序与场景不匹配。

解决:

  • 脸换到了别人身上:检查 人脸图片顺序、场景图片顺序 和 映射预览。最简单的方法:在场景图上点击 清除,然后按你想要的顺序依次点击其中的人脸(自 5.6.2.0 起)。
  • 合影中只换了一个人:位置列表太短。使用 1,2,3 / 1,2,3,或点击场景中的所有人脸。场景图中的人脸数量至少要与宾客人数相同。
  • "此图片中未找到人脸":场景图没有清晰的人脸——换一张。
  • 宾客的脸没有被替换:脸部必须清晰可见、面向镜头、没有被手、头发或墨镜遮挡,并且光线充足。

参见 Face Swap。

AI 图片多出了人,或改变了宾客的脸

原因:提示词在描述人物,而不是给出指令。

解决:把提示词写成指令,例如"更换服装……,更换背景……,保持同样的人,不要添加任何人"。参见 编写提示词。

AI Online

提示"… 的 API 密钥未设置"

原因:模板使用你自己的账户(第三方),但所选服务商还没有保存密钥。每个服务商的密钥是分开保存的。

解决:打开 设置 › 常规 › AI Online 服务,在 您自己的 API 密钥 下,把密钥粘贴到对应服务商那一行(fal.ai 或 WaveSpeed——自 5.8.0.0 起两行始终都会显示;旧版本需先在下拉菜单中选择服务商),然后点击 保存设置。也可以把模板改为 内置,用代币支付。参见 AI Online Studio。

提示代币不足,或免费试用代币已用完

原因:内置余额低于模型费用。带视频步骤的模板需要所有步骤的费用总和;中途停止不会扣费。

解决:在 AI Online Studio 中点击 Buy tokens,在你的 lumaqube.com 账户中充值,然后刷新余额。每次活动前都检查一下余额。

活动进行中(自 5.8.0.0 起):错误提示上有 Buy tokens 按钮,点击会显示一个二维码。用手机扫码购买代币,然后点击 重试。宾客的照片会保留,也不需要关闭活动。启动一个使用内置的活动时,如果代币少于 100,会先弹出带 Buy tokens 的提醒;仍可以照常开始活动。

AI Online 处理失败、超时,或无法连接服务器

原因:网络慢或被屏蔽,或模型耗时超过时间上限。

解决:

  • 检查拍照亭的网络连接。
  • 无法建立安全连接:检查电脑的日期和时间,以及杀毒软件或防火墙。
  • 网络较慢时,在 设置 › 其他 中调高 最大超时(默认 180 秒)。
  • 使用自己的密钥:确认服务商账户仍有余额。
  • 添加参考图片后每次生成都因连接错误失败:在 5.9.4.0 之前的版本中,过大的图片会导致这种情况。请改用较小的副本(长边 2048 像素就足够)。自 5.9.4.0 起,较大的参考图片会自动缩小到这个尺寸。
"仍在生成"——要继续等待吗?

这不是错误。提示表示结果花的时间比平时长,但没有失败,仍在生成中。点击 继续等待;停止 会放弃这次结果。

  • 等待上限是 设置 › 其他 › 最大超时(默认 180 秒)。对较慢的视频模型可调高,减少此提示出现的次数。
  • 在后台生成的结果(邮件、QR、人工领取)不会询问——它们会自行继续等待。
  • 5.5.3.1 之前,较慢的模型会在超时后直接失败。请更新。

活动中 AI 模板失败时,宾客会看到 出现问题,并有 重试(使用同样的照片,无需重拍)和 返回主页。先检查网络,再检查代币或服务商余额。不想等待的宾客可以使用 立即扫描 QR 或 邮件 交付方式。

所有 AI Online 提示及处理方法

以下提示按英文界面中显示的原文列出。

提示处理方法
"API key for fal.ai / wavespeed.ai is not set…"设置 › 常规 › AI Online 服务,在对应服务商那一行粘贴密钥(旧版本:先选择服务商),保存设置。每个服务商的密钥分开保存。
"Not enough tokens…"Buy tokens(或 lumaqube.com › Cloud AI › Tokens),然后点击余额卡片上的刷新按钮。活动进行中:点击错误提示上的 Buy tokens,用手机扫码购买,然后点击 重试(自 5.8.0.0 起)。
"…All the steps of this template need N together…"图片 + 视频模板需要预先具备两个步骤的代币。尚未扣费。
"The generation failed (…). No tokens were charged."重试,或换一个模型。
"This template's AI model is no longer available…"服务商已停用该模型。打开模板,选择其他模型并保存。
"…temporarily unavailable…"该模型暂时关闭。稍后再试,或换一个模型。
"This template's AI model needs QBooth X or newer…"(自 5.9.2.0 起)模型本身可用,但这台 Q-Booth 版本太旧。请更新 Q-Booth,或打开模板换一个模型。
模板显示代币卡片,但这台拍照亭没有 内置 | 第三方 这一行,也无法切换到 fal.ai模板是用内置保存的,而这台拍照亭(加密狗)不提供内置。请更新到 5.9.2.0 或更新版本,模板会改为用 fal.ai 打开。旧版本:新建一个模板,把提示词复制过去。
"This booth's licence session is no longer current…"重启应用以重新登录。
"Cloud AI needs a cloud licence. Dongle booths are not supported yet."5.9.6.0 或更早版本的加密狗拍照亭。请更新 Q-Booth(自 5.9.6.1 起加密狗也能使用内置代币),或使用 第三方 并填写你自己的 fal.ai / WaveSpeed 密钥。
"This dongle isn't registered to a lumaqube.com account…"(自 5.9.6.1 起)带上你的加密狗 ID 联系技术支持。技术支持把加密狗登记到你的账户后,按 重试。
"Your token balance is frozen…"联系技术支持。
"Too many generations are still running on this booth…"等其中一个完成。
"Cloud AI is temporarily unavailable…"稍等片刻再试。
"Could not upload the photo. Check the connection…"网络问题——检查连接。
"Could not reach the server…"检查拍照亭的网络,然后重试。
"Could not open a secure connection to the server…"检查网络、电脑的日期和时间,以及会检查网页流量的杀毒软件或防火墙。
"Your free trial tokens are used up…"试用授权——购买正式授权以继续使用内置,或使用你自己的 fal.ai / WaveSpeed 密钥。
"Prompt is empty" / "No dynamic prompt to process"写一段提示词,或用 提示词构建器(基础提示词)或 动态提示词编辑器(动态提示词——5.8.0.0 之前叫 Prompt Builder)来生成。
"Please select a start frame picture in step 2 (Video)…"(旧版本为 "…on the Video Chain tab…";自 5.9.1.0 起)在 变成视频 的第 2 步(视频)中(5.9.5.0 及更早版本为视频接力选项卡)选择一张 起始帧 图片,或把 图片结果作为 改回 首帧。

使用自己的 fal.ai / WaveSpeed 账户时,失败也可能是该服务商网站上的余额用完了——请到那里充值。更多:AI Online Studio。

结果刚好完成时,"Please Wait"窗口卡住了

现象:处理窗口停在最后一行(常见的是"Downloading generated image..."),已用时间也不再走。随后 Windows 显示 Q-Booth 未响应,只能关闭应用。

  • 只有当 设置 › 高级 › 视频播放引擎 为 VLC 时才会发生,而且不是每次都发生。
  • 结果其实已经生成好了。卡住发生在窗口关闭它的加载视频时,与下载无关。

解决:请更新——5.9.5.0 改变了 VLC 视频的关闭方式,应能避免这个问题。旧版本上,把 视频播放引擎 改回 内置 并点击 保存设置;只有需要播放 120 / 240 fps 视频时才保留 VLC。更新后仍然发生,请把日志发给技术支持。

视频播放

高帧率视频(120 / 240 fps)播放变慢或卡顿

原因:内置 播放器会把 60 fps 以上的视频放慢播放。

解决:在 设置 › 高级 中,把 视频播放引擎 设为 VLC,点击一次 下载 VLC 包,然后保存。

注意

VLC 视频上方无法显示屏幕按钮和对象。如果页面设计中有元素叠在视频上,请保留 内置。

拍照亭画面卡在背景视频或待机视频上

解决:

  • 更新到 5.6.0.2 或更新版本——这个卡死问题已在该版本修复。
  • 按 Shift + F4 退出后重新启动。
  • 把视频换成普通高清尺寸的 MP4(H.264)并测试。4K 或不常见格式的视频全天播放负担很重。
  • 如果同样的视频在其他电脑上播放正常、只在这台电脑上卡住,问题出在这台电脑的视频播放组件——请带上日志联系技术支持(日志中包含这台电脑的显卡和视频播放信息)。

VLC 播放器设置不会改变页面背景视频的播放方式——它们始终使用内置播放器。拼图图层视频(例如 before → after 视频)在结果页显示为空白的问题已在 5.6.1.2 修复。

活动中拍照亭自己重启了(“抱歉,拍照亭需要快速重启一下”)

自 5.8.3.0 起,如果某个页面的背景视频停止播放,Q-Booth 会在两位宾客之间自动重启。这是预期行为——活动会自行继续:

  1. 从那一刻起,页面不再播放背景视频而显示黑色,让正在使用的宾客仍然流畅。
  2. 先让这位宾客完成。拍照亭回到欢迎页后,会显示 抱歉,拍照亭需要快速重启一下 和 立即重启 按钮。30 秒后会自动重启。
  3. Q-Booth 完全关闭、重新打开,并直接回到同一个 Event。10 秒倒计时提供 使用背景视频开始(默认)和 不使用背景视频开始。“不使用”只在这一次运行中把页面背后显示为黑色——下次你自己启动该 Event 时,视频会照常播放。
  4. 重启后,日志会在后台发送给技术支持(没有网络时,在下次启动 Q-Booth 时发送)。其中包含停止的那段视频的额外信息。

为什么:一旦某台电脑上的背景视频停止,这次运行中的所有视频都会停止,应用占用的内存也会越来越多,直到电脑卡死。重启每次都能解决。

如果经常发生:

  • 更新到 5.9.4.0 或更高版本。主要原因已在该版本找到并修复:选择页面上的每张模板卡片都会悄悄创建一个视频播放器(即使卡片只是图片),而且每个播放器都要和 Windows 声音系统通信。接待几百位宾客后,Windows 声音系统停止响应,此后背景视频就无法启动。旧版本上的迹象:重启发生在繁忙使用数小时之后,出现在带模板或类别选择器的活动中,有时电脑的声音也会失效,直到重启 Windows。旧版本上,减少选择页面上的模板可以让它更少发生,自动重启也能让活动继续进行。
  • 自 5.9.4.0 起,Windows 声音系统停止响应时,Q-Booth 也不会再卡在启动画面。旧版本上请重启电脑。
  • 另一个原因已在 5.9.5.0 修复:有些视频(常见于 AI 视频生成工具、手机或录屏软件)循环播放几次后就会停止。这与视频的清晰度或大小无关,而是与视频的保存方式有关。迹象:即使没人使用,拍照亭也会重启;总是同一个背景视频;在 5.9.4.0 上也会发生。自 5.9.5.0 起,这类视频可以安全循环:Event 在保存或启动时会自动把它们转换一次,因此第一次启动可能多花几秒。旧版本上请更新,或者在该页面换一个背景视频,或者用 HandBrake 之类的转换工具重新保存视频(默认设置即可)后重新选择。
  • 更早的一个原因已在 5.9.0.0 修复:实时相机预览每接待一位宾客都会残留一点显存,长时间活动会慢慢拖垮显卡,直到背景视频停止。自 5.9.0.0 起预览会被重复使用。
  • 在仍频繁发生的旧版本上:把 设置 › 高级 › 实时预览渲染引擎 设为 CPU,然后点击 保存设置。CPU 预览不会这样累积,但会占用更多处理器——请确认预览仍然流畅。
  • 在活动现场,选择 不使用背景视频开始,或把页面背景换成图片,并把日志发给技术支持。

内存重启(自 5.9.0.0 起):如果 Q-Booth 自身占用的内存远高于正常水平(约为电脑内存的一半,最多 12 GB;其他应用不计算在内),拍照亭也会以同样方式重启。之后的倒计时会显示“应用已重启以释放内存”,并且只有 立即运行,因为问题不在背景视频。因内存重启最多每 30 分钟一次。如果活动本身就很吃资源、重启后马上又达到上限,拍照亭会在本次运行的剩余时间内停止检查,而不是再次重启。如果活动中出现内存重启,请把日志发给技术支持。

开关:这两种重启都可以在 设置 › 高级 › 活动期间自动重启 中关闭(自 5.9.0.0 起):背景视频停止时重启 和 内存过高时重启。两者默认都开启——请保持开启。如果关闭视频重启,视频停止后页面会变黑,拍照亭占用的内存会不断增加,直到电脑卡死。

自助机模式与活动运行

无法退出正在运行的活动——按 Esc 没反应

原因:自助机锁定时,Esc 被特意禁用。

解决:按 Shift + F4,或双击屏幕右上角。如果开启了 退出时需要 PIN,请输入 PIN。选择 仅快捷键(仅 Shift+F4) 时,只有键盘快捷键有效。

宾客能退出拍照亭画面

解决:在 Event 的 常规 › 概览 中开启 屏蔽 Alt + Tab、屏蔽 Windows 键 和 退出时需要 PIN。参见 Event 设置。

点击启动后被警告拦下

原因:Event 里没有模板。Event 至少需要一个模板才能运行。

解决:在 内容 › 模板 中添加模板。参见 模板。

拍照亭在错误的屏幕上打开:在 Event 的 常规 › 设置 › 显示 中设置 输出显示器。

启动 Event 时出现"开始之前"窗口

启动 Event 时,Q-Booth 会先检查所有模板(自 5.5.0.0 起)。如果有模板无法在这台电脑上运行,开始之前 会列出原因:

提示行解决
部分模板需要更高级别的授权。Event 中有你的授权不包含的模板(下载的 Event 常见此情况)。移除这些模板,或升级授权。
部分模板使用 AI Online,需要尚未在设置中填写的第三方 API 密钥。设置 › 常规 › AI Online 服务,粘贴密钥。或把模板改为 内置。
部分模板使用的 AI Online 模型目前不可用。打开这些模板,选择其他模型。
部分模板使用 AI Offline,需要的本地 AI 引擎尚未就绪。等到 AI Offline 服务器 显示 在线,再重新启动。

仍然开始 仍会运行 Event。宾客选择这些模板时,会看到说明缺少什么的提示,并停留在选择页面。

电脑没有扬声器(自 5.9.2.0 起):如果 Windows 没有启用任何播放设备,而 Event 又用到声音(背景音乐、页面旁白,或任何带音轨的视频),同一个窗口还会提示这台电脑没有可用的扬声器或声音输出。没有扬声器时,Windows 完全不会播放带声音的视频——画面停在第一帧。没有音轨的视频照常播放,音乐只是没有声音。解决:接上或打开扬声器(或显示器的声音),或在 Windows › 声音 › 播放 中确认有设备已启用。如果拍照亭确实没有扬声器,请使用不带声音的背景视频。仍然开始 仍会运行 Event。

关闭 Q-Booth 后修改不见了

原因:启动 会运行编辑器中的内容,但不会保存。

解决:测试完成后在 Event 编辑器中点击 保存。新建的 Event 在第一次保存前不会写入硬盘。

类别选择器页面没有出现

原因:类别以 作为筛选器 的方式显示在模板选择器中。

解决:在 类别 中把显示模式改为 作为独立页面。参见 类别。

手势控制:握拳没有拍照,或拇指向下没有重拍
  • 握拳没有拍照(自 5.9.0.0 起):确认已开启 使用手势控制(相机页 › 页面标签页),并且视觉包已下载。宾客要站得足够近,让手清晰可见(显示“请靠近一点”表示太远),光线要充足,并且先张开手再握拳。可以用 试一试 测试。手势不支持 GoPro,也不支持 Shoot from the camera。
  • 拇指向下没有重拍:屏幕上必须有 重拍 按钮(重拍次数用完时会隐藏)。拇指要笔直朝下保持 1.5 秒。

参见 页面设计器。

重拍会立刻开始倒计时,宾客还没准备好

默认情况下 重拍 会立即开始倒计时。自 5.8.0.1 起可以修改:在相机页选中重拍按钮,把 点击后 设为 Live View。这样重拍会先回到实时画面,等宾客点击 拍摄 再开始(与 Q-Booth v3 的做法相同)。

重拍只会重拍在查看中显示的那一张,而不是整组——请先滑到要重拍的那张。

相机页上没有出现滤镜条

原因:只有选中 2 个或更多滤镜时才会显示滤镜条。

解决:在模板的 相机滤镜 中,或在模板使用全局滤镜时于 设置 › 叠加和滤镜 › 相机滤镜(5.9.0.0 之前叫 Filter Presets)中,选择 2 个或更多滤镜。自 5.9.0.0 起,带 美颜滤镜 的模板也会显示滤镜条,最前面是 美颜 图块,即使只有 0 或 1 个滤镜。

Payment Gateway(QRIS):拍照亭上的付款提示

自 5.9.0.0 起,应用中的 QRIS 附加功能改名为 Payment Gateway,与 lumaqube.com 上一致。印尼的宾客仍然用 QRIS 码付款。付款记录在 Event 的 报告 › 付款汇总 和 付款 中查看——KIOSK MODE › QRIS 页面已移除。

以下提示按英文界面中显示的原文列出。

提示 / 现象处理方法
"Payment is not available right now. Please ask the staff."授权的 Payment Gateway 期限已结束或被关闭。在 lumaqube.com 上续期——立即生效,无需重启。
"Could not generate a payment code."支付服务无法生成二维码。检查网络,然后在 自助机模式设置 的 Payment Gateway 下点击 Test(旧版本:在 QRIS 页面)。
"This booth's payment account takes <X>, but this event's price is in <Y>"在 自助机模式设置 中点击 本活动改用 <X>,并检查价格。两者一致之前宾客无法付款。
宾客说已经付款,但拍照亭没有开始查看 报告 › 付款 中那个时间的记录(旧版本:KIOSK MODE › QRIS)。状态会显示是否已收到付款。
宾客扫描付款二维码后,手机显示 "This site can't be reached"二维码没问题——是扫码工具用错了。宾客必须在银行或电子钱包应用里面扫码(应用自带的扫一扫 / 付款按钮)。手机相机或 Google Lens 会把二维码当成网址打开,结果是一个打不开的链接。QRIS、DuitNow、PayNow 和 QR Ph 都是如此。

参见 自助机、付款与兑换码。

模板无法打开或无法运行

模板提示及其含义

以下提示按英文界面中显示的原文列出。

提示 / 现象原因与解决
"This template was created in …, not … . Open it from the matching studio instead."该文件属于另一个 Studio。请在提示中指出的 Studio 中打开(或检查文件扩展名)。
"The template '…' this file was saved with is no longer installed."这是用本机没有的 AI 模板制作的 AI Offline 文件。请用 选择 AI 模板 中的模板重新制作。
"'…' is missing its embedded … data — it was saved malformed."Collage / Lenticular / Motion / Flipbook 模板中的某个图层已损坏。重新制作该图层的模板并再次保存。
"Could not read the template: …" / "Could not load template: …"文件损坏或不完整(常因只复制了一半)。从原文件重新复制。
"The template file for this row is missing…"(Event 模板列表)模板文件被移动或删除。从 相册 或 文件 重新添加。
"This template type (…) cannot be processed by this version of the app."模板是用更新的版本制作的。请更新 Q-Booth。
"This template can't be used in an event"文生图 / 文生视频模板不使用宾客照片。请改用使用照片的模板。
"Your current license doesn't allow … templates" / "This AI Offline template needs a Pro license to run."你的授权不包含该 Studio。
"This template's AI model is no longer available."AI Online 模型已停用——请换一个模型。
"The model file needed to run this is missing…"尚未下载 精细 背景移除模型——在背景选项卡中点击 下载模型,或改用 标准。
在 轮播 模板相册中,点一张卡片却选中了旁边那张,或点中间的卡片时它滚走了(开启自动播放时更明显)已在 5.8.0.0 修复。请更新。
模板相册 › 管理文件夹 显示类似 "Access to the path '…\Documents\My Music' is denied" 的错误某个相册文件夹(常常就是 Documents 本身)里有应用无权打开的 Windows 隐藏文件夹。已在 5.9.4.0 修复——会直接跳过该文件夹。旧版本:从相册文件夹中移除 Documents,改为添加一个只放模板的文件夹。
模板用了不该用的滤镜或叠加相框检查模板的 叠加 / 相机滤镜 / QR 叠加;默认 会跟随 Event 或全局设置。

要把 Event 迁移到另一台电脑,请使用 Event 的 导出 或 备份,然后在另一台电脑上从文件导入或 从备份恢复。参见 备份与导出。

光栅

光栅打印模糊,或图像之间有重影

原因:LPI 与当前打印机、纸张和光栅片的组合不匹配。

解决:

  1. 针对实际使用的打印机、纸张和光栅片重新进行 间距测试,并以不缩放的方式打印。
  2. 在镜片选项卡中手动把最佳数值填入 LPI——间距测试不会自动填写。
  3. 两张图互变时,保持分隔开启。

每次更换打印机、纸张或光栅片后都要重做间距测试。参见 Lenticular Studio。

性能、存储与相册

长时间活动中 Q-Booth 变慢、卡住或内存不足

快速解决:关闭 Q-Booth 再重新打开。如果电脑本身也很慢,就重启电脑。然后逐一排查原因,避免再次发生。

可能的原因,按常见程度排列:

  1. 版本较旧。Event 编辑器和 AI Online Studio 每打开一次都会多占一点内存,直到应用为释放内存而自动重启——已在 5.9.4.0 修复;旧版本上,长时间编辑后请关闭并重新打开 Q-Booth。长时间会话中内存不断累积、可能拖慢拍照亭或以内存不足提示关闭的问题,已在 5.6.1.1 修复。背景视频卡住导致画面冻结的问题已在 5.6.0.2 修复,应用开得越久 Event 越慢的问题已在 5.3.0.0 修复。请更新。
  2. 超大的叠加或相框图片。尺寸巨大的相框 PNG(例如 9600 × 14400 像素)每次打开都会占用数百 MB 内存,包含许多这类模板的 Event 可能占满 16 GB 内存的电脑。叠加和相框按打印尺寸制作即可,不要更大——4R / 4×6 打印约 1200 × 1800 像素(300 dpi)或 2400 × 3600 像素(600 dpi)就足够了。
  3. 背景 / 待机视频太多或太大。使用普通高清尺寸的 MP4(H.264)文件。
  4. AI 引擎占用内存。在 设置 › 高级 › 计算引擎 中,预热启动 会预留约 3 GB 显存,CPU 保持加载 会占用约 2.5 GB 内存。这是正常的,可以让 Face Swap 更快;内存紧张的电脑上请使用 自动 / 冷启动(GPU)或 每张照片后释放(CPU)。
  5. 其他程序(浏览器、编辑软件、云同步)在拍照亭电脑上运行。活动期间请关闭它们。

如果在最新版本上,任务管理器中 Q-Booth 的内存随着一位位宾客不断上涨,请带上日志联系技术支持——应用每 5 分钟会把内存用量写入日志。自 5.9.0.0 起,如果 Q-Booth 占用的内存远高于正常水平,拍照亭也会在两位宾客之间自动重启——见 活动中拍照亭自己重启了。

两天活动之间:按 Ctrl + Shift + J 打开 任务监视器,确认没有卡住或失败的任务。活动结束后运行 常规 › 管理 › 备份,再在重复使用前 重置 Event。

使用中 Q-Booth 自行关闭

可能的原因,按常见程度排列:

  1. 长时间活动中内存耗尽——见上一条。
  2. 错误处理设为静默。在 设置 › 高级 › 错误处理 › 静默 下,意外错误会直接关闭应用而不显示任何提示,应用也不会自动重新打开。排查问题期间请改回 显示错误对话框,以便看到(并复制)错误信息。
  3. 实时取景运行时关掉或拔掉了 Canon 相机。旧版本可能会立即关闭;现在的版本会改为显示"Camera connection lost. Reconnecting..."。请更新。
  4. 在部分 NVIDIA 笔记本电脑上,为侧边栏读取显卡使用率可能导致应用关闭,即使在活动进行中。已在 5.9.6.1 修复:活动期间不再读取侧边栏数据;在曾经发生过一次的电脑上,侧边栏从此不再读取显卡,GPU 一行会保持空白。其他一切不受影响:Face Swap、AI 和视频照常使用显卡。

如果出现标题为 Unhandled Exception 或 Fatal Exception 的错误框,请先拍照或截图,再导出日志——每次崩溃也都会写入日志。自 5.9.3.0 起,发生意外错误后应用还会自动把日志发送给技术支持(见 联系技术支持)。

在显卡驱动简陋或缺失的电脑上,Q-Booth 启动时在主窗口出现前自行关闭的问题已在 5.0.0.15 修复(启动时的"Fatal Exception"显卡错误在 5.0.0.14 修复)。最新版本仍出现:请从厂商网站安装显卡驱动,然后带上日志联系技术支持。

希望 Q-Booth 启动时自动重新打开 Event?设置 › 高级 › 应用启动时自动运行 Event。Q-Booth 不会重新打开已关闭或崩溃的应用。它只在几种已知情况下自动重启:活动中背景视频停止时(或自 5.9.0.0 起,内存过高时),见 活动中拍照亭自己重启了;以及自 5.9.5.0 起,显卡驱动停止响应时(见下一条)。

"Graphics Driver Problem"——应用自己重启了

原因:电脑的显卡驱动停止响应,Q-Booth 无法再绘制任何画面。旧版本会在冻结的画面上弹出一排 Unhandled Exception 错误框(文字中提到 UCEERR_RENDERTHREADFAILURE),只能用任务管理器关闭 Q-Booth 再重新打开。

自 5.9.5.0 起,Q-Booth 会改为自动重启:

  • 活动中,它会直接重新打开同一个 Event。10 秒倒计时上显示 The app restarted because the graphics driver stopped responding。
  • 在其他地方,它会回到主界面,并显示 Graphics Driver Problem 提示。
  • 日志会在后台发送给技术支持。
  • 如果重启后 5 分钟内驱动再次出错,Q-Booth 会显示一条提示后关闭,因为再重启也无济于事。请重启电脑。

解决:原因在电脑,而不在 Event。从厂商网站更新显卡驱动——NVIDIA、AMD 或 Intel(笔记本电脑请到笔记本厂商的支持页面)——然后重启电脑。过热、旧驱动或外接显示器线缆松动也会导致驱动重置。更新驱动后仍然发生,请把日志发给技术支持。旧版本上出现那些错误框时,请更新驱动并更新 Q-Booth。

保存或下载失败,提示磁盘空间不足

原因:Event 的结果始终保存在该 Event 自己的文件夹中,位于 Q-Booth 文件夹内——所以会占满安装 Q-Booth 的那块硬盘。在 设置 › 常规 中移动 结果文件夹 只会移动 Studio 的结果,不会移动 Event 的结果。

解决:

  • 备份 该 Event(把 .qeventbak 存到另一块硬盘),然后 重置 Event。
  • Event 的 同时复制到: 文件夹(常规 › 设置 › 文件)可以在另一块硬盘上再保存一份。
  • 每场活动结束后把旧结果复制到归档存储,并删除不再需要的文件。

从云端模板相册下载时也可能提示磁盘空间不足——清理空间后再试。

窗口有一部分无法点击("显示器排列问题")

原因:在 Windows 中,第二台显示器的位置比主显示器高。

解决:在 Windows 显示设置中,把第二台显示器往下拖,直到两块屏幕的上边缘对齐。

授权、安装与启动

提示"此许可证已在另一台设备上激活"

解决:在旧电脑上打开 关于,点击 停用授权。然后在新电脑上激活同一个授权 ID。

旧电脑不在手边?在 lumaqube.com 打开 Licenses & Cloud(原 My Licenses),在该授权的卡片上点击 Deactivate,然后确认。应用最后一次用该授权登录后的 24 小时内,此按钮处于锁定状态(显示"available in N hour(s)")——时间到了会自动解锁。如果旧电脑已损坏且网站不允许停用,或授权为 (Non-Transferable),请联系技术支持。

重要

重装系统或更换主要硬件之前,一定要先停用授权。退出会话 不会释放授权——它只结束这台电脑上的会话。

(Non-Transferable) 授权在同一台电脑上重装 Windows 是例外:只需重新输入授权 ID 即可激活。换到另一台电脑仍会被拒绝——请联系技术支持。少数主板没有唯一 ID 的电脑,重装后仍需技术支持处理。

启动时出现登录窗口,或提示"Failed to Validate License" / "Backdate detected"
  • 登录失败:电脑没有联网。连上网络(只为启动应用的话,手机热点即可),然后点击 登录。如果授权已过期,请在 lumaqube.com 续期(Licenses & Cloud › Renew,或自 5.9.0.0 起使用登录窗口中的 续期授权 按钮),然后再次点击 登录。续期时需要用拥有该授权的账户登录 lumaqube.com(用户名或邮箱均可,也可以用 Google)。续期后授权 ID 不变——不要为了继续租用而购买新授权。
  • "Backdate detected, App Exit":电脑的日期或时间不对。修正 Windows 的日期和时间后再启动。
  • "Failed to Validate License":点击 重试;如果一直失败,重启电脑。授权不会被移除。
  • 再次要求输入授权 ID:更换硬件或重装 Windows 后属于正常情况。重新输入即可。(Non-Transferable) 授权在同一台电脑上重装 Windows 后,也是这样重新激活。
  • "Unable to save license data because access was denied…"(E10):右键点击 Q-Booth › 以管理员身份运行一次。
提示“许可证属于另一台电脑”

原因:该授权是在另一台电脑上激活的——例如从另一台拍照亭复制了应用文件夹或整个硬盘。自 5.9.0.0 起,复制应用或磁盘镜像不会把授权一起复制过来。

解决:在那台电脑上或在 lumaqube.com(Licenses & Cloud › Deactivate)停用该授权,然后在这台电脑上激活。每台拍照亭都需要自己的授权。

提示"无法验证许可证:无法读取此电脑的硬件信息"

解决:重启电脑。如果问题持续,请联系技术支持。

在现场时授权要求联网

原因:云授权保存的会话有效时间有限,会在 Q-Booth 启动时联网续期。

解决:前往无网络的场地前,先在联网状态下打开 Q-Booth(手机热点即可)。如需长时间离线,请向技术支持咨询 USB 加密狗授权。参见 常见问题。

"Windows 正在阻止此应用"——Q-Booth 无法启动

原因:Windows 的智能应用控制(Smart App Control)拦截了 Q-Booth 需要的文件。

解决:点击提示中的 Open Windows Security,选择"应用和浏览器控制" › "智能应用控制设置",将其设为"关",然后重新启动 Q-Booth。

重要

关闭后,除非重装 Windows,否则无法重新开启智能应用控制。

提示"已有另一个实例在运行"

原因:同一时间只能运行一个 Q-Booth,之前的实例可能在后台卡住了。

解决:先找找是否有打开着的 Q-Booth 窗口(任务栏、其他显示器)。如果没有,打开任务管理器,结束所有 Q-Booth 进程,然后重新启动 Q-Booth。如果是在退出正在运行的 Event 后出现,这是已在 5.6.0.2 修复的已知问题——请更新。自 5.8.3.0 起,应用还会确认自己真正关闭了,残留在后台的隐藏实例会在下次启动时被自动结束。

提示"无法读取你的设置文件……设置已恢复为默认值"

自 5.0.1.2 起,Q-Booth 会保留一份设置备份并自动修复;只有备份也损坏时才会出现此提示。

解决:重新检查相机、打印机和 QR 设置。如果之前导出过设置,可在 设置 › 其他 › 备份和恢复 › 导入设置… 中恢复。

“完整性校验失败”——Q-Booth 无法校验其自身文件

原因:应用自身的文件被修改或损坏——常见原因是杀毒软件隔离了某个文件。

解决:使用原始安装程序重新安装 Q-Booth(lumaqube.com 会员区 › Dashboard › Quick actions › QBooth Installer)。如果再次发生,请把 Q-Booth 文件夹加入杀毒软件的例外列表。参见 安装。

更新

更新失败,或没有出现更新提示

以下提示按英文界面中显示的原文列出。

提示处理方法
"Could not reach the update server…" / "Update failed: …"检查网络后重试。
"No update package is available for this version. Please reinstall from the latest installer."你的版本太旧,无法打补丁。请从会员区(Dashboard › Quick actions › QBooth Installer)下载最新安装程序并安装。
"The update could not be verified (invalid signature)…"重试。如果反复出现,请用最新安装程序重新安装。
"The updater component (Updater.exe) is missing…"通常是被杀毒软件删除了。重新安装,并把 Q-Booth 文件夹加入杀毒软件的例外列表。
启动时没有更新提示小更新不会弹出提示(自 5.6.0.2 起)——请使用 关于 › 检查更新。Event 运行期间也不会出现更新提示。

更新会保留你的设置和 Event。

仍无法解决?联系技术支持

出现以下情况时,请(带上日志 ZIP)联系技术支持:

  • 按本页步骤操作后,问题在最新版本上依然存在。
  • 应用反复自行关闭或卡死。
  • 相机在其他 Windows 应用中可用,在 Q-Booth 中却不行。
  • 旧电脑已经没有了导致授权无法转移,或授权为 (Non-Transferable)。
  • 代币余额被冻结,或已付款的代币没有到账。
  • Pro 授权、RTX 显卡的电脑上,在 NVIDIA 驱动已更新到最新版本并重启电脑之后,AI Offline 服务器 仍然始终不变绿。请先更新驱动——大多数这类问题都能因此解决(见 AI Offline)。

发给技术支持最有用的就是日志 ZIP。Q-Booth 一直在后台写日志——无需开启任何选项——并保留最近 30 天。

  1. 打开 设置。简易模式下,请先打开左下角的 显示全部设置。
  2. 进入 其他 › 导出日志 并选择时间范围:今天的日志(问题今天发生)、最近 3 天、最近 7 天(本周早些时候发生,或不确定)或 全部日志(技术支持要求全部时)。
  3. 点击 导出日志…,选择 ZIP 的保存位置(桌面最方便)。如果所选时间段没有日志文件,请选更长的范围。
  4. 通过 WhatsApp 把 ZIP 发给技术支持,并附上版本号(关于 › 版本)和授权类型、问题发生的日期和时间、当时在做什么(哪个 Event、哪个模板、哪个按钮),以及错误提示的照片或截图。

更简单:直接把日志上传给技术支持(自 5.8.0.0 起)。导出日志… 旁边有一个 上传到服务器 按钮。它会把同样的 ZIP(按列表中所选的时间范围)直接发送给支持团队——无需查找或附加文件。应用会提示“您的日志已发送给支持团队(包含 N 个文件)。”然后只需在 WhatsApp 上告诉技术支持你已经上传。此功能需要联网,云授权和加密狗都可以使用。出现“上传失败”:检查网络后重试,或使用 导出日志… 手动发送 ZIP。

技术支持也可以在他们那边为某个授权开启自动上传。开启期间,应用每天在当天第一次启动时自动发送所选时间范围的日志,你无需做任何操作。支持人员处理完后会再把它关闭。

发生意外错误后,应用也会自动把日志发送给技术支持(自 5.9.3.0 起)——如果出现错误提示,会立即发送(自 5.9.4.0 起无需先关闭提示);如果应用已关闭,则在下次启动时发送。应用开着时直接关机不会被当作崩溃(自 5.9.4.0 起)。

ZIP 中包含:应用做了什么以及何时做的(启动、Event 会话、相机连接和每次拍摄、视频生成、AI Online 请求、后台上传、更新尝试)、崩溃报告(自 5.9.4.0 起还包括应用崩溃或无响应时 Windows 自己记录的信息)、每 5 分钟一次的内存用量、这台电脑的信息(Windows、处理器、内存、显卡及驱动、视频播放组件),以及一份设置副本。密码和 API 密钥会被移除。不包含你的照片、视频、Event 或模板——如果技术支持需要模板,请单独发送模板文件。导出日志功能自 5.3.1.0 起提供。

如果是 AI Offline 服务器 的问题,请先更新 NVIDIA 驱动并重启电脑(见 AI Offline)。如果仍然失败,再双击 AI Offline 服务器 框 › 导出到文件,一并发送该日志。

WhatsApp Support Group 链接在会员控制台(lumaqube.com › Dashboard › Quick actions)。操作类问题可查阅本帮助中心(会员控制台菜单中的 Help Center 也可进入),里面有分步指南和视频教程。网站上的支持工单已停用。

下一步

仍需要帮助?

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

WhatsApp 联系