疑難排解

視覺效果沒有對音訊產生反應#

1. 確認音訊檔案或即時輸入已連接且正在作用中。
2. 若來源為檔案，請按下播放；若為即時輸入，請啟動所選的輸入。
3. 測試內建的頻譜顯示元件，確認 Astrofox 有收到音訊。
4. 開啟反應器，確認其輸出儀表有在跳動。
5. 若訊號太弱，請擴大頻譜選取範圍或降低 Max dB。
6. 確認目標控制項已綁定到預期的反應器，且其數值範圍不是固定值。

若動態有延遲，請降低反應器的平滑度；若太過跳動，請提高平滑度。在頻譜模式中，較高的衰減也會讓數值下降得更慢。

找不到麥克風或 MIDI 裝置#

• 瀏覽器詢問時，請授予麥克風或 MIDI 權限。
• 確認裝置已連接，且其他應用程式也能使用。
• 連接新裝置後，重新整理可用的輸入清單。
• 若其他應用程式獨占了該裝置，請將其關閉。
• 在 macOS 桌面應用程式上，請至「系統設定」檢查 Astrofox 的權限。

桌面音訊是否可用，取決於所選的螢幕分享來源與作業系統。部分瀏覽器可提供分頁音訊，但無法提供整個系統的音訊。

開啟專案時缺少媒體#

本機圖片與影片檔案不一定能自動重新開啟，尤其是專案移到其他電腦之後。請使用 Relink Media，為每個未解析的圖層選擇相符的圖片或影片。

音訊不會儲存在專案檔案中。開啟專案後，請使用 Load audio 重新載入音軌。

封存或轉移作品時，請將媒體與專案檔案放在一起。

外掛程式圖層沒有渲染#

1. 選取動作列中的 Manage plugins，確認所需的外掛程式已安裝。
2. 若是開發中的外掛程式，修改檔案後請重新載入。
3. 確認其 manifest 與參照的檔案可以存取，且伺服器已啟用 CORS。
4. 已發布的外掛程式請使用 HTTPS；HTTP 僅在 localhost 上接受。
5. 在瀏覽器開發人員主控台中檢查著色器編譯或 worker 錯誤。
6. 確認動畫使用 frame.time，而非實際時鐘計時器。

若 worker 渲染預覽影格超過約 3 秒，或在匯出期間超過 5 秒，就會被停止並標記為無回應，讓 Astrofox 的其餘部分可以繼續運作。

無法開始 Save video#

Save video 一律會開啟匯出對話框。在匯出滿足以下條件之前，確認按鈕會保持停用：

• 至少五秒長的音訊檔案
• 開始時間早於結束時間
• 所選範圍至少五秒長
• 當平台可預先選擇儲存位置時，已指定儲存位置

單靠即時輸入無法定義離線匯出的時間軸。請在 Save Video 對話框中選擇音訊檔案。

匯出格式與預期不同#

網頁版匯出會使用目前瀏覽器 MediaRecorder 支援的格式。若需要特定的 MP4 或 WebM 編碼器，請使用內建 ffmpeg 的桌面應用程式。若桌面應用程式找不到 ffmpeg，會改用與瀏覽器相容的方式。

桌面應用程式無法擷取音訊#

麥克風輸入需要麥克風權限。桌面音訊可能還需要螢幕錄製權限，以及確實包含音軌的擷取來源。變更作業系統權限後，請重新啟動 Astrofox。

舊專案遺失了元素#

Astrofox 會自動移轉支援的 1.x 專案元素。不支援或無法轉換的元素會被移除，並在專案開啟時回報。請保留原始 .afx 檔案的備份，並參閱從 1.x 升級了解元素的對應方式。

回報錯誤#

請在 Astrofox issue tracker 中搜尋或建立 issue。請附上 Astrofox 版本、網頁版或桌面平台、作業系統與瀏覽器、重現步驟，以及在可安全分享時提供最精簡的專案。