第 1

入门

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

安装并启动 JustMakeQ

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

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

许可证状态显示在标志下方（绿色的"许可证已激活"）。若尚未激活，点击"管理我的许可证"按钮会在浏览器中打开 license.justmakeq.com：登录（Breizhzion SSO），在仪表盘中复制您的许可证密钥，然后粘贴到应用程序的激活窗口中。

创建第一个项目

点击"新建 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，"Auto-continue"则让下一个 cue 同时开始。

导入 QLab 演出文件

☰ 文件 > 导入演出文件...可以导入在 QLab 5 中制作的演出文件（.qlab5 文件，或自动备份 .qlab5backup），无需手边有 QLab。导入会创建一个以工作区命名的新 cue 列表，并将其设为当前列表：已打开的演出和原始文件都不会被改动。QLab 的 cue 编号会被保留。名称、备注、等待、衔接（auto-continue、auto-follow）、音频与视频 cue（电平、起止点、循环）、Fade、Stop、Play、Pause、GoTo、Wait、OSC、MIDI 以及分组都会被导入。没有对应类型的 cue（标题、摄像机、灯光、脚本等）会以未启用（disarmed）状态保留，并保留其编号和名称。导入结束时会打开一份报告，逐个 cue 说明已导入、部分导入或未导入的情况。媒体先在工作区旁边查找，再到其原始位置查找。

第 2

偏好设置

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

常规

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

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

视频渲染。在 偏好设置 > 常规 > 视频渲染 中，“GPU 加速（OpenGL）” 选项默认不勾选，下次播放时生效。勾选后，渲染经由显卡完成，对同时播放多路视频和 4K 尤其有用。它涵盖表面的几何处理：warp、keystone、edge blending、形状、遮罩（按形状或来自图像）、贴合辅助、球面与 360° 媒体（等距柱状、domemaster，以及球体或圆柱上的双鱼眼）和不透明度淡变，NV12、P010、YUV420P 帧从 YUV 到 RGB 的转换也在显卡上完成。在一台普通电脑（GTX 1060 显卡、i5-9400F 处理器）上实测：启用 warp、keystone、edge blending 和遮罩的 4K 60 帧视频，GPU 渲染下保持在每秒约 58 至 60 帧，软件渲染下为 18 至 23 帧。仍使用软件渲染的情况：cue 的 3D 旋转、文字 cue、视频特效、检查器预览、预览监视器打开期间、设置无法读取的表面，以及 OpenGL 不可用的电脑。选项下方的 “最近一次视频输出：GPU 渲染” 或 “最近一次视频输出：软件渲染”（原因）一行会说明上一次播放时实际发生了什么；若已勾选加速却未被使用，回退的原因也会写入日志（菜单 ? > 查看日志...）。

HDR 视频。JustMakeQ 自身不做任何 HDR 转换：HDR 视频（HLG 或 PQ，BT.2020）由 Qt 自行转换为 SDR BT.709，软件原样显示该结果，软件渲染与 GPU 渲染都是如此。因此输出始终是 SDR（在 Qt 无法使用 OpenGL 的电脑上，Qt 不做转换，视频将不经转换直接显示）。iPhone 的 HDR 视频不再被转换两次，而这曾使画面过暗、饱和度过高。

Audio > Routing

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

Audio > Patch

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

Audio > 输入

最多可命名 5 路实时音频输入，供 In Audio cue（第 15 章）使用。每路输入类型为"设备"（声卡或 USB 调音台输入，包括 Dante Virtual Soundcard 暴露的 Dante 通道，可选择采集通道数）或"NDI"（网络中 NDI 源的音频）。"刷新设备"按钮会重新加载列表并发现 NDI 源。

Video > Routing

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

Video > Surfaces

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

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

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

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

Vidéo > 输入

最多可命名 5 路实时视频输入，供 In Video cue（第 15 章）使用。每路输入类型为"设备"（网络摄像头或采集卡，可选择关联的音频源："（自动）"使用同一设备的麦克风）或"NDI"（网络源，含其内嵌音频）。A/V 同步字段以毫秒为单位对齐音画：负值 = 延迟画面，正值 = 延迟声音，可在 cue 播放时实时调整。输入采用持久标识：拔插设备不会破坏您的 cue。

