open-audiovisual
搜尋 GitHub

Arturia

Arturia MiniLab 3

Arturia MiniLab 3 是 Arturia 的 MIDI 硬體控制器:8 個打擊墊、25 個琴鍵、8 顆旋鈕、1 顆無段旋鈕、4 支推桿、2 條觸控條。

它在 頻道 1、10 送出 彎音、CC、音符,設定檔引用了 3 份出處。 其中 1 個控制項標了未確認:數字是照目前出處的最佳判讀,按「學習」一次就能重新對應。

  • 原廠文件
  • 作者的 TouchDesigner 工具
  • 社群整理
  • 1 個未確認
類型
硬體裝置
廠牌
Arturia
控制項
48 個控制項
訊息種類
彎音 · CC · 音符
MIDI 頻道
1, 10
LED 回饋
不會送出
訊號
midi/minilab3/…
埠名稱比對
/minilab\s*3/i
MINILAB 3MiniLab 3ShiftHoldOct−Oct+PitchModMainKNOBS12345678FADERSS1S2S3S4PADS

在畫面上彈 Arturia MiniLab 3 全螢幕 ↗ 原始 JSON ↗ 全部控制器

拖曳旋鈕和推桿 · 點打擊墊和琴鍵 · 或接上真機按「接上」。除非你加了 MIDI 輸出,否則什麼都不會送出去。

MIDI 實作表

Arturia MiniLab 3 每個控制項送出什麼

直接從設定檔產生,跟畫面上彈的是同一張表。頻道是 1–16,編號是真正的 MIDI 編號。

Arturia MiniLab 3 的 MIDI 實作表
控制項類型訊息頻道編號訊號LED 回饋已確認
Pitch pitch 觸控條 彎音 · 放開回中央 1 0–16383 · 中央 8192 midi/minilab3/pitch — 是
Mod mod 觸控條 CC 1 1 midi/minilab3/mod — 是
Main enc 無段旋鈕 CC · 相對值(offset64) 1 28 midi/minilab3/enc — 未確認
1 knob1 旋鈕 CC 1 74 midi/minilab3/knob1 — 是
2 knob2 旋鈕 CC 1 71 midi/minilab3/knob2 — 是
3 knob3 旋鈕 CC 1 76 midi/minilab3/knob3 — 是
4 knob4 旋鈕 CC 1 77 midi/minilab3/knob4 — 是
5 knob5 旋鈕 CC 1 93 midi/minilab3/knob5 — 是
6 knob6 旋鈕 CC 1 18 midi/minilab3/knob6 — 是
7 knob7 旋鈕 CC 1 19 midi/minilab3/knob7 — 是
8 knob8 旋鈕 CC 1 16 midi/minilab3/knob8 — 是
S1 s1 推桿 CC 1 82 midi/minilab3/s1 — 是
S2 s2 推桿 CC 1 83 midi/minilab3/s2 — 是
S3 s3 推桿 CC 1 85 midi/minilab3/s3 — 是
S4 s4 推桿 CC 1 17 midi/minilab3/s4 — 是
1 pad1 打擊墊 音符 · 力度 10 36 · C2 midi/minilab3/pad1 — 是
2 pad2 打擊墊 音符 · 力度 10 37 · C#2 midi/minilab3/pad2 — 是
3 pad3 打擊墊 音符 · 力度 10 38 · D2 midi/minilab3/pad3 — 是
4 pad4 打擊墊 音符 · 力度 10 39 · D#2 midi/minilab3/pad4 — 是
5 pad5 打擊墊 音符 · 力度 10 40 · E2 midi/minilab3/pad5 — 是
6 pad6 打擊墊 音符 · 力度 10 41 · F2 midi/minilab3/pad6 — 是
7 pad7 打擊墊 音符 · 力度 10 42 · F#2 midi/minilab3/pad7 — 是
8 pad8 打擊墊 音符 · 力度 10 43 · G2 midi/minilab3/pad8 — 是
Keys keys 琴鍵 音符 · 力度 1 48–72(C3–C5) midi/minilab3/keys/on · midi/minilab3/keys/off · midi/minilab3/n48…n72 — 是

這一台還沒有寫 LED 回饋,OAV 不會讓它的燈亮,但每個控制項照樣可以彈、照樣送出各自的訊息。

個別控制項的說明

出處

這個設定檔從哪裡來

Che-Yu Wu's TouchDesigner tool, recorded from his own MiniLab 3: base_minilab3 → out_knob (knob1–8 ← CC 74 71 76 77 93 18 19 16), out_slider (s1–s4 ← CC 82 83 85 17), out_pad (pad1–8 ← ch10 notes 36–43), out_note (25 keys, notes 48–72), out_pitch (mod CC 1 + pitch bend). Device table: in-device "Minilab3MIDI", channel 1. TouchDesigner's MIDI In CHOP names channels 1-based (ch1ctrl75 = CC 74, ch10n37 = note 36); the numbers here are real MIDI numbers. 260830 minilab3 midi.toe

