快速参考

查阅键盘快捷键、Q-Booth 文件类型、文件夹结构、输出比例与分辨率以及术语表。

9 分钟阅读 更新于 6 Oct 2026

工作中可能需要查阅的内容都在这里：键盘快捷键、每种 Q-Booth 文件类型的含义、文件的存放位置、标准输出尺寸，以及应用和本文档中使用的术语表。

键盘与鼠标快捷操作

快捷键位置作用
F5Event 列表 / Event 编辑器全屏 启动 Event。
F5Studio 内对测试照片 处理 模板。
F9页面设计器（每个页面）预览 正在设计的页面。
F10页面设计器 › 相机页用示例照片 模拟 一次拍摄流程。
Esc 或点击预览窗口关闭预览。
Shift + F4运行中的 Event退出自助机模式（如设置了 PIN 会要求输入）。此处 Esc 被特意禁用。
双击右上角运行中的 Event退出自助机模式（选择 仅快捷键（仅 Shift+F4） 时无效）。
Shift + F2运行中的 Event打开 Event 相册（需允许相册访问）。
双击左上角运行中的 Event打开 Event 相册（需允许相册访问）。
Ctrl + Shift + J任何位置打开任务监视器（后台上传和处理）。活动运行时，仅在 Event 允许时可用。
Ctrl + V图片来源设为剪贴板时粘贴图片。

文件格式

Event 与设置文件

扩展名内容
.qeventEvent 设计包（页面、模板、类别）——不含统计和照片。通过 导出 Event 生成，通过 导入 打开。
.qeventbak完整的 Event 备份：设计、数据库、拍摄照片、结果和日志。通过 备份 生成。
.qtheme现成的 Event 主题（运行页面的外观）。
.qbset全部应用设置的备份。在 设置 › 其他 中用 导出设置… 生成，用 导入设置… 恢复。

模板文件（每个 Studio 一种）

扩展名Studio
.qsdAI Offline Studio，包括 Face Swap 模板。
.qsoAI Online Studio。
.qspPhoto Studio。
.qscCollage Studio。
.qsmMotion Studio。音乐和素材都存储在文件内，文件可独立使用。
.qslLenticular Studio。
.qsfFlipbook Studio。
.qsg增强现实（AR）Studio。

其他文件

扩展名内容
.cubeLUT 调色滤镜，用于相机滤镜预设。
.png叠加相框、引导图以及其他带透明区域的图片。
.webm透明视频片段（例如特效或 AR 角色），在 设置 › 其他 中用 透明 WebM 转换器 制作。
.zip通过 导出日志 生成的日志压缩包，用于发送给技术支持。

文件夹结构

位于 Q-Booth 安装文件夹内：

文件夹内容
assets\内置素材：Event 主题、LUT 滤镜、纹理、视频、共享媒体和 AI 模板。
events\每个 Event 一个子文件夹，以 Event ID 命名。包含设计、数据库、结果和相机文件夹，以及导出的报告（reports\）。
images\结果、相机照片和剪贴板图片的全局文件夹。
settings\应用配置、界面状态和任务数据库。
log\用于诊断的日志文件。
backup\、exported_event\Event 备份和导出的 Event。
注意

Event ID 在创建 Event 时确定并作为文件夹名称，之后无法修改。结果和相机照片的保存位置可在 设置 › 常规 中更改；每个 Event 还可以设置 外部结果文件夹，额外保存一份副本。

输出比例与分辨率

Event 的比例应与拍照亭显示器的方向一致。它决定所有设计页面的画布，以及使用哪张叠加相框。

比例分辨率（像素）方向
16:91920 × 1080横向
4:31920 × 1440横向
3:21920 × 1280横向
1:11920 × 1920方形
9:161080 × 1920竖向
3:41440 × 1920竖向
2:31280 × 1920竖向
自定义任意尺寸—
提示

叠加相框 PNG 的尺寸最好与该比例的分辨率一致，并在照片显示的位置留出透明区域。

