第 1

入门

JustMakeQ 是一款多媒体演出控制软件：它在演出过程中按顺序播放一份 "cue" 列表（音频、视频、图像、MIDI、OSC 等），并用 GO 键逐条触发。

安装并启动 JustMakeQ

在你的下载空间中获取与你的系统相符的安装程序并运行。首次启动时会显示欢迎界面：

欢迎界面：新建项目、打开已有项目，或查看最近的项目。

许可证状态显示在标志下方（绿色的"许可证已激活"）。若尚未激活，点击"管理我的许可证"按钮打开激活向导，并使用创建账户时通过邮件收到的 .jmqa 文件。

创建第一个项目

点击"新建 Q"以创建空项目。主窗口随即打开，cue 列表仍为空：

主窗口：顶部为走带控制栏（GO/Stop/Pause），其下为添加 cue 的按钮，左侧为 cue 列表，右侧为检查器。

要添加 cue，请在 "+ Cue" 栏中点击其类型（Audio、Video、Image、MIDI、OSC、PJLink、HTTP、Fade、Play、Pause、Stop、Wait、Group、Sep）。它会立即出现在 cue 列表中：

刚刚添加了一个 Audio cue，在尚未关联文件前显示为红色/橙色。

在列表中点击 cue，即可在右侧的检查器中打开它：所有参数都在此设置，首先是在"设置"选项卡中指定要播放的文件。

选中的 cue：检查器显示其标识（名称、编号、颜色）与时间设置（pre-wait、post-wait、auto-follow/auto-continue）。

启动演出

• 空格 或 GO 按钮：触发播放指针（cue 列表中的橙色三角）所在的 cue，并将指针移到下一条。
• Esc 或 Stop All 按钮：停止当前所有播放。
• P 或 Pause 按钮：暂停所选 cue；Pause All 暂停全部（无默认快捷键）。
• H 或 Set Head 按钮：将播放指针移到所选 cue，但不触发它。
• ↓ / ↑：将播放指针移到下一条/上一条 cue，但不触发。

这些是默认快捷键，可在"首选项 > 键盘快捷键"中自定义。

每个 cue 都可设置启动前等待（pre-wait）和后等待（post-wait，即在勾选"Auto-continue"时下一个 cue 自动衔接前的等待）。"Auto-follow"则不等当前 cue 结束，立即触发下一个 cue。

第 2

偏好设置

工具栏中的"首选项"按钮会打开一个分页对话框，集中管理所有与具体项目无关的设置（硬件、网络、快捷键）。各选项卡详见下文；键盘快捷键另见第 3 章，AI 控制见第 13 章。

常规

主题、视频 GPU 加速、GO 保护（防连按的最小间隔）、Stop All 行为（立即停止或淡出）、cue 列表点击选项、设置导出/导入。

底部的"导出设置..."/"导入设置..."可将与硬件无关的内容（主题、语言、OSC 补丁、服务器、快捷键）保存或迁移到文件中，便于在另一台机器上复制配置而无需逐项重设。各安装环境特有的显示器、声卡与视频投影面绝不包含在内。

Audio > Routing

每个物理输出（声卡）只需声明一次：名称、接口、通道数。

Audio > Patch

每个 patch 通道（用于 Audio cue 的混音器，见第 7 章）可在此自由命名，并路由到 Routing 中已声明输出的实际通道。

Video > Routing

每个物理输出（显示器）只需命名一次；可直接启动校准图（网格、棋盘格等）以确认画面落在正确的屏幕上。

Video > Surfaces

"投影面"将一块矩形区域与 Routing 中声明的输出关联起来，它正是 Video/Image cue 所选择的目标（第 8 章）。"几何"选项卡：

名称、目标视频输出、该投影面专用的校准图、分辨率（含沿用输出分辨率的按钮），以及可跨多个输出的"多屏投影面"选项。

"Warp"选项卡，用于校正投影变形（墙面不平、投影角度）：

变形网格（Linear 或 Bézier 模式）、控制点的行/列数、用鼠标拖动或键盘移动（方向键，配合 Shift 为 10px 步进）、用于整体移动投影面的中心点、滚轮缩放。

OSC > Sortant (Patch)

最多 6 个 patch，每个都有各自的协议、库（目标调音台/软件）、源网络接口、目标地址，以及依协议而定的可选密码。由 OSC cue 使用（第 10 章）。

OSC > Entrant (Serveur)

接收 OSC 指令以远程控制 JustMakeQ（GO、Stop、Pause、下一条/上一条 cue、跳转到指定 cue 编号）。

PJLink

最多可 patch 10 台投影机（名称、源接口、目标地址、端口、可选密码），供 PJLink cue 使用（第 11 章）。"?"按钮可直接在此界面查询投影机状态。

