# 疑難排解

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

## 素材

### 上傳卡在「處理中」

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

### 素材顯示「轉檔失敗」

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

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

:::warning[這不是故障，是產品的設計]

HUAN **不永久保存**你上傳的原始檔。

:::

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

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

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

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

想降低發生機率的話，請架設者把保留期調長。詳見[素材生命週期](/huan/dev/asset-lifecycle)。

### 刪不掉素材

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

## 版面

### 網頁區塊一片空白

很多網站會明確禁止被嵌入（`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/guide/install-raspberry-pi)裡的效能建議。

## 帳號

### 忘記密碼

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

### 驗證碼一直說錯

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

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

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

### 登入之後馬上被登出

通常是伺服器的 Cookie 設定問題，請聯絡架設 HUAN 的人，並提供[部署疑難排解](/huan/dev/troubleshooting#登入之後馬上被登出)這一段。