open-audiovisual
搜尋 GitHub

PMJ

PMJ MidiKey

PMJ MidiKey 是 PMJ 的 MIDI 硬體控制器:48 顆按鈕。

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

  • 社群整理
  • 來自 QLC+
  • 版面自動產生
  • 48 個未確認
類型
硬體裝置
廠牌
PMJ
控制項
48 個控制項
訊息種類
音符
MIDI 頻道
1
LED 回饋
不會送出
版面
自動產生
資料授權
Apache-2.0,來自 QLC+(NOTICE)
實機驗證
還沒有人驗過
訊號
midi/midikey/…
埠名稱比對
無:手動指定,再用學習模式
PMJ MIDIKEYBUTTONS

在畫面上彈 PMJ MidiKey 原始 JSON ↗ 全部控制器

版面自動產生:QLC+ 沒有面板資料,這裡只是把控制項排出來,不是機器的樣子。

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

MIDI 實作表

PMJ MidiKey 每個控制項送出什麼

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

PMJ MidiKey 的 MIDI 實作表
控制項類型訊息頻道編號訊號LED 回饋依據
Row 1 (top) Button 1 row-1-top-button-1 按鈕 音符 · 按住 1 1 · C#-1 midi/midikey/row-1-top-button-1 — 未確認
Row 1 (top) Button 2 row-1-top-button-2 按鈕 音符 · 按住 1 2 · D-1 midi/midikey/row-1-top-button-2 — 未確認
Row 1 (top) Button 3 row-1-top-button-3 按鈕 音符 · 按住 1 3 · D#-1 midi/midikey/row-1-top-button-3 — 未確認
Row 1 (top) Button 4 row-1-top-button-4 按鈕 音符 · 按住 1 4 · E-1 midi/midikey/row-1-top-button-4 — 未確認
Row 1 (top) Button 5 row-1-top-button-5 按鈕 音符 · 按住 1 5 · F-1 midi/midikey/row-1-top-button-5 — 未確認
Row 1 (top) Button 6 row-1-top-button-6 按鈕 音符 · 按住 1 6 · F#-1 midi/midikey/row-1-top-button-6 — 未確認
Row 2 Button 1 row-2-button-1 按鈕 音符 · 按住 1 7 · G-1 midi/midikey/row-2-button-1 — 未確認
Row 2 Button 2 row-2-button-2 按鈕 音符 · 按住 1 8 · G#-1 midi/midikey/row-2-button-2 — 未確認
Row 2 Button 3 row-2-button-3 按鈕 音符 · 按住 1 9 · A-1 midi/midikey/row-2-button-3 — 未確認
Row 2 Button 4 row-2-button-4 按鈕 音符 · 按住 1 10 · A#-1 midi/midikey/row-2-button-4 — 未確認
Row 2 Button 5 row-2-button-5 按鈕 音符 · 按住 1 11 · B-1 midi/midikey/row-2-button-5 — 未確認
Row 2 Button 6 row-2-button-6 按鈕 音符 · 按住 1 12 · C0 midi/midikey/row-2-button-6 — 未確認
Row 3 Button 1 row-3-button-1 按鈕 音符 · 按住 1 13 · C#0 midi/midikey/row-3-button-1 — 未確認
Row 3 Button 2 row-3-button-2 按鈕 音符 · 按住 1 14 · D0 midi/midikey/row-3-button-2 — 未確認
Row 3 Button 3 row-3-button-3 按鈕 音符 · 按住 1 15 · D#0 midi/midikey/row-3-button-3 — 未確認
Row 3 Button 4 row-3-button-4 按鈕 音符 · 按住 1 16 · E0 midi/midikey/row-3-button-4 — 未確認
Row 3 Button 5 row-3-button-5 按鈕 音符 · 按住 1 17 · F0 midi/midikey/row-3-button-5 — 未確認
Row 3 Button 6 row-3-button-6 按鈕 音符 · 按住 1 18 · F#0 midi/midikey/row-3-button-6 — 未確認
Row 4 Button 1 row-4-button-1 按鈕 音符 · 按住 1 19 · G0 midi/midikey/row-4-button-1 — 未確認
Row 4 Button 2 row-4-button-2 按鈕 音符 · 按住 1 20 · G#0 midi/midikey/row-4-button-2 — 未確認
Row 4 Button 3 row-4-button-3 按鈕 音符 · 按住 1 21 · A0 midi/midikey/row-4-button-3 — 未確認
Row 4 Button 4 row-4-button-4 按鈕 音符 · 按住 1 22 · A#0 midi/midikey/row-4-button-4 — 未確認
Row 4 Button 5 row-4-button-5 按鈕 音符 · 按住 1 23 · B0 midi/midikey/row-4-button-5 — 未確認
Row 4 Button 6 row-4-button-6 按鈕 音符 · 按住 1 24 · C1 midi/midikey/row-4-button-6 — 未確認
Row 5 Button 1 row-5-button-1 按鈕 音符 · 按住 1 25 · C#1 midi/midikey/row-5-button-1 — 未確認
Row 5 Button 2 row-5-button-2 按鈕 音符 · 按住 1 26 · D1 midi/midikey/row-5-button-2 — 未確認
Row 5 Button 3 row-5-button-3 按鈕 音符 · 按住 1 27 · D#1 midi/midikey/row-5-button-3 — 未確認
Row 5 Button 4 row-5-button-4 按鈕 音符 · 按住 1 28 · E1 midi/midikey/row-5-button-4 — 未確認
Row 5 Button 5 row-5-button-5 按鈕 音符 · 按住 1 29 · F1 midi/midikey/row-5-button-5 — 未確認
Row 6 Button 1 row-6-button-1 按鈕 音符 · 按住 1 30 · F#1 midi/midikey/row-6-button-1 — 未確認
Row 6 Button 2 row-6-button-2 按鈕 音符 · 按住 1 31 · G1 midi/midikey/row-6-button-2 — 未確認
Row 6 Button 3 row-6-button-3 按鈕 音符 · 按住 1 32 · G#1 midi/midikey/row-6-button-3 — 未確認
Row 6 Button 4 row-6-button-4 按鈕 音符 · 按住 1 33 · A1 midi/midikey/row-6-button-4 — 未確認
Row 6 Button 5 row-6-button-5 按鈕 音符 · 按住 1 34 · A#1 midi/midikey/row-6-button-5 — 未確認
Row 7 Button 1 row-7-button-1 按鈕 音符 · 按住 1 35 · B1 midi/midikey/row-7-button-1 — 未確認
Row 7 Button 2 row-7-button-2 按鈕 音符 · 按住 1 36 · C2 midi/midikey/row-7-button-2 — 未確認
Row 7 Button 3 row-7-button-3 按鈕 音符 · 按住 1 37 · C#2 midi/midikey/row-7-button-3 — 未確認
Row 7 Button 4 row-7-button-4 按鈕 音符 · 按住 1 38 · D2 midi/midikey/row-7-button-4 — 未確認
Row 7 Button 5 row-7-button-5 按鈕 音符 · 按住 1 39 · D#2 midi/midikey/row-7-button-5 — 未確認
Row 8 Button 1 row-8-button-1 按鈕 音符 · 按住 1 40 · E2 midi/midikey/row-8-button-1 — 未確認
Row 8 Button 2 row-8-button-2 按鈕 音符 · 按住 1 41 · F2 midi/midikey/row-8-button-2 — 未確認
Row 8 Button 3 row-8-button-3 按鈕 音符 · 按住 1 42 · F#2 midi/midikey/row-8-button-3 — 未確認
Row 8 Button 4 row-8-button-4 按鈕 音符 · 按住 1 43 · G2 midi/midikey/row-8-button-4 — 未確認
Row 8 Button 5 row-8-button-5 按鈕 音符 · 按住 1 44 · G#2 midi/midikey/row-8-button-5 — 未確認
Row 9 (bottom) Button 1 row-9-bottom-button-1 按鈕 音符 · 按住 1 45 · A2 midi/midikey/row-9-bottom-button-1 — 未確認
Row 9 (bottom) Button 2 row-9-bottom-button-2 按鈕 音符 · 按住 1 46 · A#2 midi/midikey/row-9-bottom-button-2 — 未確認
Row 9 (bottom) Button 3 Please/Enter row-9-bottom-button-3-please-enter 按鈕 音符 · 按住 1 47 · B2 midi/midikey/row-9-bottom-button-3-please-enter — 未確認
Row 9 (bottom) Button 4 row-9-bottom-button-4 按鈕 音符 · 按住 1 48 · C3 midi/midikey/row-9-bottom-button-4 — 未確認

