峰值欄數應等於要求的寬度、1,000 與解碼影格數三者中的較小值。
產生音訊波形時，在將圖形視為最終版本前，請再次檢查來源限制、解碼影格數、要求尺寸、顏色、回報的欄數、預覽以及下載的 SVG。這些檢查可區分有效算繪與不符合預定用途的輸出。
峰值波形會摘要各時間點解碼後的樣本振幅。它不會測量頻率內容、校準響度、相位、節拍、音符或音樂結構，因此也應依您預期要傳達的資訊類型檢查此視覺呈現。
最重要的檢查項目
在下載或發布波形前，請進行這項簡短的驗證：
- 來源：確認預覽代表您所選的那個音訊檔案，而非先前選取的檔案。
- 適用性：確認壓縮音訊與解碼音訊均符合所有大小、持續時間、聲道、取樣率及聲道樣本限制。
- 數量：比較回報的解碼影格數與峰值欄數，並確認影格數和輸出寬度之間的預期關係。
- 外觀：驗證要求的寬度、高度、背景顏色及波形顏色。
- SVG 內容：檢查產生出的標記，確認其具有預期尺寸、viewBox、顏色、背景矩形及峰值線條。
- 解讀：確認合併峰值包絡符合您的需求，而且您並未預期取得頻譜圖、分離聲道的顯示或響度報告。
確認檔案可在本機解碼
所選檔案必須能由目前的瀏覽器與作業系統解碼。此工具可讀取 MP3、WAV、M4A、AAC、Ogg、WebM 和 FLAC，但受支援的副檔名或 MIME 標籤並不保證瀏覽器支援該檔案實際使用的編解碼器。瀏覽器解碼是依據Web Audio AudioBuffer 模型所呈現的解碼影格與聲道資料。
不支援、損毀、空檔或偽裝的檔案會產生錯誤。當整個檔案超過解碼資料限制時，也會遭到拒絕；此工具不會僅以檔案開頭的內容悄悄建立波形。
| 需驗證的項目 | 可接受的範圍或必要行為 |
|---|---|
| 壓縮檔案 | 最多 50 MiB |
| 解碼後的持續時間 | 不超過五分鐘 |
| 解碼後的聲道 | 一至八個 |
| 解碼後的取樣率 | 8,000 至 192,000 Hz |
| 解碼後的音訊大小 | 不超過 3,000 萬個聲道樣本 |
| SVG 寬度 | 320 至 1,600 像素 |
| SVG 高度 | 120 至 600 像素 |
| 顏色 | 取自瀏覽器顏色控制項的六位數十六進位值 |
| 輸出 | 靜態、基於文字的 SVG |
| 處理位置 | 解碼、擷取峰值、產生、預覽及下載均在目前的瀏覽器分頁中進行 |
在瀏覽器中產生並檢查波形
- 選擇一個音訊檔案。開啟Audio Waveform Generator，選取受支援的檔案，並確認其符合壓縮檔案及解碼音訊限制。請勿僅憑 WAV 或 MP3 副檔名便認定能成功解碼。
- 設定輸出尺寸與顏色。選擇介於 320 至 1,600 像素的 SVG 寬度，以及介於 120 至 600 像素的高度。使用六位數十六進位值選取背景與波形顏色。
- 產生本機峰值包絡。啟動產生程序，並等待回報的影格數、峰值欄數、預覽及 SVG 檢視器出現。在這項工作流程中，來源音訊與產生的圖形都會保留在本機。
- 驗證欄數。峰值欄數應等於要求的圖片寬度、1,000 與解碼影格數三者中的較小值。因此，較短的錄音具有較少的獨立峰值測量值，而上限則可讓較長的錄音維持在可管理的 SVG 大小與處理預算內。
- 檢查預覽與 SVG 文字。查看尺寸、背景、波形顏色、水平間距及整體振幅型態是否正確。開啟可展開的 SVG 檢視器，確認標記所描述的固定畫布與峰值集合和預覽中顯示的內容相同。
- 下載完全相同的 SVG。儲存產生的字串，並確認其在支援 SVG 的編輯器中開啟時具有預期像素尺寸、相符的 viewBox、一個背景矩形及峰值線條群組。下載內容是 SVG 文字，而非 PNG、JPEG、影片或音訊。
- 任何變更後重新產生。如果您替換檔案或變更選項，請再次產生並重新檢查預覽與數量。過期的物件 URL 會被撤銷，避免較舊的圖片看似代表新的輸入。
包絡會將解碼影格分割成連續的整數索引範圍。對每個範圍，產生器會使用所有解碼聲道中的最小與最大有限樣本值，將防禦性超出範圍的值限制在負一至正一的區間內，並在兩個極值之間繪製一條垂直線。第一個範圍從影格零開始，最後一個範圍延伸至最終解碼影格，且相鄰範圍之間不會遺漏任何已接受的影格。
讓回報的數量與幾何資訊符合 SVG
產生的幾何資訊是確定性的，因此若出現不一致，就應檢查輸入或設定，而非視為預期中的變動。請將回報值與下列明確定義的行為進行比較。
| 檢查項目 | 預期結果 | 驗證原因 |
|---|---|---|
| 峰值線條數 | 符合回報的欄數，以及要求的寬度、1,000 與解碼影格數三者中的較小值 | 確認已算繪預期數量的區段 |
| 畫布 | 固定的像素寬度與高度，且具有相符的 viewBox | 讓 SVG 尺寸保持可預測 |
| 水平位置 | 欄位在要求的寬度內平均置中 | 顯示遺漏、重複或位置錯誤的欄位 |
| 垂直中心 | 要求圖片高度的一半 | 為包絡提供一致的基準線 |
| 全刻度範圍 | 正負全刻度樣本向中心上方或下方延伸 45 個百分比，並保留五個百分比的頂部與底部邊界 | 確認已定義的振幅對應關係 |
| 顏色 | 背景與波形顏色完全符合選取的十六進位值 | 避免未察覺的色彩不一致 |
| SVG 結構 | 一個背景矩形及一組峰值線條 | 顯示已產生預期的靜態元素 |
| 預覽與下載 | 兩者使用完全相同的已產生 SVG 字串 | 避免儲存的檔案與檢查的結果不同 |
在整體脈絡中解讀合併聲道輸出
立體聲及多聲道音訊會算繪為單一的合併峰值概覽。每個區段會取所有已接受聲道中的最小值與最大值，因此最小值可能來自某個聲道，而最大值則來自另一個聲道。波形不會以視覺方式保留聲道身分、建立獨立的左右聲道軌，或將聲道平均成新的音訊訊號。
如果專案需要各聲道獨立的波形，請使用可將每個聲道呈現為獨立音軌的音訊編輯器。產生的 SVG 也不會重寫原始音訊；它是解碼素材的獨立視覺化呈現。
區分峰值資訊與不受支援的結論
時間由左至右延伸，每條垂直線代表其所在區段中由最小值至最大值的樣本範圍。因此，結果是時域峰值包絡，而不是頻譜圖。垂直位置不代表頻率，影像也不會顯示節拍、音符、瞬態、語音內容或音樂結構。
峰值波形也不是校準響度計。兩段錄音可能具有相似的可見峰值，聽起來卻不同，因為感知響度取決於持續時間、頻率平衡、動態及播放條件。請勿使用此圖片診斷聽力或設備問題、建立削波歷程、檢查相位，或判斷母帶處理是否符合規範。
完成最終檔案與隱私檢查
在支援 SVG 的編輯器中開啟下載的 SVG，並確認尺寸、viewBox、顏色、背景及峰值數量。向量輸出以其他尺寸顯示時仍保持清晰，但極大的印刷或編輯工作流程可能需要不同的線條寬度，或比這個有界限包絡所提供更詳細的來源資料。
如果您的需求包含讓來源保持私密，處理模型會提供明確答案：音訊檔案會在目前的分頁中解碼，峰值包絡會在該處計算，而 SVG 也會在該處產生並下載。無論所選音訊或產生的圖形，都不會上傳至 Lizely。
如果您正在評估選項，What Should I Know Before I Generate an Audio Waveform? 對此有詳細說明。
如果您正在評估選項，When Should I Generate an Audio Waveform for an SVG? 對此有詳細說明。