在產生音訊波形時重複得到相同的結果，代表從同一個輸入檔案和同一組設定執行時，每次都能取得位元組完全相同的 SVG 輸出。在三個具體特性都共同運作時，可重現性才會成立：在一個完整解碼的影格範圍上採用決定性的整數分桶邊界、透過一個穩定的 45 百分比垂直映射，從你選擇的寬度和高度推導出固定的像素座標，以及經過驗證的六位數十六進位色彩字串，而且絕不會從檔名或內嵌的中繼資料讀取。當這三者同時存在時，在同一部機器上執行兩次的結果會產生相同的 SVG，而預覽面板、檢查器文字、以及下載的檔案會共用同一個完全相同的字串。如果缺少其中任何一個特性，即使輸入檔案沒有改變，結果也會在每次執行之間漂移。會在伺服器端重新取樣的雲端渲染器、從標題或演出者標籤讀取色彩提示的工具，或是會在分桶之間悄悄丟掉影格的方法，看起來可能一模一樣，但無法通過 XML 或雜湊比對檢查。音訊波形產生器會將每一個步驟都保留在目前的瀏覽器分頁內，並把每個輸出的維度固定為你親自輸入的數字。
為何波形影像在每次執行之間常常會位移
大多數線上的波形工具都自稱能產生「波形」，但你在星期一下載的檔案和星期五下載的檔案，即使什麼都沒有改變，也幾乎不會完全相同。以下是幾個會造成這種漂移的常見原因：
- 伺服器端重新取樣。在後端解碼的雲端工具，可能會為了效能而重新取樣、回傳快取結果，或在兩次造訪之間悄悄升級其處理流程。即使輸入檔案完全沒有變動，輸出的位元組流仍然會改變。
- 由中繼資料驅動的色彩。某些產生器會讀取音訊檔案的標題、演出者或註解標籤，並把那些位元組重新當作色彩提示。重命名檔案或移除標籤，圖片就會改變，即使音訊本身並沒有變。
- 靜默地丟掉影格。當音訊片段太長時，天真的工具可能只繪製前 N 秒，卻不告知你。因此當程式碼路徑改變或執行環境的時間預算不同時，同樣的輸入就會產生不同的影像。
- 浮點數的直欄分桶。使用分數索引來分桶影格的工具，會因為執行環境如何進位而產生稍微不同的分桶結果，這會以直欄在每次執行之間位移一個像素的方式顯現出來。
- 內嵌的來源資料。如果 SVG 在標記內容中包含了檔案路徑字串、軟體版本戳記、建置時間戳記、或隨機識別符，這個檔案就無法以相同的身分被重複匯出。
若要重複得到相同的結果，凡是會影響影像的每一個輸入，都必須是你親自輸入的數字或色彩字串；每一個分桶邊界都必須從整數公式推導出來；而且整段音訊片段都必須被處理，而不是被截斷。
如何使用音訊波形產生器重複得到相同的波形結果
- 挑選一個支援的音訊檔案。選擇一個你目前的瀏覽器確實能透過 Web Audio 解碼的 MP3、WAV、M4A、AAC、Ogg、WebM 或 FLAC。壓縮檔的大小必須在 50 MiB 以下，解碼後的片段長度不得超過五分鐘，且必須包含一到八個聲道，落在 8,000 到 192,000 Hz 的取樣率範圍內，展開後的聲道樣本總數必須保持在 3,000 萬以下。如果編解碼路徑失敗，工具會回報錯誤，而不會產出殘缺的影像。
- 設定 SVG 的尺寸與色彩。從 320 到 1,600 像素之間選擇一個寬度，從 120 到 600 像素之間選擇一個高度，並從瀏覽器的六位數十六進位色彩選取器中挑選背景與波形的色彩。你在此輸入的每一個值，都是渲染器對這些屬性所使用的唯一來源。
- 產生本機的峰值包絡。點擊產生動作。頁面會把每一個解碼後的樣本影格，分進 min(width, 1000, frames) 個以整數編號的分桶中。對每一個分桶，程式會找出橫跨所有聲道的有限最小與最大樣本值，把超出範圍的防禦性數值箝制在 -1 到 1 之間，並從該分桶的最大值到最小值畫出一條垂直線。
- 讀取回報的計數器。頁面會顯示解碼後的影格數以及 SVG 將包含的峰值直欄數。兩次完全相同的執行會產生相同的計數器，這是你確認建置可重現的第一個便宜檢查。
- 檢查預覽或 SVG 文字。開啟內嵌預覽，並且如果你想要確認標記內容，可以展開 SVG 檢查器。兩種檢視會渲染出同一個完全相同的字串，而該字串內的座標完全是從你輸入的寬度、高度與色彩選擇推導出來的。
- 下載完全相同的可縮放 SVG。儲存這個檔案。下載下來的 SVG 和檢查到的字串是同一個東西；在輸出的過程中，不會重新編碼、重新取樣、或加上中繼資料戳記。
整個流程都停留在你的分頁內。Web Audio 會在本機讀取檔案，頁面會在本機計算分桶與直欄，而 SVG 也是在本機建構，因此你看到的位元組就是渲染器實際看到的位元組。對應的本機 SVG 轉換逐步說明文件，會從稍微不同的角度描述同一條決定性的處理流程。
決定性的 SVG 實際上包含了什麼
因為目標是重複得到相同的結果，所以了解輸出中有哪些數字是被固定的、以及它們從哪裡來，會對你有所幫助。下方表格把影像中每個可見的屬性，對應到渲染器所套用的規則：
| 屬性 | 固定的值 | 來源 |
|---|---|---|
| viewBox 和 width / height | 就是你輸入的寬度和高度 | 尺寸輸入 |
| 背景 | 一個填上你背景色彩的矩形 | 十六進位色彩輸入 |
| 垂直中心 | 所請求高度的一半 | 高度輸入 |
| 全幅正樣本 | 中心上方 45 個百分比的高度 | 固定映射規則 |
| 全幅負樣本 | 中心下方 45 個百分比的高度 | 固定映射規則 |
| 上下邊界 | 兩側各佔 5 個百分比的高度 | 固定映射規則 |
| 直欄數量 | min(width, 1000, decoded frames) | 輸入與解碼後的長度 |
| 直欄的 x 位置 | 沿著寬度均勻置中 | 寬度與直欄數量 |
| 線段幾何 | 從分桶最大值 y 到分桶最小值 y 的垂直線 | 經過箝制的有限極值 |
| 色彩字串 | 你輸入的六位數十六進位值，而不是內嵌標籤 | 色彩輸入 |
舉一個具體的錨點來看：如果解碼後的影格數是 24,000，而你請求的寬度是 800，則直欄會解析為 min(800, 1000, 24000) = 800，每個分桶涵蓋 24,000 / 800 = 30 個連續的影格，從第零個影格開始，一直涵蓋到最後一個解碼後的影格。這些數值沒有一個會取決於檔名、作業系統時鐘、或伺服器端的隨機種子。在同一個瀏覽器上進行兩次相同的作業階段，產出的 SVG 在文字比對工具中會顯示為沒有差異，這就是「我能重複得到相同結果」的實際驗證方式。
保護可重現性的限制
只有當整個輸入真的被完整處理時，相同的輸入才能對應到相同的輸出。音訊波形產生器基於這個理由強制實施一組固定的限制。每一項限制都是渲染器在畫出任何一條線之前會檢查的界線，超過限制的音訊會被整體拒絕，而不是被靜默地截斷：
| 限制 | 允許範圍 | 為何對可重現性很重要 |
|---|---|---|
| 壓縮檔大小 | 上限 50 MiB | 防止頁面接受瀏覽器無法在合理時間內解碼的檔案 |
| 解碼後的長度 | 上限 5 分鐘 | 讓分桶運算維持在有界定的 SVG 大小與處理預算內 |
| 聲道數量 | 1 到 8 | 定義渲染器在每個分桶中能夠掃描的跨聲道極值 |
| 取樣率 | 8,000 到 192,000 Hz | 排除某些瀏覽器無法解碼的特殊取樣率 |
| 聲道樣本總數 | 上限 3,000 萬 | 防止小型壓縮檔展開成數 GB 的浮點數陣列 |
| SVG 寬度 | 320 到 1,600 像素 | 將直欄數量限制在可處理的範圍內 |
| SVG 高度 | 120 到 600 像素 | 限制垂直映射，讓 45 個百分比的規則保持有意義 |
如果你的檔案未通過任何一項檢查，頁面會拒絕該輸入，而不會產生殘缺的波形。這種拒絕本身就是一種可重現性：你實際收到的任何 SVG，都是從完整解碼後的片段繪製出來的，而不是它開頭的前三十秒。
當重複得到相同的結果，仍然無法告訴你你想知道的內容時
決定性的 SVG 並不等同於校準過的量測，而你所能忠實重複的結果，也有其明確的界線。在詮釋這張影像時，請把以下限制放在心上：
- 這不是響度量表。兩段錄音可能呈現幾乎相同的峰值，但聽起來卻截然不同，因為感知到的響度取決於持續時間、頻率平衡、動態範圍、以及播放條件，而這些都不會被峰值包絡編碼進去。
- 這不是頻譜圖。時間由左至右推進，但垂直軸是樣本振幅，而不是頻率。你無法從這張影像讀出音符、暫態或音樂結構。
- 它不會區分聲道。對於立體聲或多聲道音訊，每個分桶會取所有接受聲道中的最小值與最大值，產生一張合併的峰值總覽，而不是分開的左右音軌。一個分桶的最小值可能來自某個聲道，而最大值來自另一個聲道，因此這個結果在視覺上並不會保留聲道的身分。
- 它不會重寫音訊。原始的位元組永遠不會被修改；只有一個新的 SVG 被產生出來。
- 這不是診斷工具。這張影像無法告訴你關於削波歷史、相位關係、母帶合規性、聽力狀況，或其他設備故障的資訊。
Web Audio 的AudioBuffer 介面是提供解碼後樣本影格給渲染器讀取的底層物件。每次可重現的執行都仰賴那個緩衝區在你的瀏覽器中能被一致地解碼，這就是不支援的編解碼組合會大聲失敗、而不是回傳一個猜測值的原因。
之後重新執行相同的建置
如果您想將結果鎖定以供記錄或提供給同事使用，請記錄檔案校驗碼、寬度、高度、兩個十六進制色彩字串，以及產生的 SVG 本身。使用完全相同的輸入重新開啟 Audio Waveform Generator，就能在同一個瀏覽器上重現相同的 SVG，而且僅限本機處理的模式意味著不會有伺服器快取、建置時間戳記或匿名任務識別碼會在不同次造訪之間變動。所檢查的標記就是下載的標記，這也是「我可以重複得到相同結果」的唯一誠實定義。