跳到內容
Yonto Player楊桃播放器說明文件

來源

來源就是你的電影和影集從哪裡來，楊桃播放器可以同時放進很多種：Jellyfin、Plex 和 Emby 伺服器，透過 SMB 或 WebDAV 連接的 NAS，隨身碟或資料夾，以及你自己的 Dropbox 或 Box。一次搜尋就會同時查詢所有來源，「繼續播放」、「紀錄」和待看清單也會收進每個來源的片子；第一個來源免費，更多來源需要 Pro。

在設定、來源、新增來源裡新增，並選擇它的類型：在 Android TV 上是表單最上方的欄位，在手機或平板上是新增來源開啟的種類清單。每個表單都有測試連線和儲存。名稱留空的話，來源會以它的位址命名，例如 nas.local；沒有位址的就以類型命名。同一個位址的第二個來源會加上編號，例如 nas.local (2)。

楊桃播放器不附帶任何片單，你新增的內容由你自行負責。請只使用你有權觀看的來源。

用手機設定

「用手機設定」一節

在電視上，表單最上方有用手機設定，讓你用手機打字，不必用遙控器慢慢輸入。

  1. 選用手機設定。電視會顯示一個 QR 碼，旁邊附上它的網址。
  2. 用手機相機掃描 QR 碼，或在手機瀏覽器裡開啟這個網址，就會打開一個同樣的表單。
  3. 填好後按傳送到電視。
  4. 電視上的表單會自動填好，並顯示「已用手機填好。檢查一下，然後儲存。」。在你用遙控器按儲存之前，什麼都不會儲存。

修改已有的來源時，手機上的表單是空白的：只要填你想改的欄位，留空的會維持原本儲存的內容。每個 QR 碼十分鐘內有效，只接受一次回覆；快到期時電視會自動換一個新的。你輸入的內容會經過我們的轉送服務從手機傳到電視（手機開啟的頁面在 tv.yonto.app 上），全程加密，轉送服務本身也無法讀取；電視收到或 QR 碼失效後就會刪除，只有伺服器磁碟快照裡的加密副本最多保留七天（見隱私權政策）。這個功能免費，而且只有電視上才有。

Jellyfin

「Jellyfin」一節

適用於你自己管理的 Jellyfin 媒體伺服器。需要填寫名稱、Server URL、Username 和 Password。另有兩個選填欄位：API key，以及只在搭配 API key 時才會用到的 User ID。讓伺服器轉換影片預設是開啟的：這台裝置無法直接播放某個檔案時（例如 1080p 機上盒上的 4K，或不支援 HDR 的螢幕上的 HDR），由伺服器邊播邊轉換。關掉它就一律播放原始檔案。一步步的說明見在 Android TV 上播放你的 Jellyfin 媒體庫。

Plex

「Plex」一節

適用於 Plex Media Server。

  1. 按帳號旁邊的登入。
  2. 楊桃播放器會顯示一組短代碼。在手機或電腦上前往 plex.tv/link 並輸入這組代碼。電視上還會顯示 QR 碼，可以直接用手機掃描。
  3. 楊桃播放器會顯示代碼還剩多少時間。過期後，楊桃播放器會換上新的代碼，或顯示取得新代碼按鈕。

不想登入的話，也可以直接輸入你自己伺服器的網址。網址留空就改用登入。只有伺服器要求時，才需要填寫 Plex 權杖。讓伺服器轉換影片和 Jellyfin 的表單一樣是開啟的；只有伺服器擁有者有 Plex Pass 時，Plex 才會為不支援 HDR 的螢幕替 HDR 做色調映射。一步步的說明見在電視上設定 Plex，不用輸入密碼。

Emby

「Emby」一節

適用於 Emby 伺服器。它的表單和 Jellyfin 的一樣，也有讓伺服器轉換影片；只有伺服器有 Emby Premiere 時，Emby 才會為不支援 HDR 的螢幕替 HDR 做色調映射。一步步的說明見在 Android TV 上新增你的 Emby 伺服器。

自訂 HTTP

「自訂 HTTP」一節

適用於採用楊桃播放器自家 HTTP 規範的服務。需要填寫名稱、基底網址，以及服務需要時才填的存取權杖。

本機資料夾

「本機資料夾」一節

適用於手機裡或隨身碟裡的影片檔案。選擇本機資料夾，按選擇資料夾，在系統的選擇器裡選好資料夾並允許楊桃播放器讀取，然後儲存。選取這個來源時，首頁、瀏覽和搜尋會顯示依檔名分成電影和影集的影片，瀏覽裡的資料夾則照原樣顯示：按資料夾就能開啟，按返回回到上一層，按影片就開始播放。看過的內容會和其他來源一樣出現在觀看紀錄裡。海報和簡介來自檔案本身；除非你在來源的表單裡關閉在線上查找海報和簡介，缺的部分還會上網查。電視沒有資料夾選擇器，所以在電視上改成選擇一個儲存空間（電視盒內建的，或隨身碟），並允許楊桃播放器讀取裡面的影片。這需要 Android 10 以上版本，隨身碟要等電視盒掃描完才會出現。目前只有 Android 版有這個功能。在電視上要怎麼一步步設定，請見在 Android TV 上播放 NAS 或隨身碟裡的影片。

