open-audiovisual
搜尋
EN中文
GitHub

KORG

Korg nanoKEY2

Korg nanoKEY2 是 KORG 的 MIDI 硬體控制器：25 個琴鍵、2 顆按鈕、1 條觸控條。

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

  • 原廠文件
  • 25 個未確認
類型
硬體裝置
廠牌
KORG
控制項
28 個控制項
訊息種類
彎音 · CC · 音符
MIDI 頻道
1
LED 回饋
不會送出
訊號
midi/nanokey2/…
埠名稱比對
/nanokey\s*2/i
NANOKEY2OCT−OCT+Pitch −/+MOD

在畫面上彈 Korg nanoKEY2 全螢幕 ↗ 原始 JSON ↗ 全部控制器

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

MIDI 實作表

Korg nanoKEY2 每個控制項送出什麼

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

Korg nanoKEY2 的 MIDI 實作表
控制項類型訊息頻道編號訊號LED 回饋已確認
Pitch −/+ bend 觸控條 彎音 · 放開回中央 1 0–16383 · 中央 8192 midi/nanokey2/bend — 是
MOD mod 按鈕 CC · 按住 1 1 midi/nanokey2/mod — 是
SUSTAIN sustain 按鈕 CC · 按住 1 64 midi/nanokey2/sustain — 是
Keys keys 琴鍵 音符 · 力度 1 48–72（C3–C5） midi/nanokey2/keys/on · midi/nanokey2/keys/off · midi/nanokey2/n48…n72 — 未確認

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

個別控制項的說明

出處

  • 原廠 nanoKEY2 Parameter Guide (KORG)factory settings: SUSTAIN button = CC 64, MOD button = CC 1 (momentary or toggle, on/off values editable); PITCH−/PITCH+ send pitch bend that returns to centre on release; keyboard, pitch, mod and sustain all transmit on the Global MIDI channel
  • 原廠 nanoKEY2 MIDI Implementation v1.00 (KORG)transmits note on/off (keyboard; note-off velocity 64), control change (MOD, SUSTAIN), pitch bend (PITCH buttons)
  • 原廠 nanoKEY2 Owner's Manual (KORG)ports: Mac "nanoKEY2 KEYBOARD" (in) / "nanoKEY2 CTRL" (out), Windows "nanoKEY2", with the KORG driver "nanoKEY2 1 KEYBOARD" / "nanoKEY2 1 CTRL"; OCT−/OCT+ shift ±4 octaves; 325 × 83 × 13 mm

說明

Factory settings. KORG does not print the factory Global MIDI channel; channel 1 is assumed (set it in KORG KONTROL Editor if yours differs, or use the element's channel attribute). PITCH− and PITCH+ are two buttons that send one pitch-bend message, so they are drawn as one bipolar strip. OCT−/OCT+ shift the keyboard inside the unit and send nothing of their own. No LED feedback.

認得的埠名稱

比對
/nanokey\s*2/i
優先
/keyboard/i
避開
/ctrl/i

訊號

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

用起來

把 Korg nanoKEY2 用在你的作品裡

  1. 一行嵌入

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

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

  2. 或用 iframe

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

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

javascript
document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=korg-nanokey2' }));
在草稿裡控制項訊息
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 完整說明 →

找不到

沒有你那台？

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

GitHub

這台的資料有錯嗎？

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