阶段 1 / 4

控制与预览

先确定需要的灯光效果，再进入编辑。

设备连接是可选步骤，可以随时添加设备。

布局
紧凑布局 · 所有模块可用
Luma Studio Web/控制面板
演示模式
LUMA · QUICK START

从预览到创作，三步完成

先调整光色，再挑选灯效，最后进入创作工作台；需要真机时可随时添加设备。

YOUR LIGHTING, REIMAGINED

让光，自由表达。

从一束光开始，创造属于你的空间氛围。

灯光控制 LIGHT CONTROL

调整色彩、亮度与动态效果，实时预览变化。

电源
当前灯光静态颜色 · 30% 亮度
LIVE PREVIEW

实时光效预览

离线模拟
YOUR LIGHT SPACE
STRIP A40 PIXELS
STRIP B镜像显示
双层光源模拟 · 与真实硬件效果可能存在差异
当前效果静态颜色
LED40 × 2
刷新30 FPS
QUICK ADJUST

基础调节

当前颜色 / COLOR#6A83FF点击色块自由选色

修改颜色会切换至静态灯光，动态效果请从下方灯效列表选择。

30%
45%

静态颜色无需调节速度

ⓘ 起始亮度预设为 30%，不是硬件限流。使用 USB 供电时，请实际验证电流和温升。
选择与应用灯效和场景集中管理，基础亮度随时可调整
EFFECT LIBRARY

选择灯效

点击灯效即可预览。

添加与管理设备 MY DEVICES

添加局域网设备、连接灯具或管理已保存的设备。硬件配置和维护选项不会影响你的灯效创作。

V1.19.8 · DEVICE MANAGER
CONNECT · STEP BY STEP

连接灯具

先选择连接方式，再确认设备，最后按需设置家庭网络。

未连接
① 选择方式② 连接设备③ 完成设置
连接灯具热点后，点击下方“连接设备”。如已配网，也可输入设备局域网地址。
MULTI DEVICE

我的设备

本机保存 · 最多24台
添加一台设备

保存局域网地址后，即可在下方设备列表中连接。也支持 luma-xxxx.local，无需先连接硬件。

添加后会保存在当前浏览器。请确保电脑或手机可以访问该设备。
USB 未连接
当前设备尚未识别
房间未设置
设备 ID—
型号 / 固件—
本地主机名—
名称和房间会写入设备本地存储；设备 ID 与 .local 主机名保持固定，改名不会影响局域网寻址。
尚未添加设备
批量操作与群控 可选
当前群组全部设备
已选择0 台
同步方式预定时间启动

所有设备须在可访问的同一局域网；这里只能发送基础颜色、亮度、效果命令，不提供精确同步，也不管理远程互联网设备。不同浏览器的列表不自动同步。

像素编辑器 PIXEL STUDIO

逐颗点亮、手绘颜色，打造属于自己的静态灯光图案。

BETA
像素创作工作台

选择工具与颜色 → 绘制灯珠 → 预览 → 应用或保存

准备绘制

绘制只改变当前作品；点击「应用到灯带」才会尝试发送至设备。撤销 / 重做可恢复编辑步骤。

点击或拖动灯珠绘制颜色。离线模式可以直接试用，连接设备后可发送静态像素图案。
像素与画布 · 同一份作品

两处编辑共用灯珠颜色；切换只改变工作区，不会复制或覆盖作品。

颜色已同步
未选择灯珠

拖动可连续绘制；按 Shift 点击选择范围，或开启「选择范围」后依次点击起点和终点。选区填色、擦除各记为一步撤销。

已准备 40 颗像素

灯光画布 VISUAL PIXEL STUDIO

自由绘色、缩放画布、排列像素，让动画和灯珠结构一目了然。

V1.19.24
PHYSICAL LAYOUT PREVIEW

可视化光效画布

可交互画布 · 本地模拟
布局方案

只保存灯珠显示位置，不修改物理接线或灯珠颜色。

