故障排除
查找相机、打印机、QR、邮件、AI、视频、自助机、模板、更新、性能和授权问题的原因与解决方法。
遇到问题?在下面找到对应的类别,展开与你看到的情况相符的问题,然后按步骤解决。每一条都包含症状、常见原因和解决步骤,并附有相关文章的链接。
先做这些检查
很多问题在新版本中已经修复,所以请先查看版本:关于 › 版本。如果下面的条目写着"已在 5.x 修复",请先通过 关于 › 检查更新 更新,再尝试其他方法。切勿在活动进行中更新——更新时应用会关闭。
很多问题通过以下快速检查就能解决:
- 修改后是否点击了 保存设置(应用设置中)或 保存(Event 编辑器中)?启动 不会替你保存 Event。
- 有些选项需要重新打开相机页面或重启 Q-Booth 才会生效——该选项下方的说明会注明。
- 找不到这里提到的选项?在应用设置窗口左下角打开 显示全部设置。简易模式在打开它之前会隐藏高级页面。
- 网络是否正常?AI Online、Web QR、邮件、授权登录和更新都需要联网;拍摄、打印、AI Offline、Face Swap 和本地 QR 不需要。
相机
实时预览是黑屏,但仍然可以拍照
原因:这台电脑的显卡无法绘制实时预览。
解决:
- 打开 设置 › 高级。
- 将 实时预览渲染引擎 设为 CPU,然后点击 保存设置。
- 关闭并重新打开相机页面或相机窗口。更改会在下次打开时生效。
启动活动时,Q-Booth 也可能提示未检测到显卡、预览正以 CPU 模式运行。相机仍可正常工作;请从显卡厂商网站安装或更新显卡驱动。(该提示说设置在"设置 › 其他",但 实时预览渲染引擎 实际位于 高级 页面。)
设为 CPU 后仍然黑屏?那就是相机本身的问题——请看下面的条目。