OSC > Sortant (Patch)

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

OSC > Entrant (Serveur)

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

默认 UDP，TCP 为可选。服务器通过 UDP 接收。如果某个控制器只能通过 TCP 发送，请在 偏好设置 > OSC > 输入（服务器） 中勾选 “同时接受 TCP 方式的 OSC”，然后点击 应用 或 OK：服务器就会同时以与 UDP 相同的端口号监听 TCP。该选项默认不勾选：未勾选时不接受任何 TCP 连接。面板会显示传输方式：“仅 UDP”、“UDP 和 TCP”，或在 TCP 端口已被其他程序占用时显示 “仅 UDP（TCP 不可用：原因）”（此时 UDP 仍正常工作）。OSC 在 TCP 上的两种封装方式，即 OSC 1.0（每个数据包前带有其大小）和 OSC 1.1（SLIP），会按连接自动识别。超过 64 KiB 的数据包会断开连接，同时最多接受 16 个连接。

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 提供 20 种 cue 类型，每种在 cue 列表中都有各自的颜色，便于一眼识别：

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

• Audio：播放声音文件，支持按通道路由（第 7 章）。
• Video / Image：在投影面上显示，支持几何校正与效果（第 8 章）。
• Stream：在投影面上显示实时网络视频流（第 13 章）。
• In Video：显示实时视频输入（网络摄像头、采集卡或 NDI 源），并带有源的声音（第 15 章）。
• In Audio：通过标准路由播放实时音频输入（声卡、USB 调音台、Dante 或 NDI 音频）（第 15 章）。
• Text：在表面上显示带样式的文本，为舞台字幕而设计，支持导入 .srt 文件（第 16 章）。
• 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 的后等待后，下一条 cue 与当前 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 章）：基于网格的变形，用于校正投在不平整表面或有投影角度的画面。
• 球面媒体：360° 视频、Domemaster 或双鱼眼的格式，投射到球体或圆柱上（第 18 章）。
• 效果（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

实时输入（In Video、In Audio）

两种 cue 类型可将实时源引入您的序列。它们播放的不是文件，而是在首选项（第 2 章）中一次性配置的输入，每个 cue 通过名称引用该输入。

Cue In Video

在投影表面上显示实时视频输入：网络摄像头、USB/PCIe 采集卡或网络中的 NDI 源（OBS、NDI 摄像机、移动应用）。界面与 Image cue 相同：表面、时长（0 = 保持至停止）、完整几何（全屏、不透明度、缩放、位置、3D 旋转）、视频效果，并与 Fade cue 兼容。

源的声音（网络摄像头麦克风、NDI 流的内嵌音频）像 Video cue 一样路由：检查器中的主控台 + 每通道推子，播放时可实时调整，并可通过 Fade cue 做音量淡变。

Cue In Audio

通过标准路由播放实时音频输入：任何声卡或 USB 调音台输入、Dante 通道（通过 Dante Virtual Soundcard，它将其暴露为声卡），或仅 NDI 源的音频（此时不传输视频，减轻网络负担）。与 Audio cue 相同的主控台 + 推子、可选时长、通过 Fade cue 淡变。

音画同步

有些源的声音落后于画面（移动 NDI 应用中常见），或者相反。每路视频输入的 A/V 同步字段（首选项 > 视频 > 输入）可延迟其中之一：在 In Video cue 播放时凭听觉调整，效果立即生效。

第 16

Text cue 与舞台字幕（.srt）

Text cue 在投影表面上显示文本：歌剧或外语戏剧的舞台字幕、无障碍、屏幕消息。文本为多行，具有常见样式设置：字体和字号、粗体/斜体/下划线、颜色、高亮（文字背后的颜色）、垂直位置（默认底部、居中或顶部），以及默认透明的背景（此时文本叠加在表面上正在播放的内容之上，例如视频），也可选择您想要的颜色。

每个 Text cue 都有淡入和淡出（默认 1 秒）以及可选时长（0 = 保持至停止）。所有设置在显示期间实时生效。在您重命名之前，cue 的名称自动跟随文本的第一行。

