疑難排解

用瀏覽器的搜尋功能或說明文件的搜尋，在這一頁找到你螢幕上顯示的那句話。訊息裡出現來源名稱的地方，本頁寫成來源。

來源在首頁、瀏覽或影片頁面載入失敗時，楊桃播放器會顯示一個標題和下方一行說明，接著是重試。如果楊桃播放器自己就能解決問題，前面會多一個按鈕：登入、編輯來源、安裝外掛、開啟倉庫或去驗證。在新增來源表單裡，測試連線會把這兩句話顯示在同一行。

來源載入不出來

「裝置已離線」

這台裝置沒有網路時，首頁會在你的來源旁邊顯示這句話。這時首頁、瀏覽、搜尋和影片頁面會顯示來源上次給它們的內容，首頁還會說明是什麼時候儲存的：「裝置已離線 · 3天前儲存」。瀏覽、搜尋和影片頁面會在內容上方顯示同樣的一行。沒存下來的圖片不會出現，來自伺服器的影片要等裝置重新連上網路後才能播放，除非你下載過它。把裝置重新連上 Wi-Fi 或有線網路：每個頁面都會自動重新向來源要求，這行字也會消失。

這台裝置沒有網路、因此連不到來源，又沒有存過它的內容時，首頁、瀏覽、搜尋或影片頁面也會用它當標題，下方一行是「請將這台裝置連上網路後重試。」問題不在來源：把裝置重新連上網路，再按重試。

「無法連線到此來源。這裡是你已下載的部分。」

影片頁面在來源連不上（裝置沒有網路，或來源沒有回應），而你下載過這部影片的內容時，會顯示這句話。頁面只顯示已下載的部分，沒有網路也能播放。網路恢復後頁面會重新向來源要求，來源回應後顯示完整的影片。如果裝置在線、來源卻一直沒有回應，請見下面的「無法連線至來源」。

「無法連線至來源 · ……儲存」

這台裝置已連上網路，但來源沒有回應，所以頁面會顯示來源上次給的內容，以及儲存的時間。每次頁面載入都會重新向來源要求，來源一回應這行字就會消失。如果一直這樣，請看下一節。

「無法連線至來源」

下方一行是「請檢查這台裝置的網路連線後重試。」

來源完全沒有回應。確認這台裝置有連上網路、伺服器正在運作，然後按重試。如果兩者都沒問題，請到設定、來源檢查來源的位址：伺服器位址改了，或是位址只在家裡才能用，也會出現這則訊息。Jellyfin 或 Emby 的位址沒寫連接埠也沒寫 https:// 時，會先照你輸入的試，再試 8096 連接埠，所以用其他連接埠的伺服器要在位址裡寫上連接埠。如果兩者都沒問題卻一直發生，可能是來源的外掛有問題：到設定、進階、外掛看看有沒有新版本，或告訴外掛的作者。

「來源載入失敗」

來源有回應，但回傳了錯誤。標題下方那一行是來源自己的說明，會告訴你原因；來源自己的訊息列出了這些說明。

「來源不支援搜尋」

下方一行是「可以改為瀏覽它，或新增一個支援搜尋的來源。」

搜尋問到的來源本身沒有搜尋功能時會顯示這則訊息。並沒有出錯，所以重試也沒用：瀏覽這個來源，或新增一個能搜尋的來源。搜尋同時問多個來源時，不支援搜尋的來源不會被列為沒有回應的來源。

「來源的外掛卡住了」

下方一行是「楊桃播放器已將它停止，不會一直等下去。請稍後重試，或檢查外掛或應用程式是否有新版本。」

讀取這個來源的外掛一直沒有完成，所以楊桃播放器把它停掉了。問題不在你的網路。請稍後重試，從設定、關於更新楊桃播放器，並到設定、進階、外掛看看外掛有沒有新版本。

「來源想存取一個不允許它存取的位址」

下方一行是「楊桃播放器攔下了這個請求，這不是網路問題。如果這個來源的位址是你填的，請確認它是伺服器實際使用的位址；否則請檢查外掛是否有新版本，或告訴外掛的作者。」

讀取這個來源的外掛要求連到它沒有列出的位址，或是你家中網路上一個你從沒輸入過的位址，或是伺服器把它轉到這樣的位址，於是楊桃播放器拒絕送出請求。重試也會得到一樣的結果。如果這個來源的位址是你自己輸入的，伺服器把連線轉到另一個位址（反向代理，或換了連接埠）就會這樣：請改到設定、來源填入那個位址。否則請到設定、進階、外掛看看外掛有沒有新版本，或告訴外掛的作者。

「來源的登入已過期」

下方一行是「請在設定中重新登入。」，或是來源自己的說明。

按登入，或到設定、來源裡該來源的頁面重新登入。

「來源拒絕了存取」

下方一行是「請在設定中編輯該來源，檢查所填的資料。」，或是來源自己的說明。

伺服器不接受來源存的使用者名稱、密碼、金鑰或權杖。到設定、來源，選擇這個來源，再按編輯，把它們改正。Jellyfin 和 Emby 會說明是哪一項（這些說明是英文）：「Check the username and password by editing the source in Settings.」或「Check the API key and user ID by editing the source in Settings.」「Check this account’s permissions on the server.」表示登入沒問題，但這個帳號可能看不到這個媒體庫，請到伺服器上調整。

「來源未接受登入資料」

下方一行是「請檢查上方填寫的資料後重試。」，或是來源自己的說明。