当前布局保存在本机
批量排布

自由排布下，使用「框选」圈出灯珠，Shift 可追加；「排布」可整体拖动。只改变显示坐标。

已选 0 个显示位置
横向对齐
纵向对齐等距分布
一键排列所有修改均可使用「撤销排布」恢复
几何变换围绕选区中心 · 越界时整体适配画布
旋转与镜像
精细变换
精确位移

仅处理显示位置，保持 LED 序号、颜色及逻辑映射不变。变换会记录到布局撤销栈。

INTERACTIVE PIXEL CANVAS
灯光设计画布

绘制像素 · 拖动位置 · 实时观察动画

实时预览
同一像素作品

画布绘色实时同步像素编辑器；更改布局不会清除颜色。

准备编辑
点击并拖动画笔给灯珠上色
LUMA STUDIO VISUAL LAB
SELECTED LED选择一颗灯珠
COLOR / HEX—
POSITION—
画布仅编辑可视化映射，不会改变物理接线
精确位置选择自由排布并点选一颗灯珠后，可调整坐标。单选可精确输入坐标，多选可整体拖动或使用方向键。Shift + 方向键每次移动 2.5%。按住 Ctrl/⌘ 滚轮可围绕光标缩放。
快速生成
LAYOUT × ANIMATION · V1.19.26

空间动画预览

支持方向、范围、扩散中心和自定义运动路径。参数仅作用于离线预览，确认后才能生成时间轴。

离线模拟 · 不发送设备
空间运动参数路径、中心与范围仅在本地预览
PREVIEW · LOCAL
0.0 / 4.0s

仅预览，不会修改现有像素、时间轴或实际灯具。

单路 DATA 双面并联时，两面对应位置仍显示相同逻辑颜色，不能独立寻址。生成动画需明确确认，替换之前不会更改已有关键帧；无需连接硬件。

80 逻辑像素（示意）拖动画笔绘制；自由排布下使用「排布」工具移动灯珠。编辑结果可保存为场景。

所有画布布局均为软件显示映射，不修改GPIO或实际接线。单DATA双面并联时两面显示相同数据，不能独立寻址。只有通过对应硬件与固件，才能实现真实双路控制。

灯效合成器 LAYER & MOTION COMPOSER

框选灯珠、叠加图层、绘制渐变与运动轨迹，把静态像素变成可编辑的二维灯光作品。

V1.7
COMPOSITION CANVAS

二维合成画布

选择工具
拖出矩形框选择灯珠
选中灯珠0
图层1
轨迹节点0
预览静止

效果节点 EFFECT NODES

不用写代码，用节点连接颜色、动画、光晕和输出，实时生成可编辑灯效。

UX · V1.19.12
VISUAL EFFECT GRAPH

节点工作台

01 添加节点02 连接线路03 调整参数04 预览并应用
添加颜色与 Output 节点开始制作灯效。
从上方添加节点，或从右侧加载一个官方预设。
节点0
连接0
实时输出未连接 Output

创作流程 CREATE · ANIMATE · SAVE

使用下方「作品传递」统一衔接图层、节点、像素和时间轴。转换前先看预览与目标，不必在页面间反复寻找按钮。

准备创作
选择一种创作方式开始生成动画前会提示是否覆盖已有时间轴，避免误丢作品。

作品传递 CREATIVE HANDOFF

从一个编辑器提取画面，再明确选择去向。图层采用追加，像素采用可撤销替换，时间轴覆盖前二次确认。

V1.19.11
准备预览

选中来源后可以查看采样方式与输出范围。

预览不会修改作品。选择目标后点击传递才会写入。
按当前像素长度进行转换

动画时间轴 ANIMATION STUDIO

选择关键帧 → 调整时间 → 编辑画面 → 更新当前帧 → 预览或保存。支持缩放、复制和防误覆盖。

V1.19.9 · UX
KEYFRAME COMPOSER

逐帧灯光创作

