「記錄」對音訊波形產生而言代表什麼
記錄產生音訊波形所採取的步驟，是指將某個程序寫下來，讓另一個人（或未來的你）能依此從同一個輸入檔案產生相同的 SVG 影像。這份紀錄必須涵蓋的內容，遠多於你在單次操作中按下的按鈕：它必須記錄你所選擇的檔案、設定的控制項、決定檔案是否被接受的限制，以及工具所產生的 SVG 文字。僅有控制項的螢幕截圖，會遺漏使程序可重現的關鍵資料。
這件事之所以重要，是因為波形產生很少是一次性的動作。你可能會想在同一個內容系列中重複相同的視覺風貌、將程序交給團隊成員、為新進編輯培訓團隊的視覺風格，或在數週後客戶詢問圖片來源時進行稽核。如果文件只寫著「我點了一些滑桿並儲存了一張圖片」，上述任何重複使用的情境都無法成立。一份有用的紀錄必須是具體的：檔名、格式、尺寸、顏色、所回報的畫格與欄數，以及完整的 SVG 文字。
音訊波形產生器正是為這類紀錄而設計的。它會直接拒絕不支援或超出限制的檔案、明確列出所強制執行的限制，並公開顯示它所產生的完整 SVG 字串。當你以這套工具為基準撰寫文件時，你所寫下的步驟會與工具本身的回報內容對齊，這也是讓紀錄保持誠實最簡單的方式。
為什麼在撰寫步驟時，確定性至關重要
一個程序只有在以相同輸入執行兩次會產生相同結果時，才值得被記錄下來。如果工具在兩次執行間悄悄地變更了輸出，那麼在有人第一次重新執行時，文件就會變得不可靠。確定性是將工作流程轉化為食譜的關鍵特性。
音訊波形產生器在相關意義上具有確定性。SVG 座標是依據經過驗證的數字計算出來，而非檔名。垂直中心是所要求高度的一半，正負滿刻度樣本會延伸至該中心上下各 45% 的高度，欄位則均勻地置中於所要求的寬度。當檔案、寬度、高度、背景顏色與波形顏色皆相同時，兩次執行會產生相同的 SVG 字串。
這項特性會改變文件的閱讀方式。你可以寫下「若要輸出 960 × 240，請將寬度設為 960、高度設為 240、背景設為 #ffffff、波形設為 #111111，接著產生，檢查器將會顯示 960 行」。讀者可以針對每個數字與檢查器進行比對，而無須相信撰寫者的記憶。文件變得可以被檢查。
在紀錄中記下輸入、控制項與限制
波形產生工作流程的每份文件都應列出相同的五類事實，因為每一類都決定了重新執行是否能成功。
| 類別 | 應記錄的內容 | 為何重要 |
|---|---|---|
| 來源檔案 | 檔名、音訊容器、解碼後的時長、聲道數、取樣率 | 同一個檔案若使用不同格式，解碼結果可能會不同 |
| 尺寸 | SVG 的寬度與高度（單位為像素） | 寬度必須介於 320–1,600 之間；高度必須介於 120–600 之間 |
| 顏色 | 六位數的背景與波形十六進制色碼 | 顏色僅來自十六進制控制項，而非檔名 |
| 輸出佐證 | 所回報的畫格數、所回報的欄數、完整的 SVG 文字 | 證明的是實際位元組，而非預期位元組 |
| 已檢查的限制 | 壓縮大小 ≤ 50 MiB、時長 ≤ 5 分鐘、聲道數 1–8、取樣率 8,000–192,000 Hz、聲道樣本數 ≤ 30,000,000 | 超出限制的檔案會被整個拒絕，而非僅截斷處理 |
記錄下這五類資訊，能讓紀錄在移交、稽核與重新執行時皆能發揮作用。省略任何一類，文件就會變成一個故事。
撰寫可重現的工作流程
這是要寫入紀錄的程序。每一步都會留下可供貼入操作手冊、Wiki 頁面或教學文件的痕跡。
- 挑選一個瀏覽器可解碼的音訊檔案，並將其檔名寫入紀錄。此工具會透過目前分頁的 Web Audio 讀取檔案，所以文件必須記錄是哪個檔案產生了哪張圖片。MP3、WAV、M4A、AAC、Ogg、WebM 或 FLAC 等容器標籤描述的是檔案本身，但解碼仍取決於瀏覽器與作業系統實際支援的內容。請在紀錄中註明這項事實。
- 確認檔案符合解碼後的限制，並將驗證過的數字寫下來。壓縮後的檔案大小不得超過 50 MiB。解碼後的音訊時長不得超過五分鐘、須包含 1 至 8 個聲道、取樣率介於 8,000 至 192,000 Hz，且聲道樣本數不得超過 3,000 萬。一旦超過任何一項限制，整個檔案將會被拒絕；波形並不會以靜默方式僅由檔案開頭部分產生。
- 設定 SVG 的寬度與高度，並將兩個數值都記錄下來。寬度接受 320 至 1,600 像素；高度接受 120 至 600 像素。這些數字決定了 SVG 的 viewBox，因此必須逐字寫入紀錄。
- 透過六位數十六進制控制項選擇背景顏色與波形顏色，並將兩個色碼都記錄下來。顏色是從十六進制輸入欄位讀取的，而非從檔名或內嵌的來源中繼資料取得。將色碼寫下，是日後重新產生完全相同圖片的唯一方法。
- 產生本機峰值包絡，並記下所回報的畫格數與欄數。欄數會是所要求的影像寬度、1,000 與解碼後畫格數三者中的最小值。這段說明應寫入文件，因為它能解釋為何使用相同設定時，短剪輯的波形看起來會比長剪輯更為粗塊。
- 開啟檢查器，複製 SVG 文字，並貼入紀錄。頁面會在可展開的檢查器中顯示所產生的完整 SVG 字串，而下載的內容也是使用同一個字串。將該字串與控制項一同儲存，可讓紀錄具備自我驗證的能力。
- 下載 SVG，並確認檔名與內容與紀錄中所記載的數值一致。輸出為純文字的 SVG，而非 PNG、JPEG、影片或音訊。內容包含一個背景矩形以及一組具有固定像素尺寸與相符 viewBox 的峰值線。
- 註明紀錄失效的時間點。選取替換檔案、更改選項、再次產生或離開頁面，都會撤銷已失效的物件 URL，避免舊圖片看起來仍對應著新輸入。文件應記錄是哪個檔案產生了哪個 SVG，以及該配對在何時變為無效。
記錄你實際取得的輸出
工作流程文件中最容易被忽略的部分，就是輸出本身。僅儲存 SVG 檔案並不等同於記錄其內部內容。一份完整的紀錄應儲存檢查器中的文字、所回報的畫格與欄數，以及產生該結果所使用的尺寸與顏色控制項。有了這四項產物，圖片才能被重現；若缺少其中任何一項，它就只是一個有名字的檔案。
SVG 檔案本身因採用相符的 viewBox 與固定像素尺寸，因此具有可縮放的特性。當以其他顯示尺寸呈現時，它依然保持清晰。無論以縮圖或簡報尺寸顯示，文件都能誠實地記載相同的 SVG 都能清晰呈現，因為輸出在任何情況下都是同一段字串。對於極大的印刷尺寸或編輯工作流程，仍可能需要不同的筆觸粗細或更詳細的來源資料；該限制也應誠實地寫入紀錄。若在執行後需要進行更深入的檢視，請依照「在產生音訊波形後檢查結果」中的步驟操作。
應在文件中註明的誠實限制
一份良好的紀錄應坦承工具無法做到的事。音訊波形產生器會繪製每個時槽（bucket）的時域最小值與最大值樣本峰值。它不會計算頻率內容、節拍、音符、響度、語音、暫態或音樂結構。垂直線條代表的是樣本振幅範圍，而非頻率，因此該圖並非頻譜圖。
兩段錄音可能會顯示相似的峰值，但聽起來卻差異極大，因為感知響度取決於時長、頻率平衡、動態範圍與播放條件。該圖並非經過校準的響度計，亦不應用於診斷聽力、設備、削波歷史、相位或母帶處理合規性。將這些限制寫入紀錄，能避免下一位讀者對圖片作出過度詮釋。
就多聲道音訊而言，該圖是一個合併後的峰值概覽：某個時槽的最小值可能來自一個聲道，最大值則可能來自另一個聲道；結果並不會分別顯示左右聲道、保留各聲道的身分，或將聲道平均為一個新的音訊訊號。原始音訊永遠不會被改寫。若需要各聲道分開的波形，則此項需求必須寫入文件，讓未來的使用者選用其他工具，例如能將每個聲道顯示為獨立音軌的音訊編輯器。將這些注意事項寫入紀錄後，文件才會與工具本身相符，而這正是所撰寫步驟值得保存的原因。
若你正在權衡各項方案，「修正音訊波形輸出中看起來錯誤的結果」對此有詳細說明。