open-audiovisual
搜尋 GitHub

AKAI Professional

AKAI APC mini mk2

AKAI APC mini mk2 是 AKAI Professional 的 MIDI 硬體控制器:64 個打擊墊、9 支推桿、17 顆按鈕。

它在 頻道 1 送出 音符、CC,設定檔引用了 5 份出處。 沒有任何控制項被標為未確認。

  • 原廠文件
  • 社群整理
  • LED 回饋
類型
硬體裝置
廠牌
AKAI Professional
控制項
90 個控制項
訊息種類
音符 · CC
MIDI 頻道
1
LED 回饋
有,燈光由 MIDI 控制
訊號
midi/apcmini2/…
埠名稱比對
/apc\s*mini\s*(mk\s*2|mkii)/i
APC MINI MK2▸▸▸▸▸▸▸▸VolPanDev▲▼◀▶12345678Master

在畫面上彈 AKAI APC mini mk2 全螢幕 ↗ 原始 JSON ↗ 全部控制器

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

MIDI 實作表

AKAI APC mini mk2 每個控制項送出什麼

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

AKAI APC mini mk2 的 MIDI 實作表
控制項類型訊息頻道編號訊號LED 回饋已確認
pad1 打擊墊 音符 · 力度 1 0 · C-1 midi/apcmini2/pad1 音符 0 · ch 7 · 亮 37 / 暗 0 是
pad2 打擊墊 音符 · 力度 1 1 · C#-1 midi/apcmini2/pad2 音符 1 · ch 7 · 亮 37 / 暗 0 是
pad3 打擊墊 音符 · 力度 1 2 · D-1 midi/apcmini2/pad3 音符 2 · ch 7 · 亮 37 / 暗 0 是
pad4 打擊墊 音符 · 力度 1 3 · D#-1 midi/apcmini2/pad4 音符 3 · ch 7 · 亮 37 / 暗 0 是
pad5 打擊墊 音符 · 力度 1 4 · E-1 midi/apcmini2/pad5 音符 4 · ch 7 · 亮 37 / 暗 0 是
pad6 打擊墊 音符 · 力度 1 5 · F-1 midi/apcmini2/pad6 音符 5 · ch 7 · 亮 37 / 暗 0 是
pad7 打擊墊 音符 · 力度 1 6 · F#-1 midi/apcmini2/pad7 音符 6 · ch 7 · 亮 37 / 暗 0 是
pad8 打擊墊 音符 · 力度 1 7 · G-1 midi/apcmini2/pad8 音符 7 · ch 7 · 亮 37 / 暗 0 是
pad9 打擊墊 音符 · 力度 1 8 · G#-1 midi/apcmini2/pad9 音符 8 · ch 7 · 亮 37 / 暗 0 是
pad10 打擊墊 音符 · 力度 1 9 · A-1 midi/apcmini2/pad10 音符 9 · ch 7 · 亮 37 / 暗 0 是
pad11 打擊墊 音符 · 力度 1 10 · A#-1 midi/apcmini2/pad11 音符 10 · ch 7 · 亮 37 / 暗 0 是
pad12 打擊墊 音符 · 力度 1 11 · B-1 midi/apcmini2/pad12 音符 11 · ch 7 · 亮 37 / 暗 0 是
pad13 打擊墊 音符 · 力度 1 12 · C0 midi/apcmini2/pad13 音符 12 · ch 7 · 亮 37 / 暗 0 是
pad14 打擊墊 音符 · 力度 1 13 · C#0 midi/apcmini2/pad14 音符 13 · ch 7 · 亮 37 / 暗 0 是
pad15 打擊墊 音符 · 力度 1 14 · D0 midi/apcmini2/pad15 音符 14 · ch 7 · 亮 37 / 暗 0 是
pad16 打擊墊 音符 · 力度 1 15 · D#0 midi/apcmini2/pad16 音符 15 · ch 7 · 亮 37 / 暗 0 是
pad17 打擊墊 音符 · 力度 1 16 · E0 midi/apcmini2/pad17 音符 16 · ch 7 · 亮 37 / 暗 0 是
pad18 打擊墊 音符 · 力度 1 17 · F0 midi/apcmini2/pad18 音符 17 · ch 7 · 亮 37 / 暗 0 是
pad19 打擊墊 音符 · 力度 1 18 · F#0 midi/apcmini2/pad19 音符 18 · ch 7 · 亮 37 / 暗 0 是
pad20 打擊墊 音符 · 力度 1 19 · G0 midi/apcmini2/pad20 音符 19 · ch 7 · 亮 37 / 暗 0 是
pad21 打擊墊 音符 · 力度 1 20 · G#0 midi/apcmini2/pad21 音符 20 · ch 7 · 亮 37 / 暗 0 是
pad22 打擊墊 音符 · 力度 1 21 · A0 midi/apcmini2/pad22 音符 21 · ch 7 · 亮 37 / 暗 0 是
pad23 打擊墊 音符 · 力度 1 22 · A#0 midi/apcmini2/pad23 音符 22 · ch 7 · 亮 37 / 暗 0 是
pad24 打擊墊 音符 · 力度 1 23 · B0 midi/apcmini2/pad24 音符 23 · ch 7 · 亮 37 / 暗 0 是
pad25 打擊墊 音符 · 力度 1 24 · C1 midi/apcmini2/pad25 音符 24 · ch 7 · 亮 37 / 暗 0 是
pad26 打擊墊 音符 · 力度 1 25 · C#1 midi/apcmini2/pad26 音符 25 · ch 7 · 亮 37 / 暗 0 是
pad27 打擊墊 音符 · 力度 1 26 · D1 midi/apcmini2/pad27 音符 26 · ch 7 · 亮 37 / 暗 0 是
pad28 打擊墊 音符 · 力度 1 27 · D#1 midi/apcmini2/pad28 音符 27 · ch 7 · 亮 37 / 暗 0 是
pad29 打擊墊 音符 · 力度 1 28 · E1 midi/apcmini2/pad29 音符 28 · ch 7 · 亮 37 / 暗 0 是
pad30 打擊墊 音符 · 力度 1 29 · F1 midi/apcmini2/pad30 音符 29 · ch 7 · 亮 37 / 暗 0 是
pad31 打擊墊 音符 · 力度 1 30 · F#1 midi/apcmini2/pad31 音符 30 · ch 7 · 亮 37 / 暗 0 是
pad32 打擊墊 音符 · 力度 1 31 · G1 midi/apcmini2/pad32 音符 31 · ch 7 · 亮 37 / 暗 0 是
pad33 打擊墊 音符 · 力度 1 32 · G#1 midi/apcmini2/pad33 音符 32 · ch 7 · 亮 37 / 暗 0 是
pad34 打擊墊 音符 · 力度 1 33 · A1 midi/apcmini2/pad34 音符 33 · ch 7 · 亮 37 / 暗 0 是
pad35 打擊墊 音符 · 力度 1 34 · A#1 midi/apcmini2/pad35 音符 34 · ch 7 · 亮 37 / 暗 0 是
pad36 打擊墊 音符 · 力度 1 35 · B1 midi/apcmini2/pad36 音符 35 · ch 7 · 亮 37 / 暗 0 是
pad37 打擊墊 音符 · 力度 1 36 · C2 midi/apcmini2/pad37 音符 36 · ch 7 · 亮 37 / 暗 0 是
pad38 打擊墊 音符 · 力度 1 37 · C#2 midi/apcmini2/pad38 音符 37 · ch 7 · 亮 37 / 暗 0 是
pad39 打擊墊 音符 · 力度 1 38 · D2 midi/apcmini2/pad39 音符 38 · ch 7 · 亮 37 / 暗 0 是
pad40 打擊墊 音符 · 力度 1 39 · D#2 midi/apcmini2/pad40 音符 39 · ch 7 · 亮 37 / 暗 0 是
pad41 打擊墊 音符 · 力度 1 40 · E2 midi/apcmini2/pad41 音符 40 · ch 7 · 亮 37 / 暗 0 是
pad42 打擊墊 音符 · 力度 1 41 · F2 midi/apcmini2/pad42 音符 41 · ch 7 · 亮 37 / 暗 0 是
pad43 打擊墊 音符 · 力度 1 42 · F#2 midi/apcmini2/pad43 音符 42 · ch 7 · 亮 37 / 暗 0 是
pad44 打擊墊 音符 · 力度 1 43 · G2 midi/apcmini2/pad44 音符 43 · ch 7 · 亮 37 / 暗 0 是
pad45 打擊墊 音符 · 力度 1 44 · G#2 midi/apcmini2/pad45 音符 44 · ch 7 · 亮 37 / 暗 0 是
pad46 打擊墊 音符 · 力度 1 45 · A2 midi/apcmini2/pad46 音符 45 · ch 7 · 亮 37 / 暗 0 是
pad47 打擊墊 音符 · 力度 1 46 · A#2 midi/apcmini2/pad47 音符 46 · ch 7 · 亮 37 / 暗 0 是
pad48 打擊墊 音符 · 力度 1 47 · B2 midi/apcmini2/pad48 音符 47 · ch 7 · 亮 37 / 暗 0 是
pad49 打擊墊 音符 · 力度 1 48 · C3 midi/apcmini2/pad49 音符 48 · ch 7 · 亮 37 / 暗 0 是
pad50 打擊墊 音符 · 力度 1 49 · C#3 midi/apcmini2/pad50 音符 49 · ch 7 · 亮 37 / 暗 0 是
pad51 打擊墊 音符 · 力度 1 50 · D3 midi/apcmini2/pad51 音符 50 · ch 7 · 亮 37 / 暗 0 是
pad52 打擊墊 音符 · 力度 1 51 · D#3 midi/apcmini2/pad52 音符 51 · ch 7 · 亮 37 / 暗 0 是
pad53 打擊墊 音符 · 力度 1 52 · E3 midi/apcmini2/pad53 音符 52 · ch 7 · 亮 37 / 暗 0 是
pad54 打擊墊 音符 · 力度 1 53 · F3 midi/apcmini2/pad54 音符 53 · ch 7 · 亮 37 / 暗 0 是
pad55 打擊墊 音符 · 力度 1 54 · F#3 midi/apcmini2/pad55 音符 54 · ch 7 · 亮 37 / 暗 0 是
pad56 打擊墊 音符 · 力度 1 55 · G3 midi/apcmini2/pad56 音符 55 · ch 7 · 亮 37 / 暗 0 是
pad57 打擊墊 音符 · 力度 1 56 · G#3 midi/apcmini2/pad57 音符 56 · ch 7 · 亮 37 / 暗 0 是
pad58 打擊墊 音符 · 力度 1 57 · A3 midi/apcmini2/pad58 音符 57 · ch 7 · 亮 37 / 暗 0 是
pad59 打擊墊 音符 · 力度 1 58 · A#3 midi/apcmini2/pad59 音符 58 · ch 7 · 亮 37 / 暗 0 是
pad60 打擊墊 音符 · 力度 1 59 · B3 midi/apcmini2/pad60 音符 59 · ch 7 · 亮 37 / 暗 0 是
pad61 打擊墊 音符 · 力度 1 60 · C4 midi/apcmini2/pad61 音符 60 · ch 7 · 亮 37 / 暗 0 是
pad62 打擊墊 音符 · 力度 1 61 · C#4 midi/apcmini2/pad62 音符 61 · ch 7 · 亮 37 / 暗 0 是
pad63 打擊墊 音符 · 力度 1 62 · D4 midi/apcmini2/pad63 音符 62 · ch 7 · 亮 37 / 暗 0 是
pad64 打擊墊 音符 · 力度 1 63 · D#4 midi/apcmini2/pad64 音符 63 · ch 7 · 亮 37 / 暗 0 是
Vol track1 按鈕 音符 · 按住 1 100 · E7 midi/apcmini2/track1 音符 100 · 亮 1 / 暗 0 是
Pan track2 按鈕 音符 · 按住 1 101 · F7 midi/apcmini2/track2 音符 101 · 亮 1 / 暗 0 是
Send track3 按鈕 音符 · 按住 1 102 · F#7 midi/apcmini2/track3 音符 102 · 亮 1 / 暗 0 是
Dev track4 按鈕 音符 · 按住 1 103 · G7 midi/apcmini2/track4 音符 103 · 亮 1 / 暗 0 是
▲ track5 按鈕 音符 · 按住 1 104 · G#7 midi/apcmini2/track5 音符 104 · 亮 1 / 暗 0 是
▼ track6 按鈕 音符 · 按住 1 105 · A7 midi/apcmini2/track6 音符 105 · 亮 1 / 暗 0 是
◀ track7 按鈕 音符 · 按住 1 106 · A#7 midi/apcmini2/track7 音符 106 · 亮 1 / 暗 0 是
▶ track8 按鈕 音符 · 按住 1 107 · B7 midi/apcmini2/track8 音符 107 · 亮 1 / 暗 0 是
▸ scene1 按鈕 音符 · 按住 1 112 · E8 midi/apcmini2/scene1 音符 112 · 亮 1 / 暗 0 是
▸ scene2 按鈕 音符 · 按住 1 113 · F8 midi/apcmini2/scene2 音符 113 · 亮 1 / 暗 0 是
▸ scene3 按鈕 音符 · 按住 1 114 · F#8 midi/apcmini2/scene3 音符 114 · 亮 1 / 暗 0 是
▸ scene4 按鈕 音符 · 按住 1 115 · G8 midi/apcmini2/scene4 音符 115 · 亮 1 / 暗 0 是
▸ scene5 按鈕 音符 · 按住 1 116 · G#8 midi/apcmini2/scene5 音符 116 · 亮 1 / 暗 0 是
▸ scene6 按鈕 音符 · 按住 1 117 · A8 midi/apcmini2/scene6 音符 117 · 亮 1 / 暗 0 是
▸ scene7 按鈕 音符 · 按住 1 118 · A#8 midi/apcmini2/scene7 音符 118 · 亮 1 / 暗 0 是
▸ scene8 按鈕 音符 · 按住 1 119 · B8 midi/apcmini2/scene8 音符 119 · 亮 1 / 暗 0 是
Shift shift 按鈕 音符 · 按住 1 122 · D9 midi/apcmini2/shift — 是
1 f1 推桿 CC 1 48 midi/apcmini2/f1 — 是
2 f2 推桿 CC 1 49 midi/apcmini2/f2 — 是
3 f3 推桿 CC 1 50 midi/apcmini2/f3 — 是
4 f4 推桿 CC 1 51 midi/apcmini2/f4 — 是
5 f5 推桿 CC 1 52 midi/apcmini2/f5 — 是
6 f6 推桿 CC 1 53 midi/apcmini2/f6 — 是
7 f7 推桿 CC 1 54 midi/apcmini2/f7 — 是
8 f8 推桿 CC 1 55 midi/apcmini2/f8 — 是
Master master 推桿 CC 1 56 midi/apcmini2/master — 是