「檔案」中的資料夾

「「檔案」中的資料夾」一節

適用於 iPhone 或 iPad 上的影片檔案：在裝置上的、iCloud 雲碟中的，或在「檔案」App 裡連接的 NAS 上的。選擇**「檔案」中的資料夾**，在「檔案」App 的選擇器裡選好資料夾，然後儲存。要連到 NAS，先開啟「檔案」App，輕點 ⋯，選「連接伺服器」並登入這個共用資料夾；它的資料夾隨後就會出現在選擇器裡。瀏覽和播放的方式與本機資料夾一樣。Mac 上沒有「檔案」App：請選本機資料夾，它會開啟 Mac 內建的資料夾選擇器。

WebDAV

「WebDAV」一節

適用於 NAS 裡的影片檔案，以及 Alist、OpenList，它們都提供 WebDAV。選擇 WebDAV，輸入伺服器位址（要開啟的資料夾，例如 http://nas.local:5005/dav），如果伺服器要求，再填使用者名稱和密碼，然後儲存。測試連線會讀取這個資料夾。瀏覽和播放的方式和本機資料夾一樣。http:// 位址沒有加密，密碼會在你的網路裡以明文傳輸；楊桃播放器會在位址下方提醒你。登入資料只會傳給這台伺服器。在電視上要怎麼一步步設定，請見在 Android TV 上播放 NAS 或隨身碟裡的影片。

SMB

「SMB」一節

適用於 NAS 或電腦透過 SMB 分享的影片檔案，大多數 NAS 以及 Windows 和 Mac 的共用資料夾都是用這種方式。選擇 SMB，把伺服器位址填成 smb://nas.local/media，也就是伺服器加上共用資料夾名稱；想直接開啟裡面的某個資料夾，可以接著寫下去（smb://nas.local/media/Movies）。再填上使用者名稱和密碼；如果共用資料夾允許訪客存取，留空即可，然後儲存。測試連線會讀取這個資料夾，瀏覽和播放的方式和本機資料夾一樣。只有 Android 版有 SMB 這個獨立的類型：在 iPhone 或 iPad 上，請先在「檔案」App 裡連上這個共用資料夾（輕點 ⋯，然後選「連接伺服器」），再使用**「檔案」中的資料夾**；在 Mac 上請用 WebDAV。在電視上要怎麼一步步設定，請見在 Android TV 上播放 NAS 或隨身碟裡的影片。

雲端硬碟

「雲端硬碟」一節

用於你自己的 Dropbox 或 Box。選擇雲端硬碟的來源並登入：在電視上用手機掃 QR Code 登入，在手機或平板上會開啟系統瀏覽器。瀏覽和播放與本機資料夾相同，一個雲端硬碟算你的一個來源。播放你 Dropbox 或 Box 裡的影片一步一步地講了過程。

哪些影片檔案能播放

「哪些影片檔案能播放」一節

資料夾、WebDAV 和 SMB 來源會列出副檔名為 mp4、mkv、avi、mov、wmv、flv、ts、m2ts、mpg、mpeg、webm、m4v、rmvb、3gp 或 iso 的檔案。能不能播放要看檔案裡面用的是什麼編碼，因為楊桃播放器優先使用你裝置內建的解碼器。最保險的是 H.264 或 H.265 影像，搭配 AAC、MP3、Opus、FLAC 或 AC3 音訊，封裝成 MP4、MKV、WebM 或 TS。在 Android 上，裝置解不了的 AC3、EAC3、DTS 和 TrueHD 音訊，楊桃播放器會自己解碼，所以這類影片播放時也有聲音（見Android TV 上的 DTS、TrueHD 和杜比音訊）。Android TV 上的 MKV 檔案播不了說明怎麼判斷是聲音、畫面還是檔案的問題，以及每一種怎麼處理。楊桃播放器在 Android、iPhone、iPad 和 Mac 上都內建第二個播放器。AVI、WMV 和 RMVB 檔案由它播放，iPhone、iPad 和 Mac 上的 MKV、FLV 及其他較舊的格式，以及裝置內建播放器讀不了、或解不了畫面的其他檔案也一樣。藍光或 DVD 光碟映像檔（iso 檔）在所有裝置上也由它播放：播放光碟的正片，不含光碟選單。仍帶有防拷保護（藍光的 AACS 或 BD+、DVD 的 CSS）的光碟無法播放；把影片的多個版本或多個機位交錯在一起的 DVD 也無法播放。這個播放器同樣可以縮成子母畫面，前提是裝置支援。它播放的檔案也可以投放：手機或平板會在途中重新封裝，接收端播放不了的聲音也會轉換。接收端播放不了的畫面（舊的 AVI 或 WMV，或 Chromecast 上的 H.265），手機或平板會邊播放邊轉換，投放到 Chromecast 和 AirPlay 接收端都一樣，所以投放要晚幾秒鐘才開始；Android 手機或平板的影片編碼器如果支援不了這個畫面的尺寸，就無法投放這樣的檔案。在 iPhone 或 iPad 上，用播放器投放選單裡的 AirPlay 選一個 AirPlay 接收端，這些檔案也會送過去。4K HDR 和杜比視界要看你的裝置是否支援。H.264 或 H.265 的 MP4、MOV 和 M4V 由裝置內建的播放器播放，能投到電視上的也是它。影片內嵌的字幕，以及在 Android 上和影片同名的字幕檔（Movie.mkv 旁邊的 Movie.srt 或 Movie.en.srt），都在播放器的字幕裡選擇；電視內建的儲存空間和隨身碟只會列出影片，所以那裡的字幕檔暫時還不會被讀取。