說明

Pad pressure type is not documented: poly aftertouch is followed automatically if the unit sends it. Pad RGB LEDs are SysEx-only (not sent; sysex stays off).

認得的埠名稱

比對
/minilab\s*3/i
優先
/midi/i
避開
/din/i /thru/i /mcu/i /alv/i

訊號

每個控制項都會發出 midi/minilab3/<控制項>(0..1)和 /raw。打擊墊多一個 /hit,無段旋鈕多 /delta,琴鍵有 /on、/off 和 n<音高>。最後動到的那個控制項是 midi/minilab3/last。

用起來

把 Arturia MiniLab 3 用在你的作品裡

  1. 一行嵌入

    不用 import map,也不用建置。可以改 layout,加上 hardware="ask" 就有「接上」按鈕。

    html
    <script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script>
    <oav-controller profile="arturia-minilab3" readout></oav-controller>
  2. 或用 iframe

    給只能貼 iframe 的地方。每個事件都以 postMessage 傳回來。

    html
    <iframe src="https://openaudiovisual.com/embed/controller/?profile=arturia-minilab3&readout"
            width="720" height="468" style="border:0;max-width:100%" allow="midi"
            title="Arturia MiniLab 3"></iframe>
    <script>
      // every control the visitor plays arrives here
      addEventListener('message', (e) => {
        if (e.data?.source !== 'openav' || e.data.type !== 'control') return;
        console.log(e.data.detail.signal, e.data.detail.value);
      });
    </script>
  3. 送進 Ableton、TouchDesigner、Resolume

    你在畫面上彈的,會變成真正的 MIDI,從 macOS 的 IAC 匯流排或 Windows 的 loopMIDI 埠送出。步驟在圖鑑頁。

    html
    <!-- what you play on this controller → the IAC bus (macOS) → Ableton, TouchDesigner, Resolume -->
    <script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script>
    <oav-controller profile="arturia-minilab3" midi-out="IAC" readout></oav-controller>
    <!-- Windows: midi-out="loopMIDI" · let the visitor pick a port: midi-out="ask" -->

    macOS:音訊 MIDI 設定 → MIDI 工作室 → IAC 驅動程式 → 勾「裝置在線上」。Windows 11:內建的 Windows MIDI Services 有 loopback(我們沒有實測);舊版 Windows:安裝 loopMIDI、新增一個埠,用 midi-out="loopMIDI"。

在 p5.js 裡,只要一行

一行注入會依這份設定檔裡的順序(也就是上面表格的順序)替旋鈕、推桿和打擊墊編號。網址加上 ?profile=arturia-minilab3,畫面上的控制器就是這一台;真的 Arturia MiniLab 3 接上時,會依埠名稱自動認出來。

javascript
document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=arturia-minilab3' }));
在草稿裡控制項訊息
knob11 knob1CC 74 · 頻道 1
knob22 knob2CC 71 · 頻道 1
knob33 knob3CC 76 · 頻道 1
knob44 knob4CC 77 · 頻道 1
knob55 knob5CC 93 · 頻道 1
knob66 knob6CC 18 · 頻道 1
knob77 knob7CC 19 · 頻道 1
knob88 knob8CC 16 · 頻道 1
fader1S1 s1CC 82 · 頻道 1
fader2S2 s2CC 83 · 頻道 1
fader3S3 s3CC 85 · 頻道 1
fader4S4 s4CC 17 · 頻道 1
pad11 pad1音符 36 · C2 · 頻道 10
pad22 pad2音符 37 · C#2 · 頻道 10
pad33 pad3音符 38 · D2 · 頻道 10
pad44 pad4音符 39 · D#2 · 頻道 10
pad55 pad5音符 40 · E2 · 頻道 10
pad66 pad6音符 41 · F2 · 頻道 10
pad77 pad7音符 42 · F#2 · 頻道 10
pad88 pad8音符 43 · G2 · 頻道 10
notePressed(note, velocity)48–72(C3–C5)琴鍵按下
p5.js 草稿
function draw() {
  background(knob1 * 255);   // 1 · CC 74
  circle(width / 2, height / 2, 50 + knob2 * 300);   // 2 · CC 71
}

function padPressed(n, velocity) {      // n = 1…8, as in the table
  circle(random(width), random(height), velocity * 100);
}

function notePressed(note, velocity) {   // a key goes down
  circle(random(width), random(height), velocity * 100);
}

無段旋鈕、按鈕、滾輪和觸控條沒有編號:用 midi.cc[編號] 讀(編號見上面的表),或寫 controlChange(cc, value, ch) 接。

p5.js 完整說明 →

找不到

沒有你那台?

開一張 issue,寫廠牌型號、手上有沒有這台、手冊的連結。也可以自己寫設定檔,它就是一個 JSON 檔。

GitHub

這台的資料有錯嗎?

這一頁的每個數字都來自一個 JSON 檔。如果跟你的機器或手冊對不上,告訴我們你查的是哪個韌體版本,我們就改檔案。