疑難排解

素材

上傳卡在「處理中」

轉檔在伺服器端進行，一般幾十秒內完成。長時間停住通常代表轉檔程序沒有在跑，請聯絡架設 HUAN 的人。

素材顯示「轉檔失敗」

常見原因是檔案損毀，或格式其實不是副檔名寫的那一種。畫面上會有一句說明。重新輸出成 MP4（H.264）再上傳通常就好了。

素材顯示「需要重新上傳」

原始檔在轉檔完成後就會刪除，派送用的播放檔也會在所有裝置都拿到之後回收，因為正式的播放副本已經存在裝置本機了。

當下列情況同時成立，這份素材就沒有可以派送的副本了：

• 原始檔已刪除
• 播放檔已回收
• 而你現在需要重新派送（新增了一台裝置，或某台裝置清掉了本機資料）

解法是重新上傳這個檔案。 後台會直接標示出來，不會等到派送時才失敗。

想降低發生機率的話，請架設者把保留期調長。詳見素材生命週期。

刪不掉素材

素材正在被草稿、已發布的版面、排程或某台裝置使用時，刪除會被擋下來，畫面上會列出是哪些地方在用它。請先把那些地方換掉或移除，再回來刪。

版面

網頁區塊一片空白

很多網站會明確禁止被嵌入（X-Frame-Options 或 frame-ancestors）。這是對方網站的安全設定，HUAN 不會也不應該繞過它。

改用允許嵌入的來源，或把內容做成一個 HTML 檔上傳。

上傳的 HTML 沒有作用

目前只支援單一自帶資源的 HTML 檔案。外部的 <script src>、<link href> 與圖片都不會載入，需要的資源請用 data: URI 內嵌。

螢幕上下（或左右）有黑邊

裝置螢幕的長寬比和你設計的畫布不一樣時，HUAN 會把整份畫布等比縮放並置中，剩下的地方填版面背景色。

這是刻意的——拉伸變形比黑邊難看得多。想填滿的話，把版面的畫布尺寸改成和螢幕一樣的比例。

裝置

配對碼過期

配對碼有效期是 10 分鐘，而且只能用一次。重新啟動播放器就會產生新的一組。

裝置顯示離線，但現場明明在播

這兩件事本來就可以同時成立——HUAN 是離線優先的，斷網時畫面照播。

裝置每分鐘左右回報一次，斷線後會以漸增的間隔重連（最長一分鐘）。網路恢復後最多一兩分鐘才會變回線上。

一直是離線的話，請確認裝置連得到 HUAN 的網址。

裝置卡在舊版本

打開該裝置的詳細頁，看「目標版本 / 實際版本」與每個素材的同步狀態。

常見原因：

• 磁碟空間不足：裝置會回報儲存錯誤，後台會顯示出來。
• 某個素材下載失敗：裝置會留在舊版本繼續播並自動重試，這是正確行為，不是故障。
• 素材需要重新上傳：那份素材已經沒有副本了，裝置永遠拿不到。

按「強制同步」可以讓裝置立刻重新確認一次。

畫面全黑但程式在跑

先確認 HDMI 有沒有被偵測到——有些小電腦在開機時沒接螢幕就會停用輸出。接上螢幕後重新啟動裝置。

影片播放卡頓

到素材的詳細資訊確認它已經轉成 H.264。若裝置是 Raspberry Pi，另見 Raspberry Pi 安裝說明裡的效能建議。

帳號

忘記密碼

HUAN 沒有自助重設流程。請最高權限管理員到「使用者」幫你重設。

驗證碼一直說錯

兩步驟驗證允許前後約 30 秒的時鐘誤差。先檢查手機的時間是不是設成自動同步。

同一組驗證碼不能用第二次，等下一組出現再試。

驗證器不在身邊時，用啟用當下抄下來的復原碼登入，每組只能用一次。

登入之後馬上被登出

通常是伺服器的 Cookie 設定問題，請聯絡架設 HUAN 的人，並提供部署疑難排解這一段。