手上有這台機器?幾分鐘就能核對這份資料。 用你的機器驗證 PMJ MidiKey →

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

出處

這個設定檔從哪裡來

Imported from QLC+ on 2026-11-04. resources/inputprofiles/PMJ-MidiKey.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. There is no port name to go by, so it is never picked automatically: assign it by hand. QLC+ numbers these controls without a MIDI channel, so channel 1 here is a placeholder: the unit may send on another.

認得的埠名稱

訊號

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

用起來

把 PMJ MidiKey 用在你的作品裡

  1. 一行嵌入

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

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

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

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

javascript
document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=pmj-midikey' }));
p5.js 草稿
function draw() {
  background(20);
}

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

p5.js 完整說明 →

其他軟體

在這個專案以外使用這台控制器

同一份資料,換成別的程式讀得懂的檔案。除非上面的表格有寫,這些檔案都還沒在這台機器上實測過。

QLC+

輸入設定檔:每個控制項和 LED 值,給燈光控制用。複製到使用者資料夾(macOS ~/Library/Application Support/QLC+/InputProfiles,Linux ~/.qlcplus/inputprofiles,Windows %USERPROFILE%\QLC+\InputProfiles),重新開啟 QLC+。

Mixxx

這是起點,不是完成的 mapping:唱盤、EQ、hot cue 依序分給各個控制項。把兩個檔案放進 Preferences → Controllers → Open User Mapping Folder 開啟的資料夾,再用 Learning Wizard 改成你要的。

資料本身

上面的東西都來自這個檔案:面板、訊息、LED、SysEx,以及誰驗了什麼。tools/export-controller.mjs 可以從任何設定檔產生這些檔案。

找不到

沒有你那台?

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

GitHub

這台的資料有錯嗎?

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