這則訊息出現在新增來源表單裡。改正上方的使用者名稱和密碼，或金鑰，再按一次測試連線。Jellyfin 和 Emby 的下方一行會是「來源拒絕了存取」底下那兩句英文之一，同樣是指上方這些欄位。對 WebDAV 伺服器或 SMB 共用資料夾來說，這也可能表示這個帳號沒有權限開啟那個資料夾或共用資料夾：請在伺服器上給它權限，或改用有權限的帳號。

「來源在這個位址下什麼也沒有」

下方一行是「請檢查上方的伺服器位址後重試。」

這則訊息出現在新增來源表單裡。伺服器有回應，但你輸入的位址下什麼也沒有：SMB 共用資料夾請檢查共用資料夾名稱，WebDAV 伺服器請檢查資料夾路徑。改正伺服器位址，再按一次測試連線。

「請在網站登入來源」

這個來源需要登入，而這台裝置還沒登入，或是你已經登出。按登入。如果下方一行是「外掛可連線的網站變多了，請重新登入」，表示外掛更新後能連到更多網站，為了安全，楊桃播放器捨棄了原本的登入。

「來源需要檢查」

下方一行是以下其中之一：

「它的位址不是有效的網址，請在設定中編輯該來源。」
「這個來源還缺少一些資料，請在設定中編輯它。」
來源自己的說明，指出哪一個欄位填錯了。

按編輯來源，改正那個欄位，再按儲存。如果來源本身就是外掛，就沒有表單也沒有這個按鈕：請看看外掛有沒有新版本，或告訴外掛的作者。

「來源缺少外掛」

下方一行是「這個來源來自外掛，而這台裝置上還沒有安裝。請在設定中安裝後重試。」

按安裝外掛。它會開啟設定、進階、外掛，或這個來源所屬的倉庫，你可以在那裡重新安裝。安裝外掛需要 Pro。

「來源的外掛無法執行」

下方一行是「外掛已經安裝在這台裝置上，但楊桃播放器無法執行它，可能需要更新應用程式。」

從設定、關於更新楊桃播放器。

「來源需要先通過網站的瀏覽器驗證」

下方一行是「網站要求確認是真人在瀏覽，需要在這台裝置的瀏覽器中完成驗證。」

按去驗證。這台裝置會用瀏覽器開啟那個網站；通過它的驗證後，會自動回到楊桃播放器。

「來源需要你同意」

下方一行是「這個來源來自某個倉庫，需要你同意後才能載入。請前往設定 › 進階 › 倉庫，開啟該倉庫，檢視並允許。」

按開啟倉庫，看看這個倉庫要求什麼，信任的話就允許。

「來源已停用」

下方一行是「請在設定中啟用後重試。」

到設定、來源，選擇這個來源，再按啟用。顯示「已停用 · 需要 Pro」的來源，是因為免費版只能有一個你自己的來源而被停用；請參閱 Pro。

「觀看它的來源已不存在」

下方一行是「該來源已被刪除，沒有地方可以開啟它了。你可以將它從觀看紀錄中移除，或到其他來源找找。」

這筆觀看紀錄屬於一個你已經刪除的來源。把它從觀看紀錄中移除，或到其他來源搜尋這部影片。

「找不到內容」

下方一行是「該來源已經沒有這個內容了。」

伺服器已經移除了這部影片。在這個來源或其他來源重新搜尋。

「發生錯誤」

下方一行是「請重試。如果一直發生，問題出在應用程式本身，不是來源。」

按重試。如果一直發生，請寫信給我們：這是楊桃播放器本身的問題。

來源自己的訊息

在「來源載入失敗」、「來源拒絕了存取」或「來源需要檢查」下方，那一行是來源自己寫的。不論楊桃播放器使用哪種語言，這些句子都是英文。

Jellyfin 和 Emby

「The server did not answer.」（Emby）：確認伺服器正在運作，而且 Server URL 填寫正確。
「The server answered with an error.」：伺服器出錯了。請稍後再試，並查看伺服器本身的日誌。
「The server answered with a page that is not the media server: check the server URL.」：這個位址連到的是別的網頁。改正 Server URL，包括連接埠。
「Signing in failed: the server answered with an error.」或「Signing in failed: the server accepted the sign-in but sent back no session.」：伺服器在登入時出錯。請稍後再試，並查看伺服器的日誌。
「This source has no credentials: fill in a username and password, or an API key and user ID.」：編輯來源，把它們填上。
「This source has an API key but no user ID: fill that in, or use a username and password instead.」：編輯來源，補上 User ID，或改用使用者名稱和密碼。

Plex

「Log in to Plex, or type your own server’s address, by editing the source in Settings.」：編輯來源，按 Account 旁的登入，或輸入你伺服器的網址。
「The list of your Plex servers could not be read.」：plex.tv 沒有回應。確認這台裝置有連上網路，再試一次。
「No Plex server is shared with this account. For your own server, add its address and token by editing the source in Settings.」：你登入的帳號底下沒有伺服器。改用擁有或分享該伺服器的帳號登入，或輸入你伺服器的網址和權杖。
「The server did not answer. Check it is running and on this network.」：確認伺服器已開機，而且這台裝置連得到它。
「None of the server’s addresses answered.」：Plex 記錄的這台伺服器，所有位址都沒有回應。確認它正在運作，或輸入一個這台裝置連得到的位址。
「The server refused this login. Try again in a minute.」
「The server refused the token. Check it by editing the source in Settings.」或「The server asks for a Plex token. Add one by editing the source in Settings.」：編輯來源，改正 Plex 權杖。
「The server URL cannot be used. Check it by editing the source in Settings.」或「The server redirected too far. Check the server URL by editing the source in Settings.」：改正網址。
「The server sent this request somewhere it may not go.」：伺服器把請求轉址到這個來源不能連的位址。請檢查伺服器本身的位址設定。
「The server answered with something that is not a Plex library.」：這個位址連到的是別的東西。改正網址。
「The server answered with an error.」：請稍後再試，並查看伺服器的日誌。
「This search cannot be sent. Try different words.」
「The server has no playable file for this title.」

