AKAI Professional
AKAI Professional APC20
AKAI Professional APC20 是 AKAI Professional 的 MIDI 硬體控制器:1 顆旋鈕、9 支推桿、87 顆按鈕。
它在 頻道 1、2、3、4、5、6、7、8 送出 CC、音符,設定檔引用了 1 份出處。 其中 97 個控制項標了未確認:數字是照目前出處的最佳判讀,按「學習」一次就能重新對應。
- 社群整理
- 來自 QLC+
- 版面自動產生
- 97 個未確認
- 類型
- 硬體裝置
- 廠牌
- AKAI Professional
- 控制項
- 97 個控制項
- 訊息種類
- CC · 音符
- MIDI 頻道
- 1, 2, 3, 4, 5, 6, 7, 8
- LED 回饋
- 不會送出
- 版面
- 自動產生
- 資料授權
- Apache-2.0,來自 QLC+(NOTICE)
- 實機驗證
- 還沒有人驗過
- 訊號
midi/apc20/…- 埠名稱比對
/^(akai\s+)?apc\s*20(\s+(midi|port))*(\s+\d+)?$/i
版面自動產生:QLC+ 沒有面板資料,這裡只是把控制項排出來,不是機器的樣子。
拖曳旋鈕和推桿 · 點打擊墊和琴鍵 · 或接上真機按「接上」。除非你加了 MIDI 輸出,否則什麼都不會送出去。
MIDI 實作表
AKAI Professional APC20 每個控制項送出什麼
直接從設定檔產生,跟畫面上彈的是同一張表。頻道是 1–16,編號是真正的 MIDI 編號。
| 控制項 | 類型 | 訊息 | 頻道 | 編號 | 訊號 | LED 回饋 | 依據 |
|---|---|---|---|---|---|---|---|
Slider 1 slider-1 |
推桿 | CC | 1 | 7 | midi/apc20/slider-1 |
— | 未確認 |
Slider Master slider-master |
推桿 | CC | 1 | 14 | midi/apc20/slider-master |
— | 未確認 |
Cue level cue-level |
旋鈕 | CC | 1 | 47 | midi/apc20/cue-level |
— | 未確認 |
Record arm 1 record-arm-1 |
按鈕 | 音符 · 按住 | 1 | 48 · C3 | midi/apc20/record-arm-1 |
— | 未確認 |
Solo 1 solo-1 |
按鈕 | 音符 · 按住 | 1 | 49 · C#3 | midi/apc20/solo-1 |
— | 未確認 |
Activator 1 activator-1 |
按鈕 | 音符 · 按住 | 1 | 50 · D3 | midi/apc20/activator-1 |
— | 未確認 |
Play play |
按鈕 | 音符 · 按住 | 1 | 51 · D#3 | midi/apc20/play |
— | 未確認 |
Clip stop 1 clip-stop-1 |
按鈕 | 音符 · 按住 | 1 | 52 · E3 | midi/apc20/clip-stop-1 |
— | 未確認 |
Matrix 1-1 matrix-1-1 |
按鈕 | 音符 · 按住 | 1 | 53 · F3 | midi/apc20/matrix-1-1 |
— | 未確認 |
Matrix 1-2 matrix-1-2 |
按鈕 | 音符 · 按住 | 1 | 54 · F#3 | midi/apc20/matrix-1-2 |
— | 未確認 |
Matrix 1-3 matrix-1-3 |
按鈕 | 音符 · 按住 | 1 | 55 · G3 | midi/apc20/matrix-1-3 |
— | 未確認 |
Matrix 1-4 matrix-1-4 |
按鈕 | 音符 · 按住 | 1 | 56 · G#3 | midi/apc20/matrix-1-4 |
— | 未確認 |
Matrix 1-5 matrix-1-5 |
按鈕 | 音符 · 按住 | 1 | 57 · A3 | midi/apc20/matrix-1-5 |
— | 未確認 |
Note mode note-mode |
按鈕 | 音符 · 按住 | 1 | 80 · G#5 | midi/apc20/note-mode |
— | 未確認 |
Shift shift |
按鈕 | 音符 · 按住 | 1 | 81 · A5 | midi/apc20/shift |
— | 未確認 |
Scene launch 1 scene-launch-1 |
按鈕 | 音符 · 按住 | 1 | 82 · A#5 | midi/apc20/scene-launch-1 |
— | 未確認 |
Scene launch 2 scene-launch-2 |
按鈕 | 音符 · 按住 | 1 | 83 · B5 | midi/apc20/scene-launch-2 |
— | 未確認 |
Scene launch 3 scene-launch-3 |
按鈕 | 音符 · 按住 | 1 | 84 · C6 | midi/apc20/scene-launch-3 |
— | 未確認 |
Scene launch 4 scene-launch-4 |
按鈕 | 音符 · 按住 | 1 | 85 · C#6 | midi/apc20/scene-launch-4 |
— | 未確認 |
Scene launch 5 scene-launch-5 |
按鈕 | 音符 · 按住 | 1 | 86 · D6 | midi/apc20/scene-launch-5 |
— | 未確認 |
Slider 2 slider-2 |
推桿 | CC | 2 | 7 | midi/apc20/slider-2 |
— | 未確認 |
Record arm 2 record-arm-2 |
按鈕 | 音符 · 按住 | 2 | 48 · C3 | midi/apc20/record-arm-2 |
— | 未確認 |
Solo 2 solo-2 |
按鈕 | 音符 · 按住 | 2 | 49 · C#3 | midi/apc20/solo-2 |
— | 未確認 |
Activator 2 activator-2 |
按鈕 | 音符 · 按住 | 2 | 50 · D3 | midi/apc20/activator-2 |
— | 未確認 |
Stop stop |
按鈕 | 音符 · 按住 | 2 | 51 · D#3 | midi/apc20/stop |
— | 未確認 |
Clip stop 2 clip-stop-2 |
按鈕 | 音符 · 按住 | 2 | 52 · E3 | midi/apc20/clip-stop-2 |
— | 未確認 |
Matrix 2-1 matrix-2-1 |
按鈕 | 音符 · 按住 | 2 | 53 · F3 | midi/apc20/matrix-2-1 |
— | 未確認 |
Matrix 2-2 matrix-2-2 |
按鈕 | 音符 · 按住 | 2 | 54 · F#3 | midi/apc20/matrix-2-2 |
— | 未確認 |
Matrix 2-3 matrix-2-3 |
按鈕 | 音符 · 按住 | 2 | 55 · G3 | midi/apc20/matrix-2-3 |
— | 未確認 |
Matrix 2-4 matrix-2-4 |
按鈕 | 音符 · 按住 | 2 | 56 · G#3 | midi/apc20/matrix-2-4 |
— | 未確認 |
Matrix 2-5 matrix-2-5 |
按鈕 | 音符 · 按住 | 2 | 57 · A3 | midi/apc20/matrix-2-5 |
— | 未確認 |
Slider 3 slider-3 |
推桿 | CC | 3 | 7 | midi/apc20/slider-3 |
— | 未確認 |
Record arm 3 record-arm-3 |
按鈕 | 音符 · 按住 | 3 | 48 · C3 | midi/apc20/record-arm-3 |
— | 未確認 |
Solo 3 solo-3 |
按鈕 | 音符 · 按住 | 3 | 49 · C#3 | midi/apc20/solo-3 |
— | 未確認 |
Activator 3 activator-3 |
按鈕 | 音符 · 按住 | 3 | 50 · D3 | midi/apc20/activator-3 |
— | 未確認 |
Rec rec |
按鈕 | 音符 · 按住 | 3 | 51 · D#3 | midi/apc20/rec |
— | 未確認 |
Clip stop 3 clip-stop-3 |
按鈕 | 音符 · 按住 | 3 | 52 · E3 | midi/apc20/clip-stop-3 |
— | 未確認 |
Matrix 3-1 matrix-3-1 |
按鈕 | 音符 · 按住 | 3 | 53 · F3 | midi/apc20/matrix-3-1 |
— | 未確認 |
Matrix 3-2 matrix-3-2 |
按鈕 | 音符 · 按住 | 3 | 54 · F#3 | midi/apc20/matrix-3-2 |
— | 未確認 |
Matrix 3-3 matrix-3-3 |
按鈕 | 音符 · 按住 | 3 | 55 · G3 | midi/apc20/matrix-3-3 |
— | 未確認 |
Matrix 3-4 matrix-3-4 |
按鈕 | 音符 · 按住 | 3 | 56 · G#3 | midi/apc20/matrix-3-4 |
— | 未確認 |
Matrix 3-5 matrix-3-5 |
按鈕 | 音符 · 按住 | 3 | 57 · A3 | midi/apc20/matrix-3-5 |
— | 未確認 |
Slider 4 slider-4 |
推桿 | CC | 4 | 7 | midi/apc20/slider-4 |
— | 未確認 |
Record arm 4 record-arm-4 |
按鈕 | 音符 · 按住 | 4 | 48 · C3 | midi/apc20/record-arm-4 |
— | 未確認 |
Solo 4 solo-4 |
按鈕 | 音符 · 按住 | 4 | 49 · C#3 | midi/apc20/solo-4 |
— | 未確認 |
Activator 4 activator-4 |
按鈕 | 音符 · 按住 | 4 | 50 · D3 | midi/apc20/activator-4 |
— | 未確認 |
Midi overdub midi-overdub |
按鈕 | 音符 · 按住 | 4 | 51 · D#3 | midi/apc20/midi-overdub |
— | 未確認 |
Clip stop 4 clip-stop-4 |
按鈕 | 音符 · 按住 | 4 | 52 · E3 | midi/apc20/clip-stop-4 |
— | 未確認 |
Matrix 4-1 matrix-4-1 |
按鈕 | 音符 · 按住 | 4 | 53 · F3 | midi/apc20/matrix-4-1 |
— | 未確認 |
Matrix 4-2 matrix-4-2 |
按鈕 | 音符 · 按住 | 4 | 54 · F#3 | midi/apc20/matrix-4-2 |
— | 未確認 |
Matrix 4-3 matrix-4-3 |
按鈕 | 音符 · 按住 | 4 | 55 · G3 | midi/apc20/matrix-4-3 |
— | 未確認 |
Matrix 4-4 matrix-4-4 |
按鈕 | 音符 · 按住 | 4 | 56 · G#3 | midi/apc20/matrix-4-4 |
— | 未確認 |
Matrix 4-5 matrix-4-5 |
按鈕 | 音符 · 按住 | 4 | 57 · A3 | midi/apc20/matrix-4-5 |
— | 未確認 |
Slider 5 slider-5 |
推桿 | CC | 5 | 7 | midi/apc20/slider-5 |
— | 未確認 |
Record arm 5 record-arm-5 |
按鈕 | 音符 · 按住 | 5 | 48 · C3 | midi/apc20/record-arm-5 |
— | 未確認 |
Solo 5 solo-5 |
按鈕 | 音符 · 按住 | 5 | 49 · C#3 | midi/apc20/solo-5 |
— | 未確認 |
Activator 5 activator-5 |
按鈕 | 音符 · 按住 | 5 | 50 · D3 | midi/apc20/activator-5 |
— | 未確認 |
Left left |
按鈕 | 音符 · 按住 | 5 | 51 · D#3 | midi/apc20/left |
— | 未確認 |
Clip stop 5 clip-stop-5 |
按鈕 | 音符 · 按住 | 5 | 52 · E3 | midi/apc20/clip-stop-5 |
— | 未確認 |
Matrix 5-1 matrix-5-1 |
按鈕 | 音符 · 按住 | 5 | 53 · F3 | midi/apc20/matrix-5-1 |
— | 未確認 |
Matrix 5-2 matrix-5-2 |
按鈕 | 音符 · 按住 | 5 | 54 · F#3 | midi/apc20/matrix-5-2 |
— | 未確認 |
Matrix 5-3 matrix-5-3 |
按鈕 | 音符 · 按住 | 5 | 55 · G3 | midi/apc20/matrix-5-3 |
— | 未確認 |
Matrix 5-4 matrix-5-4 |
按鈕 | 音符 · 按住 | 5 | 56 · G#3 | midi/apc20/matrix-5-4 |
— | 未確認 |
Matrix 5-5 matrix-5-5 |
按鈕 | 音符 · 按住 | 5 | 57 · A3 | midi/apc20/matrix-5-5 |
— | 未確認 |
Slider 6 slider-6 |
推桿 | CC | 6 | 7 | midi/apc20/slider-6 |
— | 未確認 |
Record arm 6 record-arm-6 |
按鈕 | 音符 · 按住 | 6 | 48 · C3 | midi/apc20/record-arm-6 |
— | 未確認 |
Solo 6 solo-6 |
按鈕 | 音符 · 按住 | 6 | 49 · C#3 | midi/apc20/solo-6 |
— | 未確認 |
Activator 6 activator-6 |
按鈕 | 音符 · 按住 | 6 | 50 · D3 | midi/apc20/activator-6 |
— | 未確認 |
Right right |
按鈕 | 音符 · 按住 | 6 | 51 · D#3 | midi/apc20/right |
— | 未確認 |
Clip stop 6 clip-stop-6 |
按鈕 | 音符 · 按住 | 6 | 52 · E3 | midi/apc20/clip-stop-6 |
— | 未確認 |
Matrix 6-1 matrix-6-1 |
按鈕 | 音符 · 按住 | 6 | 53 · F3 | midi/apc20/matrix-6-1 |
— | 未確認 |
Matrix 6-2 matrix-6-2 |
按鈕 | 音符 · 按住 | 6 | 54 · F#3 | midi/apc20/matrix-6-2 |
— | 未確認 |
Matrix 6-3 matrix-6-3 |
按鈕 | 音符 · 按住 | 6 | 55 · G3 | midi/apc20/matrix-6-3 |
— | 未確認 |
Matrix 6-4 matrix-6-4 |
按鈕 | 音符 · 按住 | 6 | 56 · G#3 | midi/apc20/matrix-6-4 |
— | 未確認 |
Matrix 6-5 matrix-6-5 |
按鈕 | 音符 · 按住 | 6 | 57 · A3 | midi/apc20/matrix-6-5 |
— | 未確認 |
Slider 7 slider-7 |
推桿 | CC | 7 | 7 | midi/apc20/slider-7 |
— | 未確認 |
Record arm 7 record-arm-7 |
按鈕 | 音符 · 按住 | 7 | 48 · C3 | midi/apc20/record-arm-7 |
— | 未確認 |
Solo 7 solo-7 |
按鈕 | 音符 · 按住 | 7 | 49 · C#3 | midi/apc20/solo-7 |
— | 未確認 |
Activator 7 activator-7 |
按鈕 | 音符 · 按住 | 7 | 50 · D3 | midi/apc20/activator-7 |
— | 未確認 |
Up up |
按鈕 | 音符 · 按住 | 7 | 51 · D#3 | midi/apc20/up |
— | 未確認 |
Clip stop 7 clip-stop-7 |
按鈕 | 音符 · 按住 | 7 | 52 · E3 | midi/apc20/clip-stop-7 |
— | 未確認 |
Matrix 7-1 matrix-7-1 |
按鈕 | 音符 · 按住 | 7 | 53 · F3 | midi/apc20/matrix-7-1 |
— | 未確認 |
Matrix 7-2 matrix-7-2 |
按鈕 | 音符 · 按住 | 7 | 54 · F#3 | midi/apc20/matrix-7-2 |
— | 未確認 |
Matrix 7-3 matrix-7-3 |
按鈕 | 音符 · 按住 | 7 | 55 · G3 | midi/apc20/matrix-7-3 |
— | 未確認 |
Matrix 7-4 matrix-7-4 |
按鈕 | 音符 · 按住 | 7 | 56 · G#3 | midi/apc20/matrix-7-4 |
— | 未確認 |
Matrix 7-5 matrix-7-5 |
按鈕 | 音符 · 按住 | 7 | 57 · A3 | midi/apc20/matrix-7-5 |
— | 未確認 |
Slider 8 slider-8 |
推桿 | CC | 8 | 7 | midi/apc20/slider-8 |
— | 未確認 |
Record arm 8 record-arm-8 |
按鈕 | 音符 · 按住 | 8 | 48 · C3 | midi/apc20/record-arm-8 |
— | 未確認 |
Solo 8 solo-8 |
按鈕 | 音符 · 按住 | 8 | 49 · C#3 | midi/apc20/solo-8 |
— | 未確認 |
Activator 8 activator-8 |
按鈕 | 音符 · 按住 | 8 | 50 · D3 | midi/apc20/activator-8 |
— | 未確認 |
Down down |
按鈕 | 音符 · 按住 | 8 | 51 · D#3 | midi/apc20/down |
— | 未確認 |
Clip stop 8 clip-stop-8 |
按鈕 | 音符 · 按住 | 8 | 52 · E3 | midi/apc20/clip-stop-8 |
— | 未確認 |
Matrix 8-1 matrix-8-1 |
按鈕 | 音符 · 按住 | 8 | 53 · F3 | midi/apc20/matrix-8-1 |
— | 未確認 |
Matrix 8-2 matrix-8-2 |
按鈕 | 音符 · 按住 | 8 | 54 · F#3 | midi/apc20/matrix-8-2 |
— | 未確認 |
Matrix 8-3 matrix-8-3 |
按鈕 | 音符 · 按住 | 8 | 55 · G3 | midi/apc20/matrix-8-3 |
— | 未確認 |
Matrix 8-4 matrix-8-4 |
按鈕 | 音符 · 按住 | 8 | 56 · G#3 | midi/apc20/matrix-8-4 |
— | 未確認 |
Matrix 8-5 matrix-8-5 |
按鈕 | 音符 · 按住 | 8 | 57 · A3 | midi/apc20/matrix-8-5 |
— | 未確認 |
手上有這台機器?幾分鐘就能核對這份資料。 用你的機器驗證 AKAI Professional APC20 →
這一台還沒有寫 LED 回饋,OAV 不會讓它的燈亮,但每個控制項照樣可以彈、照樣送出各自的訊息。
出處
- 社群 QLC+ input profile Akai-APC20.qxi (non-official)community profile by Joep Admiraal; Apache-2.0; numbers read from QLC+ channel numbers, not checked by this project
這個設定檔從哪裡來
Imported from QLC+ on 2026-11-04. resources/inputprofiles/Akai-APC20.qxi
說明
Imported from QLC+. The messages are what its community profile lists; nobody has checked them on a unit for this project, so every control is unverified. QLC+ has no faceplate data, so the layout was generated from the list of controls and does not look like the device. The port-name pattern was written from the model name, not read from a unit. QLC+ numbers these controls without a MIDI channel, so channel 1 here is a placeholder: the unit may send on another.
認得的埠名稱
- 比對
/^(akai\s+)?apc\s*20(\s+(midi|port))*(\s+\d+)?$/i
訊號
每個控制項都會發出 midi/apc20/<控制項>(0..1)和 /raw。打擊墊多一個 /hit,無段旋鈕多 /delta,琴鍵有 /on、/off 和 n<音高>。最後動到的那個控制項是 midi/apc20/last。
用起來
把 AKAI Professional APC20 用在你的作品裡
一行嵌入
不用 import map,也不用建置。可以改
layout,加上hardware="ask"就有「接上」按鈕。<script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script> <oav-controller profile="akai-apc20" readout></oav-controller>或用 iframe
給只能貼 iframe 的地方。每個事件都以
postMessage傳回來。<iframe src="https://openaudiovisual.com/embed/controller/?profile=akai-apc20&readout" width="720" height="641" style="border:0;max-width:100%" allow="midi" title="AKAI Professional APC20"></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="akai-apc20" 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=akai-apc20,畫面上的控制器就是這一台;真的 AKAI Professional APC20 接上時,會依埠名稱自動認出來。
document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=akai-apc20' }));| 在草稿裡 | 控制項 | 訊息 |
|---|---|---|
knob1 | Cue level cue-level | CC 47 · 頻道 1 |
fader1 | Slider 1 slider-1 | CC 7 · 頻道 1 |
fader2 | Slider Master slider-master | CC 14 · 頻道 1 |
fader3 | Slider 2 slider-2 | CC 7 · 頻道 2 |
fader4 | Slider 3 slider-3 | CC 7 · 頻道 3 |
fader5 | Slider 4 slider-4 | CC 7 · 頻道 4 |
fader6 | Slider 5 slider-5 | CC 7 · 頻道 5 |
fader7 | Slider 6 slider-6 | CC 7 · 頻道 6 |
fader8 | Slider 7 slider-7 | CC 7 · 頻道 7 |
fader(9) | Slider 8 slider-8 | CC 7 · 頻道 8 |
function draw() {
background(knob1 * 255); // Cue level · CC 47
circle(width / 2, height / 2, 50 + fader1 * 300); // Slider 1 · CC 7
}無段旋鈕、按鈕、滾輪和觸控條沒有編號:用 midi.cc[編號] 讀(編號見上面的表),或寫 controlChange(cc, value, ch) 接。
其他軟體
在這個專案以外使用這台控制器
同一份資料,換成別的程式讀得懂的檔案。除非上面的表格有寫,這些檔案都還沒在這台機器上實測過。
QLC+
輸入設定檔:每個控制項和 LED 值,給燈光控制用。複製到使用者資料夾(macOS ~/Library/Application Support/QLC+/InputProfiles,Linux ~/.qlcplus/inputprofiles,Windows %USERPROFILE%\QLC+\InputProfiles),重新開啟 QLC+。 接著把這個輸入的 MIDI 頻道設成 Omni。
Mixxx
這是起點,不是完成的 mapping:唱盤、EQ、hot cue 依序分給各個控制項。把兩個檔案放進 Preferences → Controllers → Open User Mapping Folder 開啟的資料夾,再用 Learning Wizard 改成你要的。
資料本身
上面的東西都來自這個檔案:面板、訊息、LED、SysEx,以及誰驗了什麼。tools/export-controller.mjs 可以從任何設定檔產生這些檔案。
找不到
沒有你那台?
開一張 issue,寫廠牌型號、手上有沒有這台、手冊的連結。也可以自己寫設定檔,它就是一個 JSON 檔。
GitHub
這台的資料有錯嗎?
這一頁的每個數字都來自一個 JSON 檔。如果跟你的機器或手冊對不上,告訴我們你查的是哪個韌體版本,我們就改檔案。