本地创作 · 无需硬件
关键帧 / KEYFRAMES
0.0s / 6.0s
拖动下方滑块定位播放头；点击圆点选择关键帧。放大后可横向滚动时间轴。
关键帧 01已同步当前画面
✦ 每个关键帧记录整条灯带的像素图案。选择关键帧后可回到「像素编辑器」修改，再点击“更新当前帧”。
发送完整动画到 ESP32-C3 并保存：最多 120 个逻辑像素 × 12 帧。固件需运行支持动画接口的 Luma Core V1.2，未烧录新固件时请只使用离线模拟。
设备动画状态：尚未查询

自动化与宏 AUTOMATION & MACROS

把复杂节点封装成可复用 Macro，用参数轨道与曲线编辑器精确控制亮度、速度、色相和节点参数。

V1.16 · CURVES
AUTOMATION LANES

参数自动化

READY
AUTOMATION PLAYHEAD0.0s / 8.0s
添加一条参数轨道，然后在时间游标位置记录关键点。
LIVE AUTOMATION OUTPUT等待轨道
自动化只改变灯效参数，不修改 GPIO / Wi-Fi。可将当前结果烘焙为普通像素 Timeline，继续使用现有 ESP32 动画上传流程。

场景编排与调制 SCENE SEQUENCER

把灯效与完整 Sequence Block 进行嵌套编排，用曲线、调制和层级序列组织更复杂的灯光演出。

NEW · V1.17
SCENE SEQUENCER

灯光场景编排

0 CLIPS
SCENE TIMELINE0.0s / 24.0s
READY
暂无 Scene Clip。
SEQUENCER OUTPUT空白时间段
每个 Clip 保存一份节点图快照；淡入时间会与前一个 Clip 交叉混合。最终可烘焙为普通像素 Timeline。

实时输入 LIVE INPUTS

把麦克风节奏、歌曲能量段落、屏幕颜色与外部控制器作为灯效输入。实际采集需要浏览器授权；离线文件可使用演示输入。

NEW · V1.13
AUDIO REACTIVE

麦克风 / 音频分析

未启动
音量0%
低频 Bass0%
中频 Mid0%
高频 Treble0%
32-BAND MUSIC VISUALIZERPEAK 0%
V1.13 保留 32 段频谱，并新增自适应节拍检测与 BPM 估算。浏览器只会在你授权后读取麦克风；原始音频不会上传。
SCREEN AMBIENCE

屏幕取色 / Screen Sync

未启动
#6A83FF
4-EDGE AMBILIGHT MAP44 zones
SCREENTOP · RIGHT · BOTTOM · LEFT
共享屏幕后只在本机抽样颜色，不保存截图。部分浏览器或 file:// 离线页面可能不允许屏幕采集。
BEAT ENGINE · BPM

节拍检测 / Music Scenes

AUTO · CHILL
—BPM置信度 0%
BEAT
检测节拍0
当前小节
节拍检测使用本机低频能量的自适应阈值，BPM 根据最近节拍间隔估算。复杂音乐、环境噪声或麦克风自动增益可能降低准确度。
MUSIC SECTION ENGINE

音乐段落 / 自动场景切换

INTRO
段落置信度0%
建议场景CHILL
最近变化
INTRO → CHILLVERSE → PULSEBUILD → PULSEDROP → CLUBBREAK → CHILL
V1.14 延续 V1.13 的段落引擎：基于能量、低频、变化率和节拍生成本地启发式标签，用于灯光编排，不等同于专业音频软件对歌曲结构的精确识别。
MIDI · OSC BRIDGE

外部控制 / 专业接口预留

V1.14
MIDI INPUT未连接

Chrome/Edge 等支持 Web MIDI 的浏览器可直接读取 MIDI 控制器。

NOTE ON → BeatCC1 → 亮度CC2 → 速度CC3 → 色相CC4 → Music Scene
最后消息：—
OSC BRIDGE未连接