你自己的檔案

資料夾、隨身碟、WebDAV 伺服器或 SMB 共用資料夾出問題時，瀏覽會在原本資料夾的位置顯示下面這些話。設定方式請參閱在 Android TV 上播放 NAS 或隨身碟裡的影片。

「無法讀取這個位置。請檢查儲存裝置是否已插好，或重新加入該資料夾。」：儲存裝置被拔掉了，或 Android 不再讓楊桃播放器讀取這個資料夾。把裝置插回去，或刪除這個來源後重新加入資料夾。
「這個資料夾已不存在。」：資料夾在儲存裝置或伺服器上被移動、改名或刪除了。回到上一層資料夾，或編輯來源的位址。
「伺服器不接受這個使用者名稱或密碼。請在此來源的設定中檢查。」：編輯來源，改正使用者名稱和密碼。
「這個帳號無權開啟這個資料夾。請在此來源的設定中檢查使用者名稱，或在伺服器上檢查這個帳號的權限。」：伺服器認得這個帳號，但不讓它開啟那個共用資料夾或資料夾。請在伺服器上給這個帳號權限（在 Synology 上是控制台 > 共用資料夾，按編輯，再到權限），或編輯來源改用有權限的帳號。有些伺服器會把錯誤的密碼當成訪客帳號，也會出現這句話，所以也請檢查密碼。
「連不上伺服器。請確認它已開機，並且和這台裝置在同一個網路。」：確認伺服器或 NAS 已開機，而且這台裝置在同一個網路上，或透過你的 VPN 連得到它。
「讀取這個位置時發生問題。」：再試一次。如果一直發生，請查看伺服器本身的日誌。

下面這些出現在這是哪部作品？裡，也就是片庫作品頁上標題不對？或查找這部作品開啟的搜尋（怎麼用）。

「找不到。換個寫法試試，或者用另一種語言的標題。」：TheTVDB（或用你自己金鑰時的 TMDB）上依你輸入的片名查不到。改一下寫法、拿掉多餘的字，或輸入英文片名或原名。
「現在無法查找作品，請稍後再試。」：楊桃的服務（或用你自己金鑰時的 TMDB）正忙碌或連不上。確認這台裝置能上網，過一會兒再試；片庫裡已經顯示的內容不受影響。
「現在無法使用這部作品，請稍後再試。」：你選的作品查到了，但取不到它的詳細資料。過一會兒再試；在那之前這部作品仍顯示原來的內容。

下面這些出現在設定 > 後設資料裡，在你輸入自己的 TMDB 金鑰時（怎麼用）。

「TMDB 不接受這個金鑰。請檢查是否完整複製。」：TMDB 說這個金鑰不對。從 TMDB 的 Settings > API 重新完整複製 API Key（或 API Read Access Token），再輸入一次。TMDB 接受之前什麼都不會儲存。
「無法連線 TMDB。請檢查網路後重試。」：TMDB 沒有回應。確認這台裝置能上網、能開啟 themoviedb.org，然後再試。

雲端硬碟分享

有些來源把一部影片的影片檔列成雲端硬碟分享，放在單獨的一條線路上。楊桃播放器用你自己在那個雲端硬碟的帳號播放分享，所以這個雲端硬碟要是你的一個來源。

影片的線路下方顯示「雲端硬碟 上的分享，把你的帳號新增為來源後就能播放。」：你的來源裡還沒有這個雲端硬碟。按登入 雲端硬碟，在雲端硬碟自己的頁面上登入，這個雲端硬碟就會新增到你的來源裡，也可以在那裡瀏覽。
「雲端硬碟 上的分享要用你自己的 雲端硬碟 帳號播放。登入即可把它新增為來源。」：同上，是按下分享時看到的。按登入 雲端硬碟，登入後分享就會開啟。
「你的 雲端硬碟 登入已過期。請重新登入後再播放。」：雲端硬碟不再接受這個雲端硬碟來源登入的帳號。按重新登入。同一個雲端硬碟有兩個來源時，用來源裡排在前面的那個播放分享。
「雲端硬碟 現在是一個來源」：你在舊版本的設定 > 雲端硬碟帳號裡登入過這個雲端硬碟。這個登入現在是來源裡的一個來源，它的分享照常播放；免費版裡已經有另一個來源時，它顯示為「已停用 · 需要 Pro」，提示裡也會這麼說。
「這個 雲端硬碟 分享已不存在。」：分享已被取消。換一條線路，或換一個來源。
「雲端硬碟 拒絕開啟這個分享。」：雲端硬碟拒絕了，有時下方會附上雲端硬碟自己的話。稍後再試，或換一條線路。
「雲端硬碟 無法辨識這個分享連結。」或「楊桃播放器暫不支援開啟這個雲端硬碟的分享。」：來源給的連結楊桃播放器讀不懂，或者是它還不支援的雲端硬碟。換一條線路。
「這個分享裡沒有楊桃播放器可以播放的內容。」：分享裡沒有影片。
「無法連線至雲端硬碟，請檢查網路後重試。」：確認這台裝置已連上網路，再試一次。
「雲端硬碟 上的分享要用你自己的 雲端硬碟 帳號作為來源播放，而免費版只能有一個你自己的來源。取得 Pro 即可使用任意多個，現有的都會保留。」：免費版裡雲端硬碟和其他來源一樣算一個來源，所以已經有一個來源時，它的分享需要 Pro。顯示「已停用 · 需要 Pro」的雲端硬碟來源也會這樣提示。開通 Pro 或 7 天試用後，會接著登入並播放這個分享。

