Behringer
Behringer X-TOUCH MINI
Behringer X-TOUCH MINI 是 Behringer 的 MIDI 硬體控制器:8 顆無段旋鈕、1 支推桿、24 顆按鈕。
它在 頻道 11 送出 CC、音符,設定檔引用了 3 份出處。 沒有任何控制項被標為未確認。
- 原廠文件
- 社群整理
- 類型
- 硬體裝置
- 廠牌
- Behringer
- 控制項
- 33 個控制項
- 訊息種類
- CC · 音符
- MIDI 頻道
- 11
- LED 回饋
- 不會送出
- 訊號
midi/xtouchmini/…- 埠名稱比對
/x-?\s*touch\s*mini/i
拖曳旋鈕和推桿 · 點打擊墊和琴鍵 · 或接上真機按「接上」。除非你加了 MIDI 輸出,否則什麼都不會送出去。
MIDI 實作表
Behringer X-TOUCH MINI 每個控制項送出什麼
直接從設定檔產生,跟畫面上彈的是同一張表。頻道是 1–16,編號是真正的 MIDI 編號。
| 控制項 | 類型 | 訊息 | 頻道 | 編號 | 訊號 | LED 回饋 | 已確認 |
|---|---|---|---|---|---|---|---|
1 enc1 |
無段旋鈕 | CC · 絕對值 | 11 | 1 | midi/xtouchmini/enc1 |
— | 是 |
2 enc2 |
無段旋鈕 | CC · 絕對值 | 11 | 2 | midi/xtouchmini/enc2 |
— | 是 |
3 enc3 |
無段旋鈕 | CC · 絕對值 | 11 | 3 | midi/xtouchmini/enc3 |
— | 是 |
4 enc4 |
無段旋鈕 | CC · 絕對值 | 11 | 4 | midi/xtouchmini/enc4 |
— | 是 |
5 enc5 |
無段旋鈕 | CC · 絕對值 | 11 | 5 | midi/xtouchmini/enc5 |
— | 是 |
6 enc6 |
無段旋鈕 | CC · 絕對值 | 11 | 6 | midi/xtouchmini/enc6 |
— | 是 |
7 enc7 |
無段旋鈕 | CC · 絕對值 | 11 | 7 | midi/xtouchmini/enc7 |
— | 是 |
8 enc8 |
無段旋鈕 | CC · 絕對值 | 11 | 8 | midi/xtouchmini/enc8 |
— | 是 |
Push push1 |
按鈕 | 音符 · 按住 | 11 | 0 · C-1 | midi/xtouchmini/push1 |
— | 是 |
Push push2 |
按鈕 | 音符 · 按住 | 11 | 1 · C#-1 | midi/xtouchmini/push2 |
— | 是 |
Push push3 |
按鈕 | 音符 · 按住 | 11 | 2 · D-1 | midi/xtouchmini/push3 |
— | 是 |
Push push4 |
按鈕 | 音符 · 按住 | 11 | 3 · D#-1 | midi/xtouchmini/push4 |
— | 是 |
Push push5 |
按鈕 | 音符 · 按住 | 11 | 4 · E-1 | midi/xtouchmini/push5 |
— | 是 |
Push push6 |
按鈕 | 音符 · 按住 | 11 | 5 · F-1 | midi/xtouchmini/push6 |
— | 是 |
Push push7 |
按鈕 | 音符 · 按住 | 11 | 6 · F#-1 | midi/xtouchmini/push7 |
— | 是 |
Push push8 |
按鈕 | 音符 · 按住 | 11 | 7 · G-1 | midi/xtouchmini/push8 |
— | 是 |
1 b1 |
按鈕 | 音符 · 按住 | 11 | 8 · G#-1 | midi/xtouchmini/b1 |
— | 是 |
2 b2 |
按鈕 | 音符 · 按住 | 11 | 9 · A-1 | midi/xtouchmini/b2 |
— | 是 |
3 b3 |
按鈕 | 音符 · 按住 | 11 | 10 · A#-1 | midi/xtouchmini/b3 |
— | 是 |
4 b4 |
按鈕 | 音符 · 按住 | 11 | 11 · B-1 | midi/xtouchmini/b4 |
— | 是 |
5 b5 |
按鈕 | 音符 · 按住 | 11 | 12 · C0 | midi/xtouchmini/b5 |
— | 是 |
6 b6 |
按鈕 | 音符 · 按住 | 11 | 13 · C#0 | midi/xtouchmini/b6 |
— | 是 |
7 b7 |
按鈕 | 音符 · 按住 | 11 | 14 · D0 | midi/xtouchmini/b7 |
— | 是 |
8 b8 |
按鈕 | 音符 · 按住 | 11 | 15 · D#0 | midi/xtouchmini/b8 |
— | 是 |
9 b9 |
按鈕 | 音符 · 按住 | 11 | 16 · E0 | midi/xtouchmini/b9 |
— | 是 |
10 b10 |
按鈕 | 音符 · 按住 | 11 | 17 · F0 | midi/xtouchmini/b10 |
— | 是 |
11 b11 |
按鈕 | 音符 · 按住 | 11 | 18 · F#0 | midi/xtouchmini/b11 |
— | 是 |
12 b12 |
按鈕 | 音符 · 按住 | 11 | 19 · G0 | midi/xtouchmini/b12 |
— | 是 |
13 b13 |
按鈕 | 音符 · 按住 | 11 | 20 · G#0 | midi/xtouchmini/b13 |
— | 是 |
14 b14 |
按鈕 | 音符 · 按住 | 11 | 21 · A0 | midi/xtouchmini/b14 |
— | 是 |
15 b15 |
按鈕 | 音符 · 按住 | 11 | 22 · A#0 | midi/xtouchmini/b15 |
— | 是 |
16 b16 |
按鈕 | 音符 · 按住 | 11 | 23 · B0 | midi/xtouchmini/b16 |
— | 是 |
Fader fader |
推桿 | CC | 11 | 9 | midi/xtouchmini/fader |
— | 是 |
這一台還沒有寫 LED 回饋,OAV 不會讓它的燈亮,但每個控制項照樣可以彈、照樣送出各自的訊息。
出處
- 原廠 X-TOUCH MINI Quick Start Guide (Behringer / MUSIC Group, P0B3M; mirror)MIDI map: Preset A on MIDI channel 11 — encoders turn CC 1–8, push notes C-2…G-2 (0–7), upper buttons G#-2…D#-1 (8–15), lower buttons E-1…B-1 (16–23), fader CC 9; Preset B (channel 11) — CC 11–18, notes 24–47, fader CC 10. RX table (global channel): LED-ring style CC 1–8, ring value CC 9–16 (0 off, 1–13 one LED, 14–26 blink, 27 all, 28 all blink), button LEDs notes 0–15 velocity 0 off / 1 on / 2 blink, Program Change 0/1 = layer A/B, CC 127 = standard/MC mode. 8 endless encoders with 13-LED rings, 16 backlit buttons, 60 mm fader; MC mode = hold MC while plugging in; 325 × 102 mm
- 社群 X-Touch-Mini-FS2020 docs (non-official)encoders must be switched to Relative2 in the X-TOUCH Editor for that app — i.e. the factory encoders are not relative; editor shows encoder push as Momentary notes on channel 11
- 社群 Q Light Controller+ forum — Behringer X Touch Mini (non-official)input on channel 11; the fader is CC 9 on layer A and CC 10 on layer B; buttons pressed on the unit only light while held (momentary)
說明
Standard mode (not MC), Layer A, as shipped: everything on channel 11. Layer B sends CC 11–18 / notes 24–47 / fader CC 10 on the same channel — a layer the faceplate cannot show, so it is not modelled (學習 rebinds). The encoders are endless but send absolute 0–127 by default (the unit keeps the value and draws it on the LED ring); switch them to a relative mode in the X-TOUCH Editor and set "relative" here to match. Layer A / B select presets inside the unit. LED feedback is not wired: button LEDs and LED-ring values are addressed on the unit's global channel (notes 0–15, CC 9–16), whose factory value is not documented (owners report 1 or 12). MC mode (Mackie Control) is a different protocol and is not covered.
認得的埠名稱
- 比對
/x-?\s*touch\s*mini/i
訊號
每個控制項都會發出 midi/xtouchmini/<控制項>(0..1)和 /raw。打擊墊多一個 /hit,無段旋鈕多 /delta,琴鍵有 /on、/off 和 n<音高>。最後動到的那個控制項是 midi/xtouchmini/last。
用起來
把 Behringer X-TOUCH MINI 用在你的作品裡
一行嵌入
不用 import map,也不用建置。可以改
layout,加上hardware="ask"就有「接上」按鈕。<script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script> <oav-controller profile="behringer-x-touch-mini" readout></oav-controller>或用 iframe
給只能貼 iframe 的地方。每個事件都以
postMessage傳回來。<iframe src="https://openaudiovisual.com/embed/controller/?profile=behringer-x-touch-mini&readout" width="720" height="249" style="border:0;max-width:100%" allow="midi" title="Behringer X-TOUCH MINI"></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>送進 Ableton、TouchDesigner、Resolume
你在畫面上彈的,會變成真正的 MIDI,從 macOS 的 IAC 匯流排或 Windows 的 loopMIDI 埠送出。步驟在圖鑑頁。
<!-- 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="behringer-x-touch-mini" 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=behringer-x-touch-mini,畫面上的控制器就是這一台;真的 Behringer X-TOUCH MINI 接上時,會依埠名稱自動認出來。
document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=behringer-x-touch-mini' }));| 在草稿裡 | 控制項 | 訊息 |
|---|---|---|
fader1 | Fader fader | CC 9 · 頻道 11 |
function draw() {
background(fader1 * 255); // Fader · CC 9
}無段旋鈕、按鈕、滾輪和觸控條沒有編號:用 midi.cc[編號] 讀(編號見上面的表),或寫 controlChange(cc, value, ch) 接。
找不到
沒有你那台?
開一張 issue,寫廠牌型號、手上有沒有這台、手冊的連結。也可以自己寫設定檔,它就是一個 JSON 檔。
GitHub
這台的資料有錯嗎?
這一頁的每個數字都來自一個 JSON 檔。如果跟你的機器或手冊對不上,告訴我們你查的是哪個韌體版本,我們就改檔案。