MIDI 實作表

通用 25 鍵鍵盤每個控制項送出什麼

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

通用 25 鍵鍵盤的 MIDI 實作表
控制項	類型	訊息	頻道	編號	訊號	LED 回饋	已確認
Pitch `pitch`	滾輪	彎音 · 放開回中央	1	0–16383 · 中央 8192	`midi/keys25/pitch`	—	是
Mod `mod`	滾輪	CC	1	1	`midi/keys25/mod`	—	是
Sustain `sustain`	按鈕	CC · 按住	1	64	`midi/keys25/sustain`	—	是
Keys `keys`	琴鍵	音符 · 力度	1	48–72（C3–C5）	`midi/keys25/keys/on · midi/keys25/keys/off · midi/keys25/n48…n72`	—	是

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

出處

慣例 open-audiovisual generic layoutKeys 48–72 on channel 1 (C3–C5, scientific pitch: 60 = C4), pitch bend, mod wheel CC 1, sustain CC 64 — the General MIDI conventions every keyboard follows. Keys catch any note on their channel, so octave shifts on the hardware just scroll the on-screen keys.

認得的埠名稱

通用版面不會自己比對埠：手動指定一個埠，再用學習模式。

訊號

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

用起來

把通用 25 鍵鍵盤用在你的作品裡

一行嵌入

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

html

<script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script>
<oav-controller profile="generic-keys25" readout></oav-controller>

或用 iframe

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

html

<iframe src="https://openaudiovisual.com/embed/controller/?profile=generic-keys25&readout"
        width="720" height="289" style="border:0;max-width:100%" allow="midi"
        title="Generic 25-key keyboard"></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 埠送出。步驟在圖鑑頁。
html
```

<script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script>
<oav-controller profile="generic-keys25" midi-out="IAC" readout></oav-controller>

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

在 p5.js 裡，只要一行

一行注入會依這個版面裡的順序（也就是上面表格的順序）替旋鈕、推桿和打擊墊編號。網址加上 ?profile=generic-keys25，畫面上的控制器就是這個版面。

javascript

document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=generic-keys25' }));

在草稿裡	控制項	訊息
`notePressed(note, velocity)`	48–72（C3–C5）	琴鍵按下

p5.js 草稿

function draw() {
  background(20);
}

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

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

這是通用版面，要在畫面上選它當控制器，編號才會照這份設定。接上不認識的真機時，旋鈕會依你轉動的順序編號。

p5.js 完整說明 →

這台的周圍

通用 49 鍵鍵盤通用版面 · 49 個琴鍵 · 1 顆按鈕 · 2 個滾輪
通用 61 鍵鍵盤通用版面 · 61 個琴鍵 · 1 顆按鈕 · 2 個滾輪
Novation Launchkey 25 MK4Novation · 16 個打擊墊 · 25 個琴鍵 · 8 顆旋鈕 · 1 顆按鈕 · 2 個滾輪
Novation Launchkey 37 MK4Novation · 16 個打擊墊 · 37 個琴鍵 · 8 顆旋鈕 · 1 顆按鈕 · 2 個滾輪
Korg nanoKEY2KORG · 25 個琴鍵 · 2 顆按鈕 · 1 條觸控條
teenage engineering OP-1 fieldteenage engineering · 24 個琴鍵 · 4 顆無段旋鈕 · 33 顆按鈕

把通用 25 鍵鍵盤跟其他台比較：琴鍵、打擊墊、旋鈕、推桿、LED 回饋 →

找不到

沒有你那台？

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

GitHub

這台的資料有錯嗎？

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

通用 25 鍵鍵盤

出處

認得的埠名稱

訊號

一行嵌入

或用 iframe

送進 Ableton、TouchDesigner、Resolume

在 p5.js 裡，只要一行