新增來源

這些訊息出現在新增來源表單的測試連線或儲存下方。

「連線成功」：來源可以用了。按儲存。
「請先填寫所有欄位」或「請先填寫欄位」：來源需要的某個欄位還是空的。
「請輸入完整位址，例如 https://example.com:8096」或「*欄位* 請輸入完整位址，例如 https://example.com:8096」：這個欄位填的不是位址，例如中間有空格。請照 192.168.1.20 或 https://example.com:8096 這樣輸入。
「此版本不包含該來源使用的外掛（外掛）」：這台裝置上沒有這個來源的外掛。請安裝外掛，或刪除來源後重新新增。

在 Android 手機或平板上登入 Dropbox 這類雲端硬碟時，可能會看到「登入沒有完成」和「登入雲端硬碟時楊桃播放器被關閉了，這次登入已遺失。請在來源的表單裡重新登入雲端硬碟。」：雲端硬碟頁面開著的時候，Android 為了釋放記憶體關閉了楊桃播放器，什麼都沒有儲存。重新打開來源的表單，沒選雲端硬碟的話先選好，再按登入。

用手機設定

在電視上按了用手機設定之後，這些訊息會顯示在原本 QR 碼的位置。

「暫時無法從 account.yonto.app 取得代碼」：電視沒辦法向 Yonto 的服務取得代碼。確認電視有連上網路，再按重試。
「暫時連不上 account.yonto.app」：電視在等待時和服務斷線了。按重試。
「手機傳來的內容無法使用」：傳回來的內容和這台電視送出的表單對不上，或無法用它的代碼解開。按重試，再從新的代碼重新送出表單。
「這組代碼已過期」：這個畫面開著超過半小時了。按取得新代碼。

用手機讓電視登入 Dropbox 這類雲端硬碟時，電視也會顯示代碼，標題是「在手機上登入 雲端硬碟」。

「等待太久，登入已停止，沒有保留任何內容」：電視等了大約十分鐘，手機上的登入還沒完成。按重試，掃描新的代碼。

在你的手機上，頁面可能會顯示：

「這組代碼已經失效」：代碼過期了，或電視已經收到回覆。電視會自動換一組新的代碼，掃描那一組即可。
「這個連結不完整」或「這個連結無法使用」：相機只開啟了部分位址，或開到了別組代碼的位址。請重新掃描電視上的代碼。
「這個瀏覽器無法開啟表單」：用手機內建的瀏覽器開啟連結，或更新瀏覽器。
「這份表單已經送出過了」，並顯示「你的電視已經收到回覆。如果不是你送出的，請在電視上取消。」：一組代碼只接受一次回覆，而它已經收到了。如果不是你送出的，請看看電視：如果表單裡填了你沒送出的內容，按返回鍵離開、不要儲存，就什麼都不會留下。

播放

影片無法播放時，播放器會顯示「播放失敗」和下面其中一行，以及重試，除非該行另有說明。載入約 10 秒後會顯示「仍在連線…」；45 秒後就會放棄。行尾括號裡的代碼是給我們排查問題用的，平常不用理它。

「請檢查網路連線後重試。（代碼）」：影片傳輸中斷了。檢查裝置的網路，再按重試。
「影片伺服器沒有回應，請重試，或回到詳細資訊頁換一條線路。」：影片的伺服器接受了連線，卻什麼都沒傳過來。回上一頁換一條線路（如果這部影片有不只一條）。
「播放卡住了，請重試，或回到詳細資訊頁換一條線路。（代碼）」
「此來源無法取得這一集的播放位址，請重試，或回到詳細資訊頁換一條線路。」：來源沒辦法把這一集轉成可以播放的內容。這一行也可能是來源自己的說明。
「此片目前無法播放。（代碼）」：影片的伺服器拒絕了請求，或已經沒有這部影片。換一條線路，或晚點再試。
「此裝置無法播放這支影片。（代碼）」：這台裝置無法解碼這種影片格式。如果影片有其他線路或畫質，換一個試試；這台裝置上沒有任何設定能改變這點。
「無法連線到螢幕。請確認它已開機，並且 AirPlay 允許同一網路下的所有人使用。」：你在播放到裡選了一個 AirPlay 螢幕，它拒絕了。把它設為允許同一網路上的任何人（Mac 預設只允許它自己的使用者），然後再選一次。
「無法連線到螢幕。請確認它已開機，並且和手機在同一個 Wi-Fi 下。」：你在播放到裡選了一台 DLNA 電視，它沒有回應。打開電視，確認它和手機在同一個 Wi-Fi 下，並且開啟了它的 DLNA 或媒體分享設定，然後再選一次。
「接收裝置無法播放這種影片格式。（代碼）」：你正在投放，接收裝置無法解碼這部影片的格式（AirPlay 支援 H.264 和 H.265，Chromecast 支援 H.264，DLNA 電視支援它自己說明的格式）。手機或平板會轉換接收裝置解碼不了的影片，例如 AVI 裡的 MJPEG 或 Xvid，所以只有在它的影片編碼器支援不了畫面的尺寸，或轉換沒能開始時才會看到這則提示，請改在本機播放。
「這支影片以明文 HTTP 傳輸，此裝置不允許播放。（代碼）」：這台裝置拒絕未加密的影片。換一條線路。
「楊桃播放器沒有讀取這個檔案的權限。請從檔案管理 App 重新開啟，或把它所在的資料夾新增為來源。（代碼）」：檔案在這台裝置上，但 App 沒有取得它的存取權限，例如另一個 App 只用路徑交過來的檔案。從檔案管理 App 開啟它（會一併交出存取權限），或把它所在的資料夾新增為來源。
「楊桃播放器沒有讀取影片的權限。請在電視設定的應用程式中允許它，然後重試。（代碼）」：Android TV 上的同一個問題，電視讀取本機資料夾靠的是讀取影片的權限。在電視設定的應用程式、楊桃播放器、權限裡重新開啟它。
「這支影片所在的伺服器需要來源提供的存取資訊，但來源只允許楊桃播放器把這些資訊傳送給它指定的網站，而這台伺服器不在其中。（代碼）」：來源的外掛不讓它的登入資訊傳給那台伺服器。換一條線路，並告訴外掛的作者。
「此應用程式暫時無法播放這個選項。」：這一則會顯示在影片名稱下方，按鈕是詳細資訊。按下它，再選另一個選項。
「此來源沒有回傳可播放的位址。」：這是來源的問題。換一條線路，或換一個來源。
「楊桃播放器無法開啟這個位址。影片連結以 http:// 或 https:// 開頭。」：你貼上的不是指向影片的網頁連結。請複製完整位址（包括 https://）後再試。
「來源已停用，請在設定中啟用後重試。」
「觀看它的來源已被刪除。」
「你已離線。請連線後再播放，或先下載影片以便沒有網路時觀看。」：這部影片沒有下載，而且裝置沒有網路。把裝置連上網路後再播放，或出門前先下載。