浏览器不能直接接收 OSC/UDP；这里通过本机 WebSocket Bridge 接入 OSC。

最后地址：—
/luma/brightness/luma/speed/luma/color/luma/scene/luma/beat/luma/effect
OSC Bridge 当前采用 JSON-over-WebSocket 传输：例如 {"address":"/luma/brightness","args":[80]}。它是为后续连接 DAW、TouchOSC、QLab、Node/Python Bridge 等预留的统一接口。

空间灯光画布 SPATIAL LIGHT CANVAS

把多台真实灯具放进同一个二维空间，规划灯光路径并预览跨设备流动效果。

NEW · V1.5
MULTI-DEVICE SPACE

设备空间编排

本地布局 · 群控预览
DESK SPACE拖动设备卡片改变位置 · 点击设备加入/移出灯光路径
设备中心暂无设备。可以载入演示设备，或先在“设备中心”添加 ESP32。
空间设备0 台
路径节点0 个
预计一轮0.0 秒
当前模式平滑流动
ROUTE & SYNC

跨设备路径

V1.7
点击空间中的设备，建立 A → B → C 灯光路径。

V1.7 可直接复用 Composer 的二维轨迹总时长，为空间路径自动计算各设备启动时刻；仍属于预定启动接力，并非毫秒级帧同步。设备必须在当前浏览器可访问的同一局域网。

项目中心 PROJECT MANAGER

管理完整灯光工程、模板、版本快照与可复用素材。工程全部保存在本机浏览器，可导出为 .luma 文件。

V1.19.17 · PROJECT WORKSPACE
CURRENT PROJECT

未命名工程

尚未创建项目 · 当前编辑内容仍保留在浏览器本地

尚未保存本机草稿 · 创建工程后可以保存版本
01 新建 / 打开02 编辑作品03 保存 / 留版本04 导出备份
RECENT PROJECTS

我的工程

0 / 6
还没有保存的工程。
STARTER TEMPLATES

工程模板

LOCAL TEMPLATES

模板只创建软件配置，不会自动改变真实接线。应用前请确认灯珠数量、GPIO 与供电方案。

VERSION SNAPSHOTS

版本快照

当前工程最多保留 5 个本地快照。恢复旧版本前将提示检查未保存修改；恢复后的内容需重新保存。

先保存一个工程，再创建版本快照。
ASSET SHELF

素材与可复用资源

设备0
场景0
节点0
Sequence0
Macro0
QUICK START

第一次使用？3 分钟完成基础设置

选择设备模板 → 检查供电 → 连接设备。普通用户无需先理解 GPIO、GRB 或节点编辑器。

功率与设备诊断 POWER & CHECK

根据逻辑灯珠、并联条数和亮度估算电流；不会读取真实电流。

ESTIMATE ONLY

供电预算估算

非实测数值
物理灯珠总数80颗 LED
当前画面估计电流—安培 (A)
全白理论最大电流4.80安培 (A)
建议起始亮度35%按 15% 余量估算

估算按每颗RGB灯珠三个通道合计最高60mA计算；实际灯珠可能是低功耗型号。未包含主控板耗电、线路损耗及瞬态峰值。软件估算与亮度调节均不能替代电流表、保险及温升测试。
CHANNEL CHECK

RGB颜色与接线自检

手动测试

逐个显示纯红、纯绿、纯蓝，确认灯珠实际颜色是否正确。设备连接后将通过原有HTTP接口切换静态颜色。

设备连接演示模式
灯带数据引脚GPIO4
数据颜色顺序GRB
提示：如果选红色却亮绿色，可在「设备与连接」尝试调整RGB/GRB顺序；更改信号引脚前请先核对接线。
SYSTEM HEALTH

诊断中心

一次检查浏览器能力、工程存储、硬件配置与当前连接状态。结果仅用于排查，不替代电气测量。

—尚未运行
点击“运行完整诊断”生成检查结果。
诊断后会在这里给出可以直接执行的处理建议。