提示"未检测到相机",或设备列表中没有相机
原因:相机未开机、未连接、类型选错,或在列表加载后才接上。
解决:
- 打开 设置 › 硬件,确认 相机 1 的 状态 已开启。
- 确认 类型 与你的相机一致:网络摄像头、Canon、GoPro,或(自 5.9.4.0 起)Nikon、Sony。
- 检查线缆并确认相机已开机,然后点击设备列表旁的刷新图标。换一个 USB 接口和线缆试试——避免使用过长的 USB 延长线和无供电的集线器。
- 关闭可能正在使用同一相机的其他程序(视频通话软件、Windows 相机应用;Canon 还包括 EOS Utility 或 Camera Connect),再试一次。
- 重启 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 修复。
解决:
- 更新 Q-Booth。
- 如果是旧版本,或更新后仍然出现:关闭并重新打开 Q-Booth——卡住的相机需要重启才能恢复。
- 如果再次出现,把 实时取景模式 设为 使用拍摄设置。如果之后实时取景显得太暗,请给宾客加一盏常亮灯。
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 设置)中,保持镜像的 方向 用于预览,并勾选 翻转结果图片,让最终照片方向正确。
照片画质差、发软或模糊
可能的原因(按常见程度排列):
- 网络摄像头分辨率太低:在 设置 › 硬件 › 配置 › 分辨率 中,选择相机能稳定输出的最大分辨率。
- Canon 设成了 Freeze Frame:在 Canon 的 配置 › 高级设置 › 拍摄模式 中改用 Quick Shoot。Freeze Frame 保存的是实时取景画面,画质较低。同时把相机本身的 JPEG 尺寸设为最大。
- 失焦或运动模糊:这是相机的问题,不是 Q-Booth——检查对焦、光线和快门速度。
- 图片质量设置:设置 › 其他 › 图片质量。
Optimal (85)用于普通打印已经完美;High (92)适合 A4 或大尺寸打印。它对文件大小的影响比肉眼看到的差别大得多。 - 拼贴画布太小(照片条、多照片版式):画布尺寸就是结果的像素尺寸,而 2:3 Portrait 预设只有 1333 × 2000。在 Collage Studio 中选择 画布 › 自定义尺寸,保持相同比例但放大,例如 2400 × 3600。图层位置保持不变。
- 叠加图太小:比打印尺寸小的叠加图会被拉伸。请按打印尺寸制作。
- 裁切过多:模板比例与相机画面比例相差很大时,会裁掉大部分画面。请选择接近相机比例的形状。
旧版本:工作室相机照片按预览尺寸保存的问题已在 5.0.1.1 修复,叠加图分辨率变低在 5.5.4.0 修复,Motion 视频有颗粒感在 5.0.1.4 修复。Event 相机页面上的 Zoom to crop 只放大屏幕上的实时预览,不会改变照片。
打印机
打印被裁切、偏移或出现白边
原因:边距或尺寸模式与纸张不匹配,或模板比例与纸张尺寸不一致。
解决:
- 打开 设置 › 硬件,在 打印机 下点击 配置…。
- 检查 纸张尺寸、打印尺寸模式 和 边距。
- 点击 测试打印,反复调整直到测试页正确。
- 确认模板比例与纸张一致(例如 2:3 模板配 4R / 4×6 相纸)。
更多:打印机设置。
打印出多份,或打印了没人要的照片
- 快速连点打印导致打印多份:已在 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 信息有误,或现场网络阻止了上传。
解决:
- 打开 设置 › QR 分享。
- 云服务方式:查看方式下方显示的订阅状态,点击 ↻ 立即检查(自 5.9.4.0 起;旧版本:点击 检查授权状态)。订阅过期后上传会停止。
- FTP 方式:检查账户信息。Result URL(生成 QR 用的公开地址)与 Upload URL 不是同一个地址。
- 点击 测试 QR,用手机扫描生成的二维码。
- 宾客到场前,在现场网络上再测试一次。
印在照片上的 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 一直在转圈
原因:照片仍在上传,或上传卡住了。
解决:
- 检查拍照亭的网络。
- 几秒后 QR 下方会出现类似 Q-XXXXXX 的短代码——在任务监视器中查找它(见下文)。
- 因断网而失败的上传会等待,并在网络恢复后自动继续,即使重启过也一样。上传完成后宾客的链接即可使用。
任务监视器——查看等待中或失败的任务
上传、后台邮件和后台结果都在队列中运行。打开方式:设置 › 其他 › 后台任务 › 打开任务监视器,或在任何地方按 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 和邮件分享都能正常工作。在 Event 设置中,设置好邮件方式之前该选项是灰色的;缺少 Web QR 时会显示警告。当前无法使用的交付方式不会提供给宾客。
解决:在 设置 › QR 分享 中设置并测试 Web QR 和邮件分享。结果始终会进入 Event 相册,所以没收到邮件的宾客仍可以从那里再次获取照片。
邮件
结果邮件发不出去或收不到
原因:未设置邮件账户、Web QR 不可用、SMTP 信息有误,或现场网络屏蔽了 SMTP 端口(587 / 465)。
解决:
- "未设置邮件账户":在 设置 › QR 分享 › 邮件分享 中选择 方式 和账户,然后点击 保存设置。
- 邮件中带的是照片链接,所以 Web QR 也必须能用。
- 在 测试发送 旁输入你的邮箱并点击。失败时会显示原因。检查收件箱和垃圾邮件文件夹。
- Gmail / Yahoo 出现"authentication"错误:请使用应用专用密码(App Password,需要账户开启两步验证),而不是普通密码。
- 如果 SMTP 只在现场失败,换个网络试试(手机热点),或把 方式 改为 Qbooth 云服务(需要有效订阅——状态显示在方式下方,点击 ↻ 可重新检查;旧版本:检查授权状态)。
- 宾客没收到邮件:请对方检查垃圾邮件文件夹,并在 报告 › 联系人 中核对他输入的地址。
宾客邮件在后台发送。断网时邮件会等待,网络恢复后再发出——可在 任务监视器 中查看。
短信
短信(Twilio):短信发不出去或收不到
自 5.9.2.0 起,短信通过您自己的 Twilio 账户发送(设置 › QR 分享 › 短信分享 (Twilio))。短信里的链接与 QR 和邮件相同,所以 Web QR 也必须能用。请逐项检查(错误信息为英文,与应用中显示的一致):
- 在该卡片中点击 测试发送,发到你手边的手机。失败时会显示 Twilio 自己的错误信息。
- "Twilio 572006" / "Trial accounts can only use predefined SMS templates":Twilio 账户仍是试用账户。试用账户完全无法发送 Q-Booth 的短信,只能发 Twilio 自带的预设短信——请升级账户(在 Twilio 中添加付款信息)。"Twilio 21608":该号码未在账户中验证——在 Twilio 中验证,或升级账户。
- "Twilio 20003" / authentication:Account SID 或 Auth Token 有误。从 Twilio Console 首页重新复制这两项。
- 测试发送显示已发送,但在美国收不到(连自己的手机也收不到),或美国宾客收不到:该 Twilio 号码尚未获准在美国发短信。在 Twilio 中注册(本地号码用 A2P 10DLC,免费号码用 toll-free verification)并等待批准——在此之前,美国运营商会悄悄丢弃每一条短信。Twilio 的消息日志(Monitor › Logs › Messaging)会显示错误 30032(免费号码)或 30034(本地号码)。
- 国家不对:键盘始终使用设置中的 国家区号。号码来自其他国家的宾客无法更改——请改用邮件或 QR。
- 拍照亭断网:短信会在 任务监视器 中等待,网络恢复后再发出。被 Twilio 拒绝的短信会在那里显示错误。
- 短信发送链接 是灰色的,或宾客没有短信选项:短信分享或 Web QR 未设置,所以 Q-Booth 把它隐藏了。
Twilio 账户的分步设置指南(英文):SMS with Twilio(美国拍照亭:美国版)。
AI Offline
AI Offline 服务器一直显示加载中或红色(离线),或处理时提示服务器不在线
原因:AI 引擎仍在启动(大约需要一到两分钟)、NVIDIA 显卡驱动太旧,或这台电脑无法运行它。
解决:
- 活动当天提前打开 Q-Booth,等到菜单底部的 AI Offline 服务器 状态显示 在线。
- 如果一直是红色,请先把 NVIDIA 显卡驱动更新到最新版本——从 nvidia.com 下载,或在 NVIDIA 应用中更新。AI 引擎需要 580 或更新 的驱动。然后重启电脑,再重新打开 Q-Booth。驱动过旧是服务器无法启动最常见的原因。
- 仍然是红色:双击 AI Offline 服务器 框 › 启动服务器,观察日志。关闭其他占用资源的大型程序以释放内存,并确认没有杀毒软件或安全软件拦截 Q-Booth。
- 更新驱动后仍然不在线?在该日志窗口中点击 导出到文件,同时导出应用日志(见下文),把两者一起发给技术支持。
要查看已安装的驱动版本,请打开命令提示符(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 或更新的驱动。
解决:
- 检查驱动:打开命令提示符(Command Prompt),输入
nvidia-smi。第一行会显示“Driver Version”。 - 从 nvidia.com 或 NVIDIA 应用为这块显卡安装最新驱动。
- 重启电脑,然后重新启动服务器。
服务器日志中出现“Bad git executable”或“comfyui-manager PRESTARTUP FAILED”
无害——直接忽略即可。它从来不是服务器停止的原因。如果服务器无法启动,请看上面的条目。
提示"未检测到 NVIDIA GPU"、"GPU 模式需要一个额外包"或 GPU 无法初始化
原因:计算设备 设为 GPU,但电脑没有 NVIDIA RTX 30 系列或更新的显卡,或尚未安装 GPU 包。
解决:
- 打开 设置 › 高级。
- 有受支持的 NVIDIA 显卡:点击 下载 GPU 包 并等待完成。否则把 计算设备 设为自动或 CPU。
- 点击 保存设置 并重启 Q-Booth——更改在重启后生效。
- 点击 测试引擎,确认所有检查都通过。
Face Swap 或 Face Restore 很慢
原因:在处理器上运行,或每张照片都要重新加载引擎。
解决:在 NVIDIA RTX 显卡上使用 GPU 模式(见上一条)。在没有显卡的电脑上,把 引擎启动 设为 保持加载,这样只有第一张照片需要等待。如果更看重速度,可关闭 智能换脸 / 面部修复。参见 高级设置。
Face Swap 失败,或把脸换到了错误的位置
原因:宾客照片中看不到人脸,或人脸顺序与场景不匹配。
解决:
- 脸换到了别人身上:检查 人脸图片顺序、场景图片顺序 和 映射预览。最简单的方法:在场景图上点击 清除,然后按你想要的顺序依次点击其中的人脸(自 5.6.2.0 起)。
- 合影中只换了一个人:位置列表太短。使用
1,2,3/1,2,3,或点击场景中的所有人脸。场景图中的人脸数量至少要与宾客人数相同。 - "此图片中未找到人脸":场景图没有清晰的人脸——换一张。
- 宾客的脸没有被替换:脸部必须清晰可见、面向镜头、没有被手、头发或墨镜遮挡,并且光线充足。
参见 Face Swap。
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 会在两位宾客之间自动重启。这是预期行为——活动会自行继续:
- 从那一刻起,页面不再播放背景视频而显示黑色,让正在使用的宾客仍然流畅。
- 先让这位宾客完成。拍照亭回到欢迎页后,会显示 抱歉,拍照亭需要快速重启一下 和 立即重启 按钮。30 秒后会自动重启。
- Q-Booth 完全关闭、重新打开,并直接回到同一个 Event。10 秒倒计时提供 使用背景视频开始(默认)和 不使用背景视频开始。“不使用”只在这一次运行中把页面背后显示为黑色——下次你自己启动该 Event 时,视频会照常播放。
- 重启后,日志会在后台发送给技术支持(没有网络时,在下次启动 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 与当前打印机、纸张和光栅片的组合不匹配。
解决:
- 针对实际使用的打印机、纸张和光栅片重新进行 间距测试,并以不缩放的方式打印。
- 在镜片选项卡中手动把最佳数值填入 LPI——间距测试不会自动填写。
- 两张图互变时,保持分隔开启。
每次更换打印机、纸张或光栅片后都要重做间距测试。参见 Lenticular Studio。
性能、存储与相册
长时间活动中 Q-Booth 变慢、卡住或内存不足
快速解决:关闭 Q-Booth 再重新打开。如果电脑本身也很慢,就重启电脑。然后逐一排查原因,避免再次发生。
可能的原因,按常见程度排列:
- 版本较旧。Event 编辑器和 AI Online Studio 每打开一次都会多占一点内存,直到应用为释放内存而自动重启——已在 5.9.4.0 修复;旧版本上,长时间编辑后请关闭并重新打开 Q-Booth。长时间会话中内存不断累积、可能拖慢拍照亭或以内存不足提示关闭的问题,已在 5.6.1.1 修复。背景视频卡住导致画面冻结的问题已在 5.6.0.2 修复,应用开得越久 Event 越慢的问题已在 5.3.0.0 修复。请更新。
- 超大的叠加或相框图片。尺寸巨大的相框 PNG(例如 9600 × 14400 像素)每次打开都会占用数百 MB 内存,包含许多这类模板的 Event 可能占满 16 GB 内存的电脑。叠加和相框按打印尺寸制作即可,不要更大——4R / 4×6 打印约 1200 × 1800 像素(300 dpi)或 2400 × 3600 像素(600 dpi)就足够了。
- 背景 / 待机视频太多或太大。使用普通高清尺寸的 MP4(H.264)文件。
- AI 引擎占用内存。在 设置 › 高级 › 计算引擎 中,预热启动 会预留约 3 GB 显存,CPU 保持加载 会占用约 2.5 GB 内存。这是正常的,可以让 Face Swap 更快;内存紧张的电脑上请使用 自动 / 冷启动(GPU)或 每张照片后释放(CPU)。
- 其他程序(浏览器、编辑软件、云同步)在拍照亭电脑上运行。活动期间请关闭它们。
如果在最新版本上,任务管理器中 Q-Booth 的内存随着一位位宾客不断上涨,请带上日志联系技术支持——应用每 5 分钟会把内存用量写入日志。自 5.9.0.0 起,如果 Q-Booth 占用的内存远高于正常水平,拍照亭也会在两位宾客之间自动重启——见 活动中拍照亭自己重启了。
两天活动之间:按 Ctrl + Shift + J 打开 任务监视器,确认没有卡住或失败的任务。活动结束后运行 常规 › 管理 › 备份,再在重复使用前 重置 Event。
使用中 Q-Booth 自行关闭
可能的原因,按常见程度排列:
- 长时间活动中内存耗尽——见上一条。
- 错误处理设为静默。在 设置 › 高级 › 错误处理 › 静默 下,意外错误会直接关闭应用而不显示任何提示,应用也不会自动重新打开。排查问题期间请改回 显示错误对话框,以便看到(并复制)错误信息。
- 实时取景运行时关掉或拔掉了 Canon 相机。旧版本可能会立即关闭;现在的版本会改为显示"Camera connection lost. Reconnecting..."。请更新。
- 在部分 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 的 同时复制到: 文件夹(常规 › 设置 › 文件)可以在另一块硬盘上再保存一份。
- 每场活动结束后把旧结果复制到归档存储,并删除不再需要的文件。
从云端模板相册下载时也可能提示磁盘空间不足——清理空间后再试。
结果没有出现在相册中
原因:相册只显示你手动添加的文件夹,不会自动关联 Event。
解决:在相册中点击 管理文件夹 › 添加文件夹,添加该 Event 的结果文件夹(如果 Event 使用了 同时复制到: 文件夹,也一并添加)。更简单的方法:在 Event 编辑器中打开该 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 天。
- 打开 设置。简易模式下,请先打开左下角的 显示全部设置。
- 进入 其他 › 导出日志 并选择时间范围:今天的日志(问题今天发生)、最近 3 天、最近 7 天(本周早些时候发生,或不确定)或 全部日志(技术支持要求全部时)。
- 点击 导出日志…,选择 ZIP 的保存位置(桌面最方便)。如果所选时间段没有日志文件,请选更长的范围。
- 通过 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 版本及屏幕上显示的内容。