关键行为：在已显示另一文本的位置启动 Text cue 会以交叉淡变替换旧文本。您可以连续切换文本，而无需停止前一个。

导入 .srt 文件

文件 > 导入字幕（.srt）会创建一个组，每条字幕对应一个 Text cue。在控制台，一切用空格键驱动：第一次 GO 显示第一行（播放光标停留在组上），之后每次 GO 以交叉淡变切换到下一行，文件结束后光标继续到下一个 cue。

第 17

时间轴视图

点击工具栏中的“⏱ 时间轴”按钮，会在 cue 列表下方打开演出的时间视图。它是对列表的补充而非替代：用来查看重叠，并调整等待时间。打开或关闭的选择会在下次启动时保留。

如何阅读该视图

cue 没有固定的开始时刻，按下 GO 才开始。因此该视图根据 pre-wait、时长、post-wait，以及 Auto-continue（下一个 cue 同时开始）和 Auto-follow（本 cue 结束后下一个 cue 开始）选项计算得出。每次手动 GO 会结束一个块，并以虚线“GO”条表示。两个块之间的时间，视图不会凭空编造。

标尺

面板栏中的按钮可在“累计时间”与“按块计时”之间切换。累计时间把各块首尾相接放在一条连续标尺上；按块计时则让每个块从零重新开始。累计模式下显示的总计是“最短时长”：它假设每次手动 GO 都毫不迟疑，而真实演出从不如此。同一栏中的缩放与适配按钮可让整个演出适应当前宽度。

轨道、无时长 cue 与分组

各个片段按轨道排列：视频、图像、文本、音频、控制和流程。没有时长的 cue（MIDI、OSC、Stop、GoTo 等）显示为菱形。已解除（disarmed）的 cue 以斜线填充：保留宽度，但不占用时间。循环播放的媒体按一圈的长度绘制。分组会展开为子片段，可像其他片段一样编辑。

屏幕与冲突

每个子行都标注 cue 所显示屏幕的名称。当两个视觉类 cue 同时占用同一块屏幕时，会以红色轮廓、警告三角和面板栏中的计数标出：其中一个会遮住另一个。同一声道上的两个音频会混合，同一投影面上的两个 Text cue 会相互替换，因此这两种情况不算冲突。

调整等待时间

拖动片段主体会改变其进入等待（pre-wait），同一块中后面的内容随之整体移动。拖动右边缘会改变其时长。拖动左边缘会裁掉开头而不移动结尾。操作过程中会有标签显示当前数值。边缘会吸附到同一块内其他片段的边缘，按住 Alt 可关闭吸附。一次完整的操作只需按一次 Ctrl+Z 即可撤销。工具栏中的锁也会保护时间轴：此时面板栏显示“🔒 已锁定”，并拒绝这些操作。

键盘操作

选中该视图后：左右方向键在 cue 之间切换，Home 与 End 跳到两端，Shift + 方向键以 0.1 秒为步进移动，Ctrl + Shift + 方向键以 0.01 秒精细步进，+、- 和 0 键用于缩放与适配。Ctrl + 鼠标滚轮以指针为中心缩放。上下方向键仍用于在 cue 之间导航。双击某个片段，会把应用程序的播放头定位到它上面。

播放期间

播放头是一条绿色线，其小旗位于标尺上，它跟随进度最靠前的那个 cue；虚线标记则指出下一次 GO 将启动的 cue。播放头由正在播放的内容推算得出：没有播放时不显示，循环播放的媒体会让它越过所绘制的片段。在协作模式下，它在客户端电脑上也会同步前进。

第 18

几何、遮罩与 Warp：形状、球体与 360° 视频

这些设置位于“首选项”的“视频”选项卡、“表面”子选项卡中：选择一个投影面，然后打开它的“几何 / 遮罩”和“Warp”选项卡。投影面始终遵循同一路径：图像先经过 Warp 变形，再经过遮罩，只显示形状内的部分。遮罩像图层蒙版一样固定在输出上，从不使图像变形；让图像贴合形状的是 Warp。

投影面的形状