MIDI

最多 4 个输出端口（用于 MIDI cue，见第 9 章）与 4 个输入端口（MIDI Learn 快捷键、调音台），启动时自动打开。

第 3

键盘快捷键

在"首选项 > 键盘快捷键"中可自定义每个快捷键，并提供"MIDI Learn"，用实体 MIDI 控制器（脚踏、控制台面等）操作走带控制。

默认键盘快捷键，其下方为 MIDI Learn 快捷键（点击"MIDI Learn"后发送 CC 或 Note 消息即可绑定控制）。

若自定义设置出现问题，点击"恢复默认"即可一键还原这些原始值。

第 4

界面

主窗口分为三个区域：

自上而下：走带控制栏、添加 cue 栏，以及三个区域（活动媒体、cue 列表、检查器）。

• 走带控制栏（顶部）：GO、Stop All、Pause、Pause All、上一条/下一条导航、Set Head，以及 Inspector、首选项、Console（调音）与 Preview（预览监视）按钮。
• "+ Cue" 栏：每种 cue 类型一个按钮（见第 5 章），以及一个用于锁定 cue 列表拖放的锁（防止演出中误改顺序，但不影响添加新文件）。
• 活动媒体（左上）：实时列出真正在播放的内容，与 cue 列表中指针的位置无关。
• cue 列表（左下）：演出的序列。列包括：#（编号）、Type、Name、Pre/Dur/Post（时间）、循环、标记、Notes。橙色三角表示播放指针（playhead），即按 GO 时将触发的下一条 cue。
• 检查器（右侧）：所选 cue 的设置，分两个选项卡——"标识"（名称、编号、颜色、时间、auto-follow/auto-continue，所有类型通用）与"设置"（因 cue 类型而异，见后续章节）。

"☰ 文件"菜单提供新建项目、打开、保存、创建 bundle（将项目及其媒体整合到一个可移动文件夹中）以及 Coworking 会话...（第 16 章）。"?"菜单可打开帮助、诊断日志与许可证管理。

第 5

cue 类型

JustMakeQ 提供 17 种 cue 类型，每种在 cue 列表中都有各自的颜色，便于一眼识别：

自上而下：Audio、Video、Image、MIDI、OSC、PJLink、HTTP、Fade、Group，各有专属颜色。

• Audio：播放声音文件，支持按通道路由（第 7 章）。
• Video / Image：在投影面上显示，支持几何校正与效果（第 8 章）。
• Stream：在投影面上显示实时网络视频流（第 13 章）。
• MIDI：发送一条或多条 MIDI 消息（第 9 章）。
• OSC：通过预置库或手动发送 OSC 指令（第 10 章）。
• PJLink：控制网络投影机（第 11 章）。
• HTTP：向第三方服务发送网络请求，并提供现成模板（第 12 章）。
• VISCA / ONVIF：控制电动摄像机的 pan/tilt/zoom（第 14 章）。
• Fade：逐渐改变另一条已运行 cue 的音量、不透明度、位置或速度。
• Play / Pause：触发或暂停另一条指定的 cue，而不移动主播放指针。
• Stop：停止指定的某条 cue（若未选择目标，则停止全部）。
• Wait：序列中的简单定时暂停。
• GoTo：将播放指针移到列表中的另一条 cue（循环、分支）。
• Group：将多条 cue 编组，按顺序播放（"Playlist"）或同时播放（"同步"），见第 6 章。
• Sep（分隔符）：cue 列表中的视觉/章节标记，不影响播放；GO 会自动跳过。

第 6

执行演出

播放指针（playhead，橙色三角）在每次 GO 时前进一条 cue。每条 cue 都可设置启动前等待与后等待。"标识"选项卡中的两个复选框控制自动衔接：

• Auto-follow：下一条 cue 立即开始，不等当前 cue 结束。
• Auto-continue：后等待结束后，下一条 cue 自动开始，无需再次按 GO。

已解除激活的 cue（取消勾选"Armed"）遵循与普通 cue 相同的延时，但从不播放其媒体——适合在尚未就绪的视频或音频不被触发的情况下排练，或临时停用某条 cue 而不删除它。其名称在 cue 列表中显示为删除线。

编组：Playlist 或同步

Group cue 可容纳多条子 cue（拖入其中，或选中后通过右键"编组"）。模式在"设置"选项卡中选择：

在此选择编组模式：Playlist（顺序）或同步。

• Playlist（顺序）：子 cue 依次衔接，各自遵守自己的 pre/post-wait。
• 同步：所有子 cue 同时开始。

编组会依其模式在 cue 列表中显示相应颜色，选中后可用 "<"/">" 键展开或折叠。

