更新紀錄
更新紀錄
oav-p5 0.8 · 框架 0.1
內容以 Markdown 寫在 docs/zh/changelog.md，這一頁由它產生。 GitHub ↗
改了什麼，新的在上：每一條寫現在可以做什麼，以及手冊在哪裡講。oav-p5 是給 p5.js 草圖的那一行（p5.js 一行接上），有自己的版本號：載入它的草圖，按 🎹 → 🩺 就看得到。框架與網站依日期列。每一條都連到它的 commit，完整的歷史在 commit 紀錄。
oav-p5#
0.8.4#
2026-10-20 · e9ad495
- 🥁 打開的鼓機先不出聲。 按 🎹 面板的 🥁，或重整後自動回來的鼓機，格子會出現但播放框沒勾，勾了才開始打。草圖自己呼叫
startDrums()的照樣直接播放。startDrums
0.8.3#
2026-10-20 · 8a9be83
- 幾格以前。
lastKickFrameCount、lastSnareFrameCount、lastHatFrameCount、lastBeatFrameCount、lastNoteFrameCount是看到這一下的那一格的frameCount。在kickIsDetected是 true 的那一格，frameCount - lastKickFrameCount是 0，接著是 1、2、3……，可以讓形狀在每一下之後固定留幾格。lastKickFrameCount
0.8.2#
2026-10-20 · b0ebbd7
- 打擊也有像
mouseIsPressed的值。kickIsDetected、snareIsDetected、hatIsDetected在大鼓、小鼓、鈸打到的那一格是 true（鼓機的，或沒有鼓機時麥克風的）。lag()把true當成 1，所以lag(kickIsDetected, 0, 0.3)就是一個閃到 1 再慢慢退的數字，可以拿來控制透明度或大小。kickIsDetected - 上一下是什麼時候。
lastKickTs、lastSnareTs、lastHatTs、lastBeatTs、lastNoteTs用millis()的時鐘，millis() - lastKickTs就是幾毫秒前。第一下之前是-Infinity。lastKickTs
0.8.1#
2026-10-20 · 096914f
- 🎹 面板放你要的地方。 面板上多兩個按鈕：「位置」依序切換下方、上方、浮動（浮動時拖曳上面那一列就能移動），「大小」依序切換小、中、大。這個瀏覽器會記住。沒有設定
dock時，面板改成一開始在下方，OpenProcessing 也一樣，之前放在上方會蓋住草圖。只有面板和 🎹 在同一個邊時，🎹 才會讓開。dock - 重整之後，剛剛開著的會回來。 在 OpenProcessing 按 Cmd+Enter（或同一個頁面重新整理），面板原本開著就自動打開，從面板 🥁 開的鼓機也會用你最後那一行節奏和速度再打起來。草圖自己用程式開的鼓機照草圖的。收起面板、關掉鼓機，重整後也保持關著。
- 鼓機在打的時候，一下大鼓就是一下大鼓。 鼓機播放時，麥克風聽到的大鼓、小鼓、鈸和拍子不再叫草圖的函式。之前它聽到的多半是喇叭放出來的鼓聲，所以大鼓那一下也會叫
snareDetected。micLevel和三個頻段照樣跟著麥克風。kickDetected - OpenProcessing 的 console 不再自己跳出來。 OpenProcessing 只要 console 有一行字就會蓋在草圖上，所以在那裡 oav-p5
不再印它自己想說的話（接線、卡片上已經有的提示、聲音開了）。你的程式出錯、呼叫寫錯、🩺 體檢照樣會印，
debug可以全部找回來。
0.8.0#
2026-10-16 · 9bdde95
- 收音符號碼的地方，音名也能用。
noteIsDown('C4')就是noteIsDown(60)，midi.play('C#4', 0.8)送出音符 61，新的midi.isDown('Eb3')用音名問一個鍵。C4、c#4、Db3、F♯2、C-1（0）到G9（127）都行；C4 是 60 （有些軟體，像 Ableton 和 Yamaha，把 60 叫 C3）。Strudel 的小寫寫法（c4 e4 g4）也行。寫錯的音名會停下來，跳出一張卡片告訴你怎麼寫。數字的行為跟以前完全一樣，notePressed(note, velocity)拿到的仍然是號碼。音名 - 三個換算函式：
noteNumber('C4')得到60，noteName(61)得到'C#4'（{ flats: true }是'Db4'，{ octave: false }是'C#'），noteFreq('A4')得到440赫茲，給自己合成聲音的草圖用。 - 現成草圖：
p5/examples/note-names/（範例 24）。
0.7.0#
2026-10-15 · 89c05ac
- 格子和那一行字是同一個東西。 點鼓機的格子，那一行字跟著改寫（
bd*4、bd(3,8)、[~ sd]*2這種人會寫的樣子）；直接在樂譜行打字，停手就套用，格子跟著變。打錯的字標紅，鼓機繼續打上一個能用的版本。↶ 或 ⌘Z 回上一步，「複製」給你一行startDrums("…", 120)，「在 Strudel 打開」把同一個節奏帶去 strudel.cc。一行節奏 drawRhythm(x, y, w, h, 'circle')：把節奏畫在畫布上，三種樣子（grid、circle、spiral），跟著drumPhase轉，錄影錄得進去。畫在畫布上的節奏- 像 TouchDesigner CHOP 的數值工具：
lag(micLevel, 0.03, 0.4)（Lag CHOP，秒數跟 TouchDesigner 一樣：大約跟上 90% 的時間）、env('kick', 0.01, 0.3)（Trigger）、speed()、spring()、trail()、slope()、count()，draw()裡一行一個，不用宣告；scope(值, '標籤')在角落畫出數值的曲線（不會錄進影片），drawTrail()畫在畫布上。新套件@openav/chop。 - 跟 Strudel 一起用：在 strudel.cc 載入這一行，旋鈕、手機、麥克風就能當 Strudel 的參數；Strudel 的
.midi('OAV Virtual MIDI')送來的音符照時間戳進到notePressed（實測誤差最大 4.5 毫秒），它的節拍時鐘讓鼓機和drumPhase跟著走；link=房間名把音符和時鐘轉到另一個分頁或另一台電腦。新文件〈跟 Strudel 一起用〉。 - 現成草圖：
p5/examples/rhythm-visual/、p5/examples/lag/、p5/examples/with-strudel/。
0.6.0#
2026-10-15 · 5e75007
- 畫面再重，鼓都不歪。 鼓機照音訊時鐘提前排好：
draw()每一格故意忙 30 毫秒，大鼓到大鼓的間隔差異是 0.000 毫秒（0.5.0 是 15 毫秒）。切到別的分頁，鼓照打、小節照算。?oav_drums=frame可以退回 0.5 版的鼓機。鼓機 - 一行字寫節奏：
startDrums("bd*4, [~ sd]*2, hh*8")。寫法來自 TidalCycles 與 Strudel，OAV 依公開文件獨立實作（@openav/pattern）。打錯字，卡片會說是第幾個字、為什麼。一行節奏 - 鼓機卡的軌道名照瀏覽器語言（大鼓、小鼓、鈸、拍手），顯示第幾小節，那一行字裡正在響的字會亮。
drumPhase、beatPhase：這一小節、這一拍走到哪，0 到 1，連續的。rotate(drumPhase * TWO_PI)一小節轉一圈。- 現成草圖：
p5/examples/rhythm/。
0.5.0#
2026-10-15 · 02aa19c
- 錄影，連聲音一起：
startRecording()、stopRecording()、recordingSaved(info)。🎹 面板上的 ⏺ 和 📷 不寫程式也能用。 錄影 - 畫布和這一行發出的所有聲音（
startSound()、鼓機、開著的麥克風、p5.sound 1.x）錄成同一個檔：瀏覽器能錄 MP4 就錄 MP4，不能就錄 WebM。手機上，卡片的分享按鈕可以存進相簿。 - 每錄完一段都會檢查：沒有聲音、錄成 WebM、整段黑、檔案幾乎是空的，卡片會說發生什麼、為什麼。
- 📷 把畫布存成一張 PNG。
- 現成草圖：
p5/examples/record/。
0.4.0#
2026-10-15 · e629115
- 聲音：
startSound('piano')。鍵盤、螢幕上的 🎹、手機彈的每個音都聽得到，面板上的 🔊 可以換樂器。 聲音 - 鼓機：
startDrums()，16 格、四軌、五種節奏。每打一下，叫的就是麥克風的kickDetected()、snareDetected()、hatDetected()，所以寫給麥克風的草圖不用改，就跟著鼓機動。鼓機 - 小節時間軸：
cue(5, 'bloom')→cueFired()、barStarted()、stepStarted()。時間軸 - 出狀況直接寫在畫面上：🎹 旁邊一張卡片，用瀏覽器的語言寫發生什麼、為什麼、下一步按哪裡。 出狀況的時候
- 🩺 體檢：面板上的 🩺（或
OAVp5.check()）把版本、麥克風、MIDI、聲音、鼓機、接線整理成一張卡，截圖就能問人。 micLevel改成照聽起來的大小，房間本身的底噪是 0，micSensitivity()調靈敏度。草圖自己讀的旋鈕，不再同時接到 OPC 的拉桿：一顆旋鈕只做一件事。- 現成草圖：
p5/examples/keys/、p5/examples/drums/。
0.3.0#
2026-10-15 · d874044
- 同一行也聽麥克風：
micLevel、bass／mid／treble、beatDetected()。不用 p5.sound，p5 1.x、2.x 都能用。草圖讀到這些名字之前，不會去要麥克風。麥克風 - Hydra 裡也能用：用
loadScript()載同一個檔，再寫osc(10, 0.1, () => knob1 * 2).out()。在 Hydra 裡用 - 現成草圖：
p5/examples/mic/。
0.2.4#
2026-10-14 · d2572c3 · tag p5-v0.2.4
第一個打上 tag 的版本，包含 0.1 到 0.2.4（從 2026-10-13 開始）。
- 像讀滑鼠一樣讀控制器：
knob1…knob8、fader1…、pad1…、notePressed()。MIDI 控制器、螢幕上的控制器（🎹）和手機，進來都是同一串 MIDI。像讀滑鼠一樣讀它 - OpenProcessing：OP Configurator 的變數照宣告順序接上旋鈕。搭配 OP Configurator
- 手冊有了這一章，中英兩版。在 openprocessing.org 用 p5 2.3.4 實測過。
- 現成草圖：
p5/examples/particles/、p5/examples/opc/。
框架與網站#
2026-10-15#
- MIDI 控制器圖鑑：每一台都有自己的頁，附完整的 MIDI 對照表，中英兩版。新增 Novation Launchkey 25、37 MK4、 Launchpad Pro MK3、DJ TechTools Midi Fighter Twister、AKAI APC40 mkII，以及 teenage engineering OP-1 field （Miffy Chen 貢獻，pull request #2）。怎麼挑控制器、LED 回饋、許願表單。控制器
- 範例：十五個範例分成五條路線，每一頁都有帶路卡。新增 14 時間軸、15 p5.js 一行指令。02 和弦花園改長《The Last Input》的 L-system 樹枝。範例
- 新頁面：/p5/，以及檢查這台裝置能用什麼的 /check/。手冊寫進各瀏覽器能做什麼，裝置沒有 Web MIDI 時首頁會說。
- 映射與時間軸：映射可以匯出、匯入、用
?map=載入。時間軸套件有曲線、循環、會觸發的 cue、錄製。 - 手機：線上範例可以用手機遙控（公開中繼，掃 QR code）。手機直拿時，舞台留在上方。
- 新套件：
@openav/pattern（一行節奏）、@openav/fab（做不做得出來：3D 列印檢查，匯出 STL、OBJ、GLB、STEP）、@openav/out（把頁面參數送到 WLED 燈、序列埠馬達板和 OSC，附看門狗）。套件 - 給 AI 代理和搜尋引擎：中英兩版 llms.txt、一份 sitemap，以及處理控制器設定檔的 MCP 工具：
list_controllers、read_profile、validate_profile、scaffold_profile。 - 新的 README，以及
tools/release.sh：每次更新都照同一個固定順序發佈。 - 網站跟上 oav-p5：這一頁（更新紀錄）、首頁與手冊頁首並列「oav-p5 版本 · 框架版本」、首頁第四扇門「我用 p5.js／OpenProcessing」、/p5/ 列出現成草圖、手冊裡的範例路徑可以點。入口檔（
/p5/oav-p5.js）發佈後約一分鐘就換新版。 - 網站跟上 oav-p5（第二批）：p5 的現成草圖變成範例，每個都有帶路卡和縮圖：16 彈出聲音、17 麥克風、18 鼓機與小節、 19 一行節奏、20 看得見的節奏、21 錄成影片、22 lag、23 跟 Strudel 一起（範例）。首頁多三個常見問題（聲音、鼓和錄影，像 Lag CHOP 那樣讓數值變順，Strudel），/p5/ 連到和 Strudel 一起用，手冊的快速開始、疑難排解、路線圖和 README 都寫上 oav-p5 現在能做的事。