這一台有 80 個控制項寫了 LED 回饋,上面表格的 LED 欄就是讓它亮的訊息。

出處

  • 原廠 APC mini mk2 Communications Protocol v1.0 (AKAI)pad matrix diagram: notes 0x00–0x3F, 0x00 bottom-left, rows bottom→top, left→right; track buttons notes 0x64–0x6B (red LED), scene launch 0x70–0x77 (green LED), shift 0x7A (no LED), all channel 1 on port 0; faders 1–9 CC 0x30–0x38 channel 1, absolute; RGB LED = note-on where the channel sets behaviour (ch1–7 = 10/25/50/65/75/90/100 % brightness, ch8–11 pulse, ch12–16 blink) and velocity = palette index (0 #000000, 3 #FFFFFF, 5 #FF0000, 37 #00A9FF …); single LEDs = note-on ch1, velocity 0 off, 1 on, 2 blink
  • 原廠 APC mini mk2 User Guide v1.7 (AKAI)faceplate legends (track row: Volume, Pan, Send, Device, ▲▼◀▶; scene column soft keys: Clip Stop, Solo, Mute, Rec Arm, Select, Drum, Note, Stop All Clips); Shift + scene 6 / 7 enters Drum / Note mode; 240 × 210 mm
  • 社群 Ableton Live 12 MIDI Remote Script APC_mini_mk2 (decompiled; non-official)clip grid notes 0–63 on channel 1 (top row 56–63), drum-mode pads notes 64–127 on channel 10, track 100–107, scene 112–119, shift 122, faders CC 48–55, master CC 56; colors.py: FULL_BRIGHTNESS_CHANNEL = 6 (MIDI channel 7)
  • 社群 Ardour AKAI_APCmini_mk2.map (non-official)faders CC 48–56, scene notes 112–119, grid notes 0–63, all channel 1
  • 社群 MPC_Mapper README (non-official)the port that carries pads, buttons, faders and LEDs is named "APC mini mk2 … Control" (Linux)

說明

Session (clip-launch) layout, the one the unit boots into: the 8×8 grid sends notes 0–63 on channel 1, bottom-left = 0. Drum mode (Shift + scene 6: notes 64–127 on channel 10) and Note mode (Shift + scene 7: notes on the second USB port) are not modelled — 學習 can rebind. Shift (note 122) is a plain button the host reads; the printed Shift legends are host functions. The unit has two USB ports: the first (…Control on Linux, plain "APC mini mk2" on Windows) carries everything here; the second carries Note mode only. LED feedback: grid pads lit at 100 % brightness (channel 7) with palette 37 (#00A9FF) while held; track buttons (red) and scene buttons (green) are single-colour, velocity 1 = on.

認得的埠名稱

比對
/apc\s*mini\s*(mk\s*2|mkii)/i
優先
/control/i
避開
/notes/i /midiin2/i

訊號

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

用起來

把 AKAI APC mini mk2 用在你的作品裡

  1. 一行嵌入

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

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

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

    html
    <iframe src="https://openaudiovisual.com/embed/controller/?profile=akai-apc-mini-mk2&readout"
            width="720" height="652" style="border:0;max-width:100%" allow="midi"
            title="AKAI APC mini mk2"></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="akai-apc-mini-mk2" 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-apc-mini-mk2,畫面上的控制器就是這一台;真的 AKAI APC mini mk2 接上時,會依埠名稱自動認出來。

javascript
document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=akai-apc-mini-mk2' }));
在草稿裡控制項訊息
fader11 f1CC 48 · 頻道 1
fader22 f2CC 49 · 頻道 1
fader33 f3CC 50 · 頻道 1
fader44 f4CC 51 · 頻道 1
fader55 f5CC 52 · 頻道 1
fader66 f6CC 53 · 頻道 1
fader77 f7CC 54 · 頻道 1
fader88 f8CC 55 · 頻道 1
fader(9)Master masterCC 56 · 頻道 1
pad1pad1音符 0 · C-1 · 頻道 1
pad2pad2音符 1 · C#-1 · 頻道 1
pad3pad3音符 2 · D-1 · 頻道 1
pad4pad4音符 3 · D#-1 · 頻道 1
pad5pad5音符 4 · E-1 · 頻道 1
pad6pad6音符 5 · F-1 · 頻道 1
pad7pad7音符 6 · F#-1 · 頻道 1
pad8pad8音符 7 · G-1 · 頻道 1
pad9pad9音符 8 · G#-1 · 頻道 1
pad10pad10音符 9 · A-1 · 頻道 1
pad11pad11音符 10 · A#-1 · 頻道 1
pad12pad12音符 11 · B-1 · 頻道 1
pad13pad13音符 12 · C0 · 頻道 1
pad14pad14音符 13 · C#0 · 頻道 1
pad15pad15音符 14 · D0 · 頻道 1
pad16pad16音符 15 · D#0 · 頻道 1
… 還有 48 個,一路到 pad(64),順序相同
p5.js 草稿
function draw() {
  background(fader1 * 255);   // 1 · CC 48
  circle(width / 2, height / 2, 50 + fader2 * 300);   // 2 · CC 49
}

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

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

p5.js 完整說明 →

找不到

沒有你那台?

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

GitHub

這台的資料有錯嗎?

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