下載

這些訊息出現在影片頁面、下載（從首頁的已下載那一列進入，或在設定的下載裡點已下載的內容），以及通知裡。下載後離線觀看說明下載是怎麼回事。

下載失敗時，下載裡它的標題下面會顯示失敗原因的那句話，旁邊有重試。在影片頁面上，它的按鈕會變紅，點一下就會重試。重試會從下載中斷的地方繼續。

「裝置空間不足：下載需要大小，剩餘大小。」：裝置上放不下這個檔案再加 64 MB。騰出一些空間，或是移除一個已經看過的下載，然後點重試。
「伺服器拒絕了下載（錯誤數字）。」：數字是你的伺服器回傳的錯誤代碼。檢查這個帳號能不能讀取這個檔案、檔案還在不在伺服器上，然後點重試。
「下載完成前連線中斷了。」：楊桃播放器已經試了三次。檢查伺服器是否開著、裝置是否在線，然後點重試。
「來源沒有提供這個檔案。」：來源沒有把檔案交出來，例如它的登入已經失效。在設定的來源裡編輯這個來源，需要的話重新登入，然後點重試。來源自己給了說明的話，會顯示它的原話。
「無法將檔案儲存到此裝置。」：Android 不允許楊桃播放器寫入這個檔案。騰出一些空間，然後點重試。
「無法開始下載」：影片頁面上的一個對話框，下面寫著原因。來源沒有交出可以儲存的檔案，所以什麼也沒有開始。照原因說的處理，再試一次；下面三個原因是限制，再試也不會改變。
「這部影片是分段播放的，暫時無法下載。」：出現在「無法開始下載」下面，也可能是下載裡一個失敗的下載的原因。來源把這部影片切成一小段一小段來播放，而楊桃播放器儲存不了：DASH 影片不行；HLS 影片如果分段受保護（SAMPLE-AES 或 DRM）、是一個大檔案的片段（位元組範圍）或帶有單獨的音軌，也不行。其他 HLS 影片在 Android 手機或平板、iPhone 或 iPad 上可以下載。重試沒有用：請連上網路觀看，或移除這個失敗的下載。
「直播無法下載。」：出現在「無法開始下載」下面。直播沒有結尾，無從儲存；請連上網路觀看。
「暫時無法下載分享中的檔案。」：出現在「無法開始下載」下面。這部影片在雲端硬碟的分享中，可以播放，但不能下載。請連上網路觀看。
「下載需要楊桃 Pro。」：這台裝置沒有 Pro，例如試用在下載完成前就結束了。已下載的內容仍可播放。取得 Pro 或開始試用（免費試用 Pro 7 天），然後點重試。
「等待 Wi-Fi」：僅透過 Wi-Fi 下載開著，而裝置沒有連上不計流量的 Wi-Fi。Wi-Fi 回來後下載就會開始。想用行動數據，就在設定的下載裡關掉它。
「等待下載」和「排隊中」：同時只進行兩個下載，這個在等輪到它。
「已暫停 · 大小」：你暫停了它。點一下它就會繼續。
「有些下載無法移除。請再試一次。」：移除所有下載移掉了能移的，還留下一些。再選一次。
「可離線觀看」和「下載失敗」是 Android、iPhone 和 iPad 上的通知。在 iPhone 和 iPad 上只有這兩則：要暫停或取消下載，請到下載裡操作。
「正在下載…」是 Android 的通知。它帶有按鈕，可以暫停或取消下載最久的那一個。暫停的下載會保留自己的一則通知，寫著「已暫停」，帶有繼續下載和取消，直到你繼續或取消它。

外掛和倉庫

這些訊息出現在設定、進階、外掛、從網址安裝，以及設定、進階、倉庫、新增倉庫。