第 7

Audio cue

Audio cue 的"设置"选项卡可选择文件、设定起止点（仅播放片段）、循环、播放速度，以及到物理输出的路由。

文件、起点/终点、Loop、速度，以及逐通道混音器（Master 与在"首选项 > Audio"中命名的通道）。

• 速度：0.25 倍至 4 倍，音高随之改变（如同变速磁带）——不做音高校正，刻意保持简单。
• Mixer / Routing：每个已配置的输出通道各有一个推子（在"首选项 > Audio > Routing"中命名），另有 Master。"粘贴控制台设置"会沿用在输出控制台上实时调好的电平（第 9 章）。
• 音频效果（位于混音器下方）：低音/高音均衡、压缩器/限制器、16 段均衡器（带专用图形界面）、混响（算法式，非卷积）与延迟——每条 cue 同一时间只能启用一个效果。

以该 cue 为目标的 Fade cue 可逐渐改变正在播放的音量或速度。

第 8

Video 与 Image cue

在触发 Video 或 Image cue 之前，需要在"首选项 > Video > Surfaces"中至少定义一个投影"面"（第 2 章），且该面须关联到 Routing 选项卡中声明的物理输出（显示器）。

有可用的投影面后，Video/Image cue 提供：

文件、目标投影面，以及几何设置（全屏、不透明度、缩放、位置、3D X/Y/Z 旋转）。

• 几何：缩放、位置、3D 旋转、不透明度——均可由 Fade cue 逐渐变化。
• Warp（位于投影面编辑器，"首选项 > Video > Surfaces"，第 2 章）：基于网格的变形，用于校正投在不平整表面或有投影角度的画面。
• 效果（Video/Image 通用，位于"几何"下方）：饱和度、对比度、亮度、黑白、褐色调。
• 播放速度（仅 Video）：0.25 倍至 4 倍，画面与内嵌声音保持同步。

Image cue 与 Video cue 共享相同的几何设置与效果（此处选择了饱和度）。

走带控制栏中的"Preview"按钮会打开一个预览，合成所选输出上当前所有活动媒体，且不会触发任何内容——便于在演出前检查构图。

第 9

MIDI cue 与调音台

MIDI cue 通过已配置的输出端口发送一条或多条消息：

输出端口，以及可自由增删的消息列表（Note On/Off、Control Change、SysEx、NRPN 等）。

端口在"首选项 > MIDI"中声明（最多 4 个输出和 4 个输入）：

输入端口接收 MIDI 指令（MIDI Learn 快捷键、调音台），并在启动时自动打开。

输出控制台

走带控制栏中的"Console"按钮会打开调音台：Master 加 10 个输出通道，带 VU 表与逐推子的 MIDI Learn 分配（用实体控制器操作每个通道）。

"复制设置"会将这些电平应用到所选 Audio cue 的混音器；"全部重置为 0 dB"则把所有推子恢复到中性值。

第 10

OSC cue

OSC cue 向第三方软件或调音台发送指令。"设置"选项卡中有两种模式：

"手动"模式：直接填写 host/端口/OSC 地址，参数（Args）的类型（数字、布尔或文本）会自动识别。

• Patch（预置库）：选择在"首选项 > OSC > 发送"中声明的 patch，然后从已针对目标产品适配的列表中挑选指令（ETC Eos、QLab、Midas/Behringer、grandMA3、Resolume、OBS 等）。
• 手动（host / 直接地址）：用于预置库未覆盖的需求，手动填写 host/端口/地址/参数。

发送 patch 与接收监听服务器均在"首选项 > OSC"中配置：

最多 6 个发送 patch，每个都有各自的协议、库、源网络接口、目标地址，以及依协议而定的可选密码。

JustMakeQ 的默认端口：53025（通用 patch）与 53026（本地接收服务器），特意与 QLab 的默认端口区分开。

第 11

PJLink cue

PJLink 是用于控制投影机的标准网络协议（开机、关机、输入选择、画面静音等）。投影机只需在"首选项 > PJLink"中 patch 一次（10 个槽位）：

为每台投影机设置名称、源网络接口、目标 IP 地址、端口与可选密码。行尾的"?"按钮会直接查询投影机（名称、厂商、型号、电源、当前输入、快门、灯泡、错误）；最近一次查询的时间会一直显示在该列中。

随后 PJLink cue 只需选择一台已 patch 的投影机和一条指令：

cue 会自动重命名，以反映所选的投影机与指令。

第 12

HTTP cue

HTTP cue 向第三方服务发送网络请求（GET/POST/PUT/PATCH/DELETE）——可用于控制几乎任何提供 Web API 的设备或软件（智能灯光、通知、家庭自动化等）。