在“几何 / 遮罩”选项卡中，“形状”列表描述你所投影的物体：无（常见的矩形屏幕）、球体、圆柱、矩形、三角形或多边形。多边形有 3 到 12 条边；圆柱可以是立柱（竖直）或横放的管（水平）。

• 大小：宽度和高度为投影面的 5% 至 200%。“比例”在放大时保持宽高比。“规则形状”设置一个占满整个高度的规则形状，“全屏”则居中占满整个投影面。矩形默认全屏；三角形和多边形尖端朝上，从边到边填满其方框。
• 位置与旋转：箭头按 1 像素或 10 像素移动形状，“居中”把它放回中间。旋转范围为 -180° 至 +180°，用于贴合斜放的物体：它旋转的是形状，而不是内容。

遮罩

形状之外的一切在输出上始终为黑色：即使是被 Warp 推到外面的部分，即使在 cue 淡变期间也是如此。“遮罩”列表提供“按形状”（默认）或“来自图像”。

“来自图像”像图层蒙版一样使用一张黑白图像：白色显示，黑色遮住，灰色显示一半，透明区域视为黑色。图像会拉伸到投影面的大小并随其一起保存：它在协作中和另一台电脑上都跟随投影面，无需另带文件。形状和遮罩可以组合：例如，球体配合图像遮罩，可在把视频投进球体的同时裁掉它的底座。回到“按形状”时，图像会保留以备后用。

投影区域外的背景

在 “几何 / 遮罩” 选项卡中，“投影区域外显示黑色（隐藏桌面）” 选项决定可用区域（warp、keystone、缩小的表面）周围显示什么。新建的表面默认勾选该选项：图像之外全部为黑色，cue 的淡变走向黑色。取消勾选后，表面保持透明：淡变走向它后面的内容（桌面或另一个表面），这适用于字幕等叠加式布置。用旧版软件创建的表面保留当时的设置。

Warp 与贴合辅助

在“Warp”选项卡中，网格会让图像变形以贴合形状：可以手动逐点调整，也可以使用“贴合辅助”，从 0%（图像保持原样）到 100%（恰好填满形状）。每次改动都会立即显示，无需“应用”按钮。网格点落在形状上，手动做的调整会附着在对应的点上：改变百分比不会丢失它。0% 时就是常规的 Warp。

球面媒体与 360° 视频

媒体的格式在其 cue（视频、流、图像或视频输入）中的“球面媒体”组、“格式”列表里设置：默认为普通，另有 穹顶母版（一个圆，半球）、等距柱状（覆盖整个球面的 2:1 图像，即 360° 视频的常见格式）或双鱼眼（并排的两个圆，来自双镜头 360° 相机）。选择球面格式后会出现：

• 方向：三个实时滑块，用于选择媒体朝向观众的部分、在球体上把它上移或下移，以及让它绕投影机的轴旋转。
• 镜头（90° 至 250°），用于两种鱼眼格式：拍摄所用镜头的实际视场。
• 镜像：360° 视频或穹顶母版 是为从内部观看（头显、穹顶）而制作的；在球体外表面上，它们会左右颠倒，“镜像”可将其恢复正向。按从外部观看绘制的世界地图则无需翻转：由内容决定。

球面媒体只会在形状为球体或圆柱的投影面上自动投射进形状内；在其他形状上，它会原样通过，只加遮罩。平面视频永远不会被自动转换：要让它弯曲贴合球体，请使用贴合辅助。

测试图和预览会像真实物体一样把形状固定绘制：轮廓，对于球体还有经线和纬线。只有测试图的网格显示 Warp，因此可以看到图像在一个不动的形状下滑动。

导出与导入变形

“导出变形…”会把网格保存为 .jmqw 文件，“导入变形…”则用文件中的网格替换该投影面的网格，也可以是来自另一台电脑的文件。只有网格会被带走：包括列数、行数、插值模式和每个点的位置，但不包括投影面名称、输出、几何参数和 edge blending。导入不会开启 warp：请在检查网格后自行开启。内容不一致的文件会被拒绝并给出提示。

第 19

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）。

第 20

协作

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

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

第 21

故障排查

查看日志

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

常见问题

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

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