跳過片頭和片尾

「跳過片頭和片尾」一節

Plex、Jellyfin 或 Emby 伺服器標出了片頭、前情提要或片尾的位置時，或來源沒標出、但 TheIntroDB 知道它們在哪裡時，播放器會在畫面上顯示一個按鈕：跳過片頭、跳過前情提要或跳過片尾。在有下一集的影集片尾，按鈕會顯示下一集並直接播放。在電視上按確定鍵，或在手機上點一下，就會跳過這個片段；按返回鍵則在這一集裡收起按鈕。設定 → 播放器 → 跳過片頭和片尾可以為片頭、前情提要和片尾分別選擇：詢問（預設）、倒數五秒後自動跳過，或不跳過。Jellyfin 從 10.10 版起會標出它們，但要等它掃描過這部作品；Plex 和 Emby 要等各自的片頭片尾偵測執行過。來源沒有標出片頭或片尾時，播放器會依作品在 TheTVDB、TMDB 或 IMDb 的編號向社群資料庫 TheIntroDB 查詢：你自己的檔案裡片庫已經配對的電影或影集，以及伺服器給出了編號的電影或影集。它只送出這個編號、季和集、影片片長，以及應用程式的名稱和版本，直接從你的裝置送出，所以和任何網路請求一樣，TheIntroDB 會看到你的 IP 位址；同一頁的在線上查找片頭片尾時間可以關掉它。跳過資料由 TheIntroDB 提供。完整說明以及它不做什麼，見在 Android TV 和手機上跳過片頭和片尾。

多個來源

「多個來源」一節

點首頁左上角的來源標籤，就能在你的來源之間切換。在設定、來源裡，你可以停用某個來源而不刪除它，也可以刪除不再需要的來源。來源標籤會依照來源頁面上的順序列出你的來源，你可以在那裡把來源移到清單中的任何位置。來源頁面會寫明每個來源的出處：從倉庫新增的顯示倉庫名稱，外掛自帶的顯示來自外掛。在手機或平板上，拖曳來源右側的握把，或長按來源後拖曳即可。在電視上，在來源上長按確定鍵，用方向鍵上下移動，再按確定鍵放下；也可以開啟來源，選擇「上移」或「下移」。刪除你自己新增的來源後，想再加回來就得重新輸入它的資料。從倉庫新增的來源會回到該倉庫的未新增裡，從那裡就能重新加回來，什麼都不用再填。儲存了多個來源時，繼續播放和紀錄裡的海報會標出所屬來源的名稱，方便你看出它是從哪裡開啟的。

一次新增多個

「一次新增多個」一節

倉庫是一個能提供多個來源的網址。詳見外掛和倉庫。

播放連結

「播放連結」一節

來源（手機或平板上首頁頂部的頭像）的末尾是播放連結。貼上一部影片的位址，也就是以 http:// 或 https:// 開頭的連結，然後選擇播放。它會立即播放，背後沒有來源：不會加入觀看紀錄或待看清單，播放到的位置會依這條連結記住。HLS 串流的連結會當作串流播放，其餘則當作影片檔播放。這個對話框裡還有選擇檔案，也可以從外部把影片交給楊桃播放器。在 Android 手機或平板上，系統的開啟方式會替影片檔或影片連結列出它，不論來自檔案管理員、瀏覽器還是通訊軟體；在 iPhone 或 iPad 上，它出現在「檔案」App 和分享選單裡；在 Mac 上，它出現在 Finder 的打開方式裡，用於影片檔。這樣開啟的影片同樣播放：不會加入觀看紀錄或待看清單。