"产品"再"动作"的级联选择提供现成模板；方法、URL、请求头与请求体仍可自由修改。

已为约十五种常见产品提供预填模板（vMix、WLED、Bitfocus Companion、Philips Hue、Shelly、Home Assistant、Discord、Pushover、ntfy、兼容 PTZOptics 的 PTZ 摄像机等），无需自行编写每条请求。"最近响应"字段实时显示服务器返回，便于在演出前确认请求可用。

"延时后自动重试"选项会在首次发送失败时（偶发网络故障）按所选延时重发一次请求——只有两次都失败，cue 才会进入错误状态。

第 13

实时流 cue（Stream）

Stream cue 在投影面上显示实时网络视频流——可来自提供标准流的 IP 摄像机、编码器或视频切换台。它与普通 Video cue（第 8 章）共享相同的几何设置（位置、缩放、旋转）、视频效果与音频混音（按通道路由、效果），只有信号源不同。

可识别的协议，依所填 URL 的前缀自动检测：rtsp://、rtsps://、rtmp://、rtmps://、srt://、rist://、udp://、rtp://、tcp://，以及用于 HLS（.m3u8）或 DASH（.mpd）流的 http:///https://。

第 14

VISCA 与 ONVIF cue（PTZ 摄像机）

两种专用 cue 可直接从 cue 控制电动 pan/tilt/zoom（PTZ）摄像机，无需第三方软件：移动、变焦、调用与保存预设。

VISCA-over-IP

标准二进制协议，被大多数专业/广播级 PTZ 摄像机采用（Sony 及兼容机型）。每台摄像机只需在"首选项 > VISCA"中 patch 一次（目标地址、端口，默认 52381，VISCA 总线地址 1 至 7），随后每条 VISCA cue 选择一台已 patch 的摄像机与一条指令（四个方向的 pan/tilt 及停止、变焦推进/拉远/停止、home 位置、调用或保存 0 至 127 号预设）。

ONVIF

基于 SOAP/HTTP 的开放标准，广泛用于 IP 监控摄像机及部分广播机型。每台摄像机在"首选项 > ONVIF"中 patch（目标地址、端口、用户名/密码、媒体配置文件与服务路径——需按机型逐一确认，默认值并不适用于所有品牌）。可用指令：连续移动（pan/tilt/zoom 速度可调）、停止、home 位置、调用/保存预设（以自定义名称标识，而非 VISCA 那样的编号）。

第 15

AI 控制（MCP）

JustMakeQ 内置 MCP（Model Context Protocol）服务器，可让兼容的 AI 助手（Claude Code、Claude Desktop、Codex 等）操作已打开的会话：列出、创建、修改或重排 cue，并触发 GO/Stop/Pause。

默认关闭。监听端口（53020）与网络接口（默认 localhost）在此设置，连接所需的访问令牌亦然。

启用服务器后，该选项卡会提供可直接复制的配置示例，适用于主流 AI 客户端（CLI 命令、.mcp.json 文件、config.toml）。

第 16

协作

Coworking 允许多名操作员在不同工位上同时操作同一条序列：由主机真正播放媒体，已连接的客户端实时查看状态（cue 列表、状态、playhead），并可依据各自的权限级别编辑序列或触发走带控制指令。

通过"文件 > Coworking 会话..."菜单使用：可作为主机开启会话，或加入在局域网中自动发现的会话。主机需手动批准每个新连接，并可随时在"协作者"对话框中调整各客户端的权限级别（只读、编辑或完全控制）。

第 17

故障排查

查看日志

"?" > "查看日志..."菜单会直接打开存放日志文件的文件夹，每次启动都会带时间戳。发生崩溃时，该文件夹中会有完整的 Python 异常，或者——若为更底层的（原生）崩溃——一个单独的 *_fault.log 文件，记录故障发生时所有线程的调用栈。在提交支持请求时附上这些文件，能大幅加快诊断。

常见问题

• Video/Image cue 无任何画面：确认其"设置"中确实选择了投影面，并且该投影面在"首选项 > Video > Routing"中关联到了真实的物理输出。
• 没有声音：检查"首选项 > Audio > Routing"中所选的接口，以及该 cue"设置"选项卡中的逐通道路由。
• OSC/HTTP/PJLink 指令未发出："最近响应"字段（HTTP）或主窗口右下角的服务器状态指示可帮助确认网络连接是否真的存在。
• 许可证："?" > "管理许可证"菜单会显示详细状态；若激活时发生网络错误，提示信息现在会指明原因（系统时钟、防火墙、DNS、代理）。

若有本文未涵盖的问题，可通过支持页面直接联系团队。