「這不是有效的網址」：貼上完整的位址，以 https:// 開頭。
「無法下載」：這個位址沒有回應。檢查位址，並確認這台裝置有連上網路。
「尚未讀取」，在倉庫裡一個倉庫下面：這台裝置還沒讀取這個倉庫的清單，例如透過同步從另一台裝置來的倉庫。稍後會自動讀取，在它的頁面上點重新整理可以馬上讀取。如果後面跟著這裡的某句話，例如「尚未讀取。無法下載」，就是讀取因為這個原因失敗了。
「該檔案過大，不像是外掛」、「該檔案不是外掛套件」：這個位址不是外掛。請跟給你位址的人確認一下。
「此版本無法執行該外掛」：楊桃播放器讀不了這個外掛檔案。
「該外掛需要更新版本的楊桃播放器，此版本最高支援外掛協定 n」：從設定、關於更新楊桃播放器，再重新安裝。
「無法將它讀取為倉庫」：這個位址不是倉庫。
「該倉庫指向你本機網路中的位址，未下載」：倉庫列出的外掛（或它的轉址）指向你家中網路上的另一個位址，而不是倉庫本身的位址。對倉庫來說，楊桃播放器只會連到你親手輸入的那個家中網路位址。請倉庫的維護者把外掛放在倉庫旁邊，或放到網際網路上。
「連結中的 sha256 無效，未下載」、「檔案與連結中的 sha256 不符，未安裝」、「該檔案不是倉庫列出的外掛，未安裝」、「檔案與倉庫列表中的 sha256 不符，未安裝」：檔案不是連結或倉庫說的那一個，所以楊桃播放器沒有收下它。請聯絡發布的人。
「操作未成功」：楊桃播放器沒辦法儲存外掛。請再試一次。

Pro

這些訊息出現在你啟用 Pro、開始 Pro 試用、在 iPhone 或 iPad 上透過 App Store 購買或回復 Pro，或為它新增電子郵件時；每個步驟請參閱 Pro。

「這組金鑰無效，請對照電子郵件檢查。」：從電子郵件重新複製金鑰。如果你產生過新的金鑰，舊的就不能用了。
「這份授權已用滿裝置數量。請在帳號頁面移除一台後再試一次。」：請參閱裝置。
「這份授權已退款或遭撤銷。」：這組金鑰已經無法開啟 Pro。
「這份授權目前沒有有效內容，所以 Pro 不會開啟。」：這份授權現在什麼都沒有，例如期限已經到了。請到你的帳號頁面查看，或使用有 Pro 的授權金鑰。用同一組金鑰在為電視啟用的網頁上，會顯示「That licence has nothing current on it.」（這份授權目前沒有有效內容。）
「這台裝置已從授權中移除，所以這裡的 Pro 已關閉。」：它是在帳號頁面被移除的。如果授權還有空位，用你第一次的方式在這台裝置上重新啟用 Pro。
「無法連線到 Yonto 授權服務，請稍後再試。」：啟用 Pro 需要網路。確認這台裝置有連上網路。
「沒有成功，請再試一次。」
「你的購買正在等待核准，核准後 Pro 會自動開啟。」：App Store 正在等人核准這筆購買，例如家長。你不用再做什麼：Pro 會自己開啟。
「這個 Apple 帳號沒有購買過 Pro。」：回復購買項目沒有找到任何購買。確認這台裝置登入的是你購買時用的 Apple 帳號。如果你是在我們的網站購買 Pro，請改為輸入電子郵件裡的金鑰。
「無法連線到 App Store，請稍後再試。」：確認這台裝置有連上網路並已登入 App Store，再試一次。
「Yonto 授權服務無法核實這筆購買。請試試回復購買項目，或寫信到 support@yonto.app。」：按回復購買項目。如果還是出現同樣的訊息，請寫信給我們，附上 Apple 收據上的訂單編號。
「App Store 購買的 Pro 已用滿裝置數量。在已開啟 Pro 的裝置上新增電子郵件，然後在帳號頁面移除一台，或寫信到 support@yonto.app。」：在已開啟 Pro 的 iPhone 或 iPad 上新增你的電子郵件，再到帳號頁面移除一台裝置；或寫信給我們，由我們幫你轉移。請參閱裝置。
「請查看 you@example.com 的郵件，點選裡面的連結完成。」（顯示的是你的地址）：開啟那封電子郵件裡的連結，完成新增。可能要等一分鐘，如果還沒收到，請看看垃圾郵件匣。請參閱新增你的電子郵件。
「這份授權已經有電子郵件了。」：用它原本的電子郵件登入你的帳號。如果你已經無法使用那個電子郵件信箱，請寫信到 support@yonto.app。
「這看起來不像電子郵件地址。」：檢查地址有沒有打錯，再按一次傳送連結。
「這台裝置已經試用過 Pro。」：每台裝置只能試用一次，這台已經用過了。想繼續使用 Pro，請按取得 Pro；請參閱免費試用 Pro 7 天。
「目前沒有 Pro 試用。」：授權服務目前沒有提供試用。請稍後再試，或按取得 Pro。

同步

這些訊息顯示在設定、同步裡；其中關於連不上伺服器、伺服器版本或沒有成功的訊息，在打開外掛的同步這個外掛或倉庫的同步這個倉庫卻暫時無法同步時，也會顯示在那個開關下面。每一步的說明見同步。同步的裝置會自己重試，所以大多數訊息會自行消失。