宾客在拍照亭的流程

Event 运行时宾客依次看到的页面：

  1. 欢迎页 —— 宾客按下开始按钮。
  2. 问卷 —— 仅在有正在使用的问卷时出现。
  3. 类别选择器 —— 仅在类别 作为独立页面 显示时出现。
  4. 模板选择器 —— 宾客选择风格。
  5. 相机页 —— 倒计时（如有放置）、拍摄和查看。
  6. 输入页 —— 仅在模板需要输入时出现。
  7. 处理页 —— 正在生成结果。
  8. 结果页 —— 打印、邮件、QR 或重来。

术语表

术语含义
Event一场活动的容器：模板、类别、屏幕设计、分享和统计。在现场启动的就是它。
Event IDEvent 固定的内部名称，用作文件夹名。
Studio制作某一类模板的工作区（AI Offline、AI Online、Photo、Collage、Motion、Lenticular、Flipbook、AR、Automation）。
模板宾客可选择的一种风格，由 Studio 保存为模板文件。
类别一组模板，可作为筛选器或独立页面显示。
模板库内置的现成模板库，可直接添加到 Event。
页面设计器用于设计宾客所见运行页面的编辑器（欢迎页、模板选择器、相机页、结果页……）。
运行 / 自助机模式启动后在拍照亭上全屏运行的 Event。
预览 / 模拟 / 启动测试单个页面 / 用示例照片测试拍摄流程 / 运行真实活动。参见 常见问题。
叠加相框（Overlay）覆盖在最终结果上的相框图片，可按模板、按 Event 或全局设置。
相机滤镜 / LUT宾客可在相机页使用的色调（来自 .cube 文件）或纹理。
引导图（Guide Image）显示在实时预览上方的透明 PNG，帮助宾客摆姿势。
AI Offline在拍照亭电脑本机进行的 AI 处理；需要 NVIDIA RTX 显卡和 Pro 授权。
AI Offline 服务器本地 AI 引擎。其状态（加载中 / 在线）显示在主菜单底部。
AI Online通过在线服务进行的 AI 处理，用内置代币或你自己的服务商账户付费。
内置 / 第三方AI Online 的两种付费方式：Q-Booth 代币，或你自己的 API 密钥。
API 密钥来自你自己 AI 服务商账户的密钥，填写在 设置 › 常规 › AI Online 服务。
GPU 包额外下载的组件，让 Face Swap、Face Restore 和背景替换在 NVIDIA 显卡上运行。
Face Swap把宾客的脸换到场景图中的人脸上。
Face Restore让结果中的人脸更清晰、更干净。
Imagine / Re-Imagine / CompositeAI Offline 模板类型：根据文字生成 / 用提示词改造宾客照片 / 将宾客照片与引导图和背景图合成。
动态提示词随宾客回答而变化的提示词。参见 动态提示词。
Boomerang先正放再倒放的短视频。
光栅（Lenticular）放在棱纹透镜后的打印品，倾斜时画面会变化。
间距测试 / LPI一张校准打印，用来找出适合你的打印机、纸张和光栅片的透镜间距（每英寸线数）。
Flipbook由视频制作的打印小册子，快速翻动即可看到动态。
Web QR通过上传分享：QR 在网页上打开结果。
本地 QR通过拍照亭自己的 Wi-Fi 分享，无需互联网。
结果交付宾客领取结果的方式：Direct、邮件、人工领取。
任务监视器后台任务列表（上传、日志、处理），用 Ctrl + Shift + J 打开。
简易模式 / 专家模式简化的引导式界面，或包含全部编辑器的完整界面。
自助机模式（付款）在会话开始前使用优惠码或付款的拍照亭运行方式。参见 自助机与付款。
Automation无需操作员，把同一个模板应用到放入监视文件夹的每张照片。

下一步

常见问题容易混淆的问题解答。 故障排除解决具体问题。 活动准备清单可打印的准备清单。

仍需要帮助？

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

WhatsApp 联系