「無法連線到同步伺服器。這台裝置稍後會再試。」：這台裝置沒有連上網路，或者伺服器停了。檢查這台裝置是否連上網路；用你自己的伺服器時，檢查它是否在執行、這台裝置能否連上。
「同步伺服器要求這台裝置稍候，稍後會再試。」：伺服器忙碌，或者這台裝置要求得太頻繁。不用做什麼：它會自己再同步。
「這台裝置暫時無法讀取同步金鑰，稍後會再試。」：裝置的安全儲存空間沒有回應。一直出現的話，重新啟動裝置。
「同步時本裝置發生問題，稍後會自動重試。」：一直出現的話，重新啟動楊桃播放器；還是出現，就寫信給我們（見下文）。
「這台裝置使用「僅限此網路」同步，但這個版本的楊桃播放器不提供這個選項。請選擇「在此裝置上關閉同步」，然後選擇一個伺服器並「開啟」或「加入」。」：這個版本不提供不經伺服器的同步。在這台裝置上關閉同步，然後在楊桃的伺服器或你自己的伺服器上開啟或加入。
「同步伺服器拒絕了這台裝置。」：伺服器不接受這台裝置，例如授權已經沒有 Pro，或者你自己的伺服器不允許這個授權建立帳號。檢查設定、Yonto Pro，用自己的伺服器時也檢查它的帳號清單。
「你的帳號已改用新金鑰重新開始，而這台裝置沒有收到。請從一台正在同步的裝置重新加入。」：另一台裝置選擇了改用新金鑰重新開始，但清單裡沒有這台。選擇加入，在一台正在同步的裝置上允許它。
「另一台裝置已將這台裝置移出同步。這台裝置上的內容會保留。若要再次同步，請以新裝置的身分加入。」：選擇加入，在一台正在同步的裝置上允許它。
「同步伺服器的清單裡已沒有這台裝置，因此它已停止同步。這台裝置上的內容會保留。若要再次同步，請以新裝置的身分加入。」：伺服器把這台裝置從清單中移除了，原因是另一台裝置選擇了從頭開始，或者這台裝置加入後一天內都沒有同步。選擇加入（用自己的伺服器時是開啟），在一台正在同步的裝置上允許它。
「此裝置已關閉同步，但沒能通知你的其他裝置，它們仍會列出它。在其中一台上移除它就能把它從清單中去掉，但那也會用新金鑰重新開始，並讓此裝置登出 Yonto Pro。」：你在連不上楊桃的伺服器時選了在此裝置上關閉同步。你的其他裝置可以一直列著它，因為它已經不再和它們同步。想把它去掉，就在其中一台裝置的裝置裡選它，再選移除並重新開始；這也會讓此裝置登出 Yonto Pro，之後請重新啟用。
「此裝置已關閉同步，但沒能通知你的其他裝置，它們仍會列出它。在其中一台上移除它就能把它從清單中去掉，但那也會用新金鑰重新開始。」：在你自己的伺服器上也是這樣，只是移除它不會登出任何裝置。
「這台裝置的時鐘似乎不對：它顯示時間，而同步伺服器顯示時間。在你校正日期和時間之前，同步伺服器不接收你在這裡做的變更；時鐘校正後它們會再同步。」：時鐘走快了，所以伺服器拒收這台裝置的變更。在裝置自己的設定裡把日期和時間設為自動；在這期間做的變更會在下一次同步時同步。
「這台裝置的時鐘似乎不對：它顯示時間，而同步伺服器顯示時間。請校正日期和時間，否則你在這裡做的變更可能會被較舊的變更覆蓋。」：時鐘走慢了，所以在這裡做的變更可能輸給另一台時鐘正確的裝置上較早的變更。在裝置自己的設定裡把日期和時間設為自動。
「你的帳號已達到同步伺服器允許的上限，這裡的部分變更無法同步。」：在任何一台同步的裝置上清理不需要的觀看紀錄，或從待看清單移除一些。用自己的伺服器時，調高它的上限（README 裡有列表）。

加入

「未加入」：「請求已結束：被拒絕了，或等待時間過長。沒有分享任何內容。」：一個請求有效十分鐘。在一台已在同步的裝置上開啟楊桃播放器，再選擇加入。
「沒有分享任何內容。請再試一次，如果數字仍然不一致，請換一個網路。」：兩台裝置顯示的數字不一樣，所以都沒有分享任何東西。再試一次；還是不一樣，表示網路上有東西擋在中間，換一個網路加入，例如手機熱點。
「新裝置沒有回應，可能已經關閉。請選「不允許」，再從新裝置重新請求。」：你選了在這裡回應，但新裝置一直沒有顯示數字，通常是請求進行到一半時新裝置上的楊桃播放器被關掉了。選不允許，再在新裝置上重新選加入。這樣留下的請求，下次新裝置開啟楊桃播放器時也會自動撤回。
「那台裝置已經拿到了金鑰，所以「不允許」來得太晚，攔不住它了。要收回金鑰，請移除它並用新金鑰重新開始。」：你在新裝置已經拿到金鑰之後才選了不允許，通常是在允許完成後，從另一個畫面選的。在你移除它之前它會一直同步：直接選那裡的移除並重新開始，會開啟設定、同步並詢問是否移除它。
「無法確定是哪台裝置。請在「裝置」裡選它，移除並重新開始。」：在請求上選了移除並重新開始之後，楊桃播放器沒辦法確定清單裡哪台裝置才是你允許的那台，例如它已經被移除了，或它的記錄一直沒到。它不會靠猜去移除：請自己在裝置裡選那台裝置，再選移除並重新開始。
已在同步的裝置上什麼都沒出現：它只有在開著楊桃播放器時才看得到請求，也沒有通知。在那台裝置上開啟它，等幾秒。

你自己的伺服器

「同步無法使用這個位址：需要 https，或指向你自己網路中伺服器的 http。」：http 位址只適用於你自己網路裡的伺服器，例如 http://192.168.1.20:8080。網際網路上的伺服器要加上 HTTPS。
「無法連線到那個伺服器。請檢查位址後再試一次。」：檢查位址，包括連接埠，以及伺服器是否在執行。
「這台同步伺服器需要更新，才能配合這個版本的楊桃播放器。請更新伺服器後再試一次。」：伺服器比 App 舊，兩者已經無法互相理解。把伺服器更新到最新版本，它保存的內容不會遺失。在那之前，這台裝置不會在那裡加入或同步。
「這台同步伺服器比這台裝置上的楊桃播放器新。請更新 App 以繼續同步。」：更新這台裝置上的楊桃播放器。伺服器和所有 App 一起更新，就不會有哪個落後。
「沒有成功，請再試一次。」

復原金鑰

「這不是復原金鑰。請檢查是否有錯字：四個一組的字母和數字。」：檢查你輸入的內容。大小寫、空格和連字號都沒關係，I、L 和 O 會被當作 1、1 和 0。
「這組復原金鑰已過期：儲存之後，你的帳號已改用新金鑰重新開始。」：儲存它之後，有裝置選擇了改用新金鑰重新開始。用較新的那組，或者從一台正在同步的裝置加入。
「這組復原金鑰不屬於你的帳號。」：它屬於另一個授權，或者屬於之後又從頭開始過的帳號。檢查你用的是不是同步時的那個授權。
「你的帳號在那個伺服器上沒有同步任何內容。」：檢查同步位置：復原金鑰只能配合你的裝置同步時用的那個伺服器。
「你之前儲存的復原金鑰已失效，請儲存新的。」：在改用新金鑰重新開始之後顯示。選擇儲存復原金鑰，用新的取代舊的。

從頭開始

每一步的說明見從頭開始。

「一台仍持有金鑰的裝置進行了同步，所以從頭開始已被取消。請改從那台裝置加入。」：還有一台持有金鑰的裝置在同步。在那台裝置上開啟楊桃播放器，然後在這裡選擇加入。
「不認識那台裝置？先為你的授權加入電子郵件，再從頭開始：這樣它會等待寄到該信箱的連結，任何裝置都無法取消。」：選擇加入你的電子郵件，確認收到的連結，再選擇從頭開始，並確認它寄出的郵件。用你自己的伺服器時，改為執行它的 delete-account 指令。
「郵件裡的連結一小時內沒有確認，所以沒有任何重設。再按一次從頭開始以取得新連結。」：再選擇一次從頭開始，並在一小時內確認新的連結。
「在這台裝置之後，另一台裝置也要求了從頭開始，所以這次要求已作廢。」：只有最新的要求會等待。在最後提出要求的那台裝置上繼續，或者在這裡再選擇一次從頭開始。
「裝置在日期要求在沒有金鑰的情況下讓 Sync 從頭開始。已向你授權的電子郵件寄出確認連結。如果不是你，請不要確認。」：如果不是你，忽略那封郵件；連結一小時後失效。有人在一台裝置上使用你的授權，所以移除你不認得的裝置，在帳號頁面上也移除。
「裝置在日期要求在沒有金鑰的情況下讓 Sync 從頭開始。這台裝置仍在同步，所以要求已取消。如果是你在新裝置上操作，請改從這裡讓它加入。」：在新裝置上選擇加入，然後在這裡允許它。

移除裝置

「無法讓那台裝置登出 Yonto Pro，所以它沒有被移除。請再試一次。」：這台裝置連不上楊桃的授權服務，或者服務拒絕了要求。檢查這台裝置是否連上網路，然後再試一次。

更新

這些訊息出現在設定、關於。

「無法檢查更新，請確認這台裝置已連上網路。」或「無法檢查更新，請稍後再試。」
「下載失敗，請重試。」
「楊桃播放器需要安裝更新的權限。」：按開啟權限設定，允許後按返回鍵，更新就會繼續。
「無法開啟安裝程式。」：再試一次。如果一直失敗，請從下載頁面安裝新版本；你的來源和觀看紀錄都會保留。

鎖定畫面

「PIN 碼不正確」表示輸入的四位數字不是這台裝置的主 PIN 碼。請參閱主 PIN 碼，裡面也說明了忘記時該怎麼辦。

「嘗試次數過多，請在 0:30 後再試」表示連續輸錯了五次 PIN 碼或解鎖碼：請等顯示的時間過去，之後每再錯一次，等待時間就加倍。

「解鎖碼不正確」表示解鎖碼輸入錯誤、已經用過，或太舊了：請在帳號頁面顯示目前的解鎖碼，再輸入那一組。

「這台裝置沒有解鎖碼，只有清除楊桃播放器的資料才能重新進入。」，或在 iPhone 上的「這台裝置沒有解鎖碼，只有刪除楊桃播放器再重新安裝才能重新進入。」，表示這台裝置沒有 Pro；主 PIN 碼說明了如何清除資料。

還是沒解決

請寫信到 support@yonto.app，並附上：

楊桃播放器的版本，可以在設定、關於看到。
裝置：電視、手機、平板還是 iPhone，以及型號。
來源的類型：Jellyfin、Plex、Emby、自訂 HTTP、外掛或倉庫。
螢幕上顯示的原文，包括括號裡的代碼。拍一張螢幕的照片也可以。

說明與支援寫了大概多久會回覆，以及如何在 GitHub 回報錯誤。

疑難排解

來源載入不出來

「裝置已離線」

「無法連線到此來源。這裡是你已下載的部分。」

「無法連線至 來源 · ……儲存」

「無法連線至 來源」

「來源 載入失敗」

「來源 不支援搜尋」

「來源 的外掛卡住了」

「來源 想存取一個不允許它存取的位址」

「來源 的登入已過期」

「來源 拒絕了存取」

「來源 未接受登入資料」

「來源 在這個位址下什麼也沒有」

「請在 網站 登入 來源」

「來源 需要檢查」

「來源 缺少外掛」

「來源 的外掛無法執行」

「來源 需要先通過 網站 的瀏覽器驗證」

「來源 需要你